什么是Personal Finish Notifier
Personal Finish Notifier 是一个专为 Claude Code 及其他代理工作流设计的轻量级通知工具，旨在通过 OpenClaw 传输协议实现任务完成时的智能提醒。该工具的核心理念是将通知视为“人”而非“机器日志”，强调人性化沟通与灵活配置。它通过监听 Claude Code 的钩子事件（如 `Stop` 或 `TaskCompleted`），自动触发一条简洁、友好的消息，告知用户代理已完成当前任务。这种设计避免了传统事件日志的冷冰冰输出，转而采用类似团队成员间自然交接工作的语气，提升开发体验的流畅度。工具默认支持 OpenClaw 协议，尤其适用于 WhatsApp 等即时通讯渠道，未来还可扩展至 Codex、Webhook、APNs 等多种传输方式，具备良好的可拓展性。整个系统不依赖特定 AI 引擎，而是通过标准输入和配置文件实现解耦，确保在不同代理工具间迁移时无需重写核心逻辑。
核心功能特点
- 基于 OpenClaw 协议的通用通知通道，支持 WhatsApp 等多种传输方式
- 自动捕获 Claude Code 的 Stop 和 TaskCompleted 事件并生成人性化提醒
- 使用 stdin 接收钩子 JSON，配置灵活且与具体 AI 引擎解耦
- 内置自检脚本，便于验证通知链路是否正常工作
- 支持安全机制防止误发通知到非预期目标
适用场景
Personal Finish Notifier 特别适合需要长时间运行 AI 代理任务的场景，例如自动化代码生成、文档整理或复杂问题拆解。当 Claude Code 正在处理一个耗时较长的请求时，开发者可能无法实时关注终端输出，此时该工具可在任务结束时立即推送一条简短明确的消息，如“Claude 已完成代码重构，请检查变更”。这不仅节省了等待时间，也避免了因忽略终端信息而错过关键结果的风险。对于远程协作环境尤为有用——团队成员可通过 WhatsApp 或其他即时通讯工具接收通知，实现跨设备无缝衔接。此外，在 CI/CD 流程中集成此类通知，也能帮助运维人员快速获知 AI 辅助构建或测试的结果状态。由于其架构中立且易于扩展，该工具还可用于监控其他基于钩子的代理系统，成为统一事件响应体系的一部分。