ARTICLE · 1165106
我写了个小工具:AI 跑完任务,主动给我发条微信
让 AI 干活,人还在终端前面罚站?
任务跑完的那一秒
你的微信会响
一条 clawbot 命令 · 文本和图片都能推 · 一行命令装好 · MIT 开源
wechat-clawbot-notify
📦 7 个部分 + 结语
👉 滑动
PART 01
为什么是微信
你每天只看它
PART 02
长什么样
六个命令
PART 03
一行装好
真人两步
PART 04
接进工作流
AI 自己发
PART 05
唯一的坑
不能主动开场
PART 06
不用官方插件
能少一层
PART 07
高频问题
FAQ
PART ///
写在最后
仓库地址
个人 AI 工作流的一个真相
超过两分钟的任务,不该用人守着终端
先说个我每天都在经历的场面。
我在服务器上跑一个部署,或者让 AI 改一版代码、跑一批数据。活儿本身十分钟二十分钟,都不长。真正难受的是这十分钟里,人被钉在终端前面——不敢走开,怕它中途报错没人看;又不能干别的,就一直刷那几行日志。
后来我给自己定了个规矩:
任何超过两分钟的任务,跑完必须主动来找我。
于是有了这个小工具。它叫 clawbot,一条命令,把任意文本或者图片,推到你自己的微信里。
现在我的日常变成这样:
npm run build && clawbot send "build 完成: $(git rev-parse --short HEAD)"
敲完回车我就走。成没成,微信会告诉我。
01
PART
为什么非得是微信
NOTIFY · 看得过来的才算通知
通知通道这东西,十年前就有答案了:邮件、钉钉、飞书、企业微信机器人、Server 酱、Bark……
但我实测下来,只有一条路能真的「叫到我」——微信是我唯一每天必看的 App。
邮件
我一天开两次,报错躺在里面两小时不动。
钉钉 / 飞书
装在公司手机上,下班就不看了。
Server 酱这类推送网关
要么收费、要么限次数、要么得挂一个第三方中转服务,凭据还留在别人机器上。
企业微信机器人
免费,但那是个独立 App,我照样不看。
而微信 ClawBot 是微信官方自己提供的插件(微信里「我 → 设置 → 插件」能看到)。今年 3 月腾讯把个人微信的 iLink 接口开放出来之后,第三方 SDK 就能直接连上这条通道。
翻译成人话:你的 AI 可以直接往你自己的微信里发消息,不用中转服务、不用企业微信、不用公网服务器、不用付费。
02
PART
它实际长什么样
DEMO · 六个命令
我在微信里收到的东西,就是下面这个会话,截图是真实跑出来的:
一条文本
【测试】ClawBot 单向通知已打通
一条状态
保活服务已上线(systemd:clawbot-listen)
一张图
配一句说明「测试配图」

