Personal Finish Notifier
Use this skill to wire agent completion events into a simple notification channel.
Principles
- - Treat notifications like a person checking back in, not a machine event log.
- Keep the routing layer engine-agnostic.
- Prefer a user-configured target and transport over hardcoded routing.
- Prefer OpenClaw transports over engine-specific delivery logic.
Layout
- -
scripts/notify.sh - core formatter + transport adapter - INLINECODE1 - install/update Claude hook wiring
- INLINECODE2 - send a live self-test through OpenClaw
- INLINECODE3 - rationale and extension points
Default setup
For Claude Code on this machine:
CODEBLOCK0
For a live delivery check:
CODEBLOCK1
Inputs
The notifier reads hook JSON from stdin and settings from ~/.claude/mac-notify.env.
Required routing values:
Optional safety value:
If OPENCLAW_NOTIFY_SELF_TARGET is set, the script refuses to send when the target differs.
Adapters
- - Claude Code:
Stop, INLINECODE10 - OpenClaw transport: WhatsApp now
- Future adapters: Codex completion hooks, native node notify, webhook, APNs
Message style
Human tone rules:
- - short
- specific
- reads like a teammate checking back in
- avoid raw event names like
Stop or INLINECODE12
If you need architecture context or to add a new transport, read references/architecture.md.
技能名称: personal-finish-notifier
详细描述:
个人完成通知器
使用此技能将代理完成事件接入简单的通知通道。
原则
- - 将通知视为人员回访,而非机器事件日志。
- 保持路由层与引擎无关。
- 优先使用用户配置的目标和传输方式,而非硬编码路由。
- 优先使用OpenClaw传输方式,而非引擎特定的投递逻辑。
布局
- - scripts/notify.sh - 核心格式化器 + 传输适配器
- scripts/install-claude-hook.sh - 安装/更新Claude钩子连接
- scripts/test-openclaw.sh - 通过OpenClaw发送实时自检
- references/architecture.md - 设计原理与扩展点
默认设置
针对本机上的Claude Code:
bash
./scripts/install-claude-hook.sh
进行实时投递检查:
bash
./scripts/test-openclaw.sh
输入
通知器从标准输入读取钩子JSON,并从~/.claude/mac-notify.env读取设置。
必需的路由值:
- - OPENCLAWNOTIFYCHANNEL
- OPENCLAWNOTIFYTARGET
可选的安全值:
- - OPENCLAWNOTIFYSELF_TARGET
如果设置了OPENCLAWNOTIFYSELF_TARGET,当目标不匹配时脚本将拒绝发送。
适配器
- - Claude Code:Stop、TaskCompleted
- OpenClaw传输:目前支持WhatsApp
- 未来适配器:Codex完成钩子、原生节点通知、Webhook、APNs
消息风格
人性化语气规则:
- - 简短
- 具体
- 读起来像队友回访
- 避免使用Stop或end_turn等原始事件名称
如需了解架构上下文或添加新传输方式,请阅读references/architecture.md。