把电脑端 WorkBuddy 连到你的微信推送（纯小白教程）

读完这篇，你就能让电脑上的 WorkBuddy 在「任务跑完 / 定时到点 / 需要你确认」时，主动给你手机微信发一条消息提醒。 全程不用装任何第三方软件，凭证只存在你自己电脑上，不上传、不联网回传。

一、这玩意儿到底能干嘛？

想象一下：你在电脑上让 WorkBuddy 跑一个要 20 分钟的任务，然后你就去忙别的了。任务跑完，手机「叮」一声——微信里收到一条「任务已完成：xxx」。

这就是「微信推送」。它基于微信官方的 iLink / ClawBot 协议，把你电脑上的 WorkBuddy 和你自己的个人微信绑起来，只推给你自己，不影响别人。

二、开始前你要有的东西

1. 一台装了 WorkBuddy 桌面端的电脑（Windows / macOS / Linux 都行）。

1. 微信里能看到一个叫 ClawBot 的机器人——说明你已经在 WorkBuddy 里绑定了微信通道（没有的话，先在 WorkBuddy 设置里把微信通道连上）。

1. 你会用微信发消息（这条最关键，后面要用来「激活」推送）。

三、五步走，跟着做就行

第 1 步：装好推送技能

• 打开 WorkBuddy，进「技能管理」，搜索 wechat-clawbot-push，点安装即可。

• 装完后在 ~/.workbuddy/skills/wechat-clawbot-push/ 下能看到 scripts/wechat_clawbot_push_mcp.py 就对了。

这一步其实也可以让 AI 帮你装，直接说「安装 wechat-clawbot-push 技能」就行。

第 2 步：让 AI 帮你注册连接器（你不用手敲命令）

在 WorkBuddy 对话里直接发一句：

帮我在 ~/.workbuddy/mcp.json 里注册 wechat-clawbot-push 连接器，用 python 跑那个脚本的 --mcp 模式。

AI 会自动写好配置。注册 ≠ 生效，看下一步。

第 3 步：点一次「信任」（小白最容易卡的地方 ⚠️）

注册只是「登记」，连接器默认是不工作的，必须你亲手信任一次：

1. 打开 WorkBuddy → 右上角 「连接器管理」 → 「自定义连接器」

1. 找到 wechat-clawbot-push

1. 点一下 Trust（信任）

没点这个的话，后面所有「推送到微信」的按钮/工具在对话里都调不出来，表现为「找不到工具」。信任是一次性的，之后长期有效；换电脑重装才需要再点一次。AI 没法替你点，必须你自己在界面上确认。

第 4 步：填推送凭证（通常不用你管）

新版 WorkBuddy 把微信凭证加密了，脚本直接读不到明文。但自带一个「游标自愈」机制：

你只要让 AI 跑一次「自检 / 推送测试」，脚本会自动从本机微信通道的游标里恢复出明文凭证，写进 ~/.workbuddy/wechat-clawbot-push/credentials.json（权限 0600，仅你本机可读）。

所以这一步你什么都不用做，出问题 AI 会提示。

第 5 步：用手机给 bot 发一条消息（激活推送的「钥匙」）

iLink 是「回复型」协议：bot 必须先从你这里拿到一条消息，才能反过来给你发。

1. 拿起手机，打开微信，给 ClawBot 发任意一条消息（比如就发个「你好」或「1」）。

1. 同时在电脑上对 AI 说：

帮我获取推送 token（acquire）

1. AI 会在后台用长轮询「等着」你那条消息，抓到后自动缓存好 context_token。

小贴士：这条消息发完，你手机上可能不会马上收到我的正常回复——这是正常的，因为那条消息被推送进程「接走」去拿钥匙了。拿完钥匙 AI 会反过来给你微信推一条「已连通」做验证。

四、顺手配个「每日保活」（强烈建议，别跳）

推送用的 token 静置约 7 天以上可能失效，表现就是「定时任务跑久了突然推不出去」。配一个每天自检就能根治：

让 AI 帮你配一个每天执行的定时任务，命令是： python3 ~/.workbuddy/skills/wechat-clawbot-push/scripts/wechat_clawbot_push_mcp.py --keepalive

token 正常时它什么都不做；快过期时会主动给你微信推一条「该续期了」的提醒，你照着去手机发条消息 + 让 AI 重新获取 token 即可。

五、怎么验证通没通？

让 AI 说一句：

给我微信推送一条测试：「配置完成」

手机微信收到这条，就说明整条链路通了。也可以让 AI 跑 bridge_status 看状态：

• 已绑定 token: True → 成功

• 已绑定 token: False → 回去重做第 5 步（手机再发条消息 + 获取 token）

六、平时怎么用？

• 对话里直接说：「把刚才的结论推到我微信」「这个任务跑完了微信通知我」

• 定时 / 自动化任务跑完，自动把结果推到你手机

• 需要你拍板的事，让你回 WorkBuddy 处理

七、常见问题（对小白最友好的版）

八、安全说明（放心用）

• 脚本只用到 Python 标准库，零第三方依赖，没有供应链风险。

• 凭证（botToken / context_token）只存在你本机 ~/.workbuddy/ 下，文件权限 0600（仅你能读）。

• 不逆向 WorkBuddy 的任何加密，凭证是从微信通道协议原生携带的明文里恢复，只取和你账号匹配那份。

• 这是个人微信通道，适合「各自推到自己微信」；要群发团队工作通知请走企业微信。