微信消息推送ClawBot

解决AI Agent的终端外通知难题

在自动化工作流中，AI Agent 生成的待办、日报或脚本部署结果往往只停留在终端里。当需要将这些信息推送到日常高频使用的微信时，传统的 API 接入不仅需要复杂的鉴权配置，还常常面临会话掉线的问题。该技能通过复用本机已配对的微信 ClawBot 插件凭证，让 Agent 能够绕过繁琐的扫码流程，直接向个人微信主动发送文本消息。

核心机制与调用逻辑

技能底层基于腾讯 iLink Bot API（https://ilinkai.weixin.qq.com/ilink/bot/sendmessage）实现。发送时，脚本会自动扫描 ~/.workbuddy/claw-state/weixin/ 目录下的活跃凭证文件，提取 botToken 并进行 Bearer 认证。

• 主动发送：调用 weixin_send.py 时绝不携带 context_token，服务端依赖此规则来区分新消息与回复，带错 token 会导致消息被静默丢弃。
• 监听回复：通过 weixin_listen_send.py 捕获用户最新消息的实时 context_token，再调用 send 接口完成精准回复。
• 容错机制：网络波动时自动重试 3 次，并在凭证过期（如 errcode=-14）时提供清晰的重新扫码指引。

适用边界与安全红线

目前该通道仅支持纯文本消息，无法直接推送图片、文件或语音。此外，botToken 与 context_token 本质上等同于微信登录态，严禁硬编码、打印在日志或提交至公开仓库。在非 macOS 平台上，需手动确认 WorkBuddy 凭证路径的可读性以保证脚本正常运行。