命令侧只有六个:
clawbot login # 终端画二维码,微信扫码授权,只做一次
clawbot pair 60 # 拿推送凭据(第 05 节解释为什么需要)
clawbot send "内容" # 推文本,多行走管道
clawbot image a.png "说明" # 推图片,本地路径或 URL 都行
clawbot listen 0 # 常驻保活,自动续凭据
clawbot status # 看账号和可推送目标
内容真的随意:报错原文、测试数量、爬虫抓到的价格、生成的截图、一段 Markdown 报告,都行。
03
PART
一行命令装好
INSTALL · 复制粘贴即可
前提:Linux 或 macOS(Windows 走 WSL 或者 Git Bash),有 git 和 curl。脚本会自己建一个独立 Python 环境,不动你系统的 Python。
装它
git clone https://github.com/nephen/wechat-clawbot-notify \
~/.claude/skills/wechat-clawbot-notify
bash ~/.claude/skills/wechat-clawbot-notify/install.sh
install.sh 干三件事:建 venv(Python ≥3.11,装了 uv 就用 uv,没有就找本机的 3.11 / 3.12 / 3.13)、装依赖、把 clawbot 命令放进 ~/.local/bin。可以重复跑,不会把已有环境搞坏。
然后必须真人操作两步,AI 帮不了你
clawbot login
终端里会画出一个 ASCII 二维码,微信「扫一扫」授权。之后在微信里主动给这个 ClawBot 发一条消息(发 hi 就行),再跑 clawbot pair 60。
这两步做完,你就能 clawbot send 了。
两个小前提:SDK 硬要求 Python ≥3.11;首次必须你本人在微信里扫码、并主动发一条消息,这一步没有任何绕过去的办法。
如果你连命令都懒得敲,把下面这段原话丢给有 shell 权限的 AI(Claude Code、Codex、pi 都行):
帮我安装 wechat-clawbot-notify。请把
https://github.com/nephen/wechat-clawbot-notify 克隆到
~/.claude/skills/wechat-clawbot-notify,然后执行其中的 install.sh,
装完跑一次 clawbot status 确认命令可用,
并告诉我下一步需要我在微信里做什么。
它会自己装完,然后回头告诉你「现在去微信扫码」。
04
PART
接到你的工作流里
WORKFLOW · 它就是个普通命令
装好之后它就是个普通命令行工具,所以哪里都能塞。
让 AI 自己通知你。 干活前跟它说一句「跑完发微信通知我」,它会自己在最后一步执行:
clawbot send "改完了,测试 42 passed / 1 failed,失败在 auth.spec.ts"
发图往往比发字更值钱。 页面改好了让它甩张截图,脚本跑崩了让它把报错截图发过来:
clawbot image /tmp/login-page.png "登录页新样式"
定时任务。 crontab 里直接调:
0 7 * * * $HOME/.local/bin/clawbot send "早,昨天的抓取跑完了"
✦ 建议做的一步
跑一个 clawbot listen 0 常驻,它会随时接住你在微信里发的消息、自动把新的推送凭据落盘,基本就再也不会遇到过期。仓库 README 里有一段现成的 systemd 配置,抄过去就能用。
05
PART
唯一的坑:bot 不能主动开场
PITFALL · 这一脚我踩了半小时
微信 ClawBot 不允许机器人主动开启会话。 发送接口需要一个 context_token,而这个 token 只在「人先给 bot 发过消息」时才产生。
所以你会遇到这些现象,它们全都是正常的:
刚 login 完就 send
报「没有 context_token」。去微信里发一条消息,再 clawbot pair 60。
用了一阵突然报 -14
SessionExpiredError,token 过期了。在微信里再发一条消息,等 listen 打印出 [收到],重试就好。
挂着不动就永远有效?
轮询本身不会续期 token,这也是我把 listen 常驻的原因。
它是单向的
你回它消息它不接(除非你自己在 listen 里加回显)。要做微信和 AI 双向对话,那是官方 ClawBot 插件的活。
!踩坑提示 🕳
listen 跑着的时候不要再另开 pair:两个轮询共用同一个游标,会互相抢消息,表现成谁都收不到。先停一个再 pair。
06
PART
为什么我不直接用官方插件
WHY · 能少一层就少一层
官方插件的目标是把微信变成你 AI 助手的对话框——agent 要常驻、要接消息、要回消息、要管会话状态。
而我要的只是一声「叮」。
所以这个仓库里只有一个 Python 脚本和一个 install 脚本:没有守护框架、没有配置文件、没有账号体系,装完 20 MB 依赖。它不绑定任何 agent——Claude Code、Codex、pi、Cursor、crontab、CI,谁爱调谁调。
工具嘛,能少一层就少一层。
07
PART
附:几个高频问题
FAQ · 装的时候最容易卡住的地方
Q:Windows 能用吗?
A:能,在 WSL 或者 Git Bash 里跑。原生 PowerShell 我没测。
Q:Python 版本不够?
A:install.sh 会自己找 3.11 以上的解释器,或者用 uv 拉一个,不会去动你的系统 Python。
Q:能不能拿它群发、发营销消息?
A:不能,也别想。它只会往你自己那一个会话里发,微信侧对这类接口有约束,拿去做群发只会把你的号搞没。
Q:凭据安全吗?
A:bot_token 落在你自己机器的 ~/.clawbot-notify/state,写盘时 umask 077,同机其他用户读不到。别把这个目录提交进 git。
Q:它会不会哪天就失效了?
A:有可能。这是走微信内部网关的非官方封装,不是腾讯给你的正式开放接口。真失效了先升级 SDK 试试,不行就去仓库提 Issue。
///
LAST
写在最后
SUMMARY · 把那十分钟还给自己
用 AI 干活,被吃掉的时间从来不是 AI 思考的那部分,而是你陪它的那部分:一个终端窗口、一段日志、一次「不知道跑完没有」。看着不多,一天下来能磨掉你一半的注意力。
这个小工具做的事很单一:让「等结果」这件事,从你的日程表里消失。
MIT 协议,开源,随便用随便改。仓库地址(公众号里外链点不了,复制到浏览器打开):
github.com/nephen/wechat-clawbot-notify
装的时候卡在哪一步,评论区说一声,我看到就改。
如果你也是那种「让 AI 干活,然后自己守在终端前面刷日志」的人,试一下把通知通道接上——你会突然发现,原来这十分钟是可以还给自己的。
既然看到这里了,如果觉得有用,随手点个赞、在看、转发三连吧。
THANKS FOR READING