夜雨聆风学习资料网

ARTICLE · 1165106

我写了个小工具:AI 跑完任务,主动给我发条微信

我写了个小工具:AI 跑完任务,主动给我发条微信
微信通知 · 我自己写的2026.10

让 AI 干活,人还在终端前面罚站?

任务跑完的那一秒

你的微信会响

一条 clawbot 命令 · 文本和图片都能推 · 一行命令装好 · MIT 开源

wechat-clawbot-notify

MIT 开源不用服务器

📦 7 个部分 + 结语

👉 滑动

PART 01

为什么是微信

你每天只看它

PART 02

长什么样

六个命令

PART 03

一行装好

真人两步

PART 04

接进工作流

AI 自己发

PART 05

唯一的坑

不能主动开场

PART 06

不用官方插件

能少一层

PART 07

高频问题

FAQ

PART ///

写在最后

仓库地址

个人 AI 工作流的一个真相

超过两分钟的任务,不该用人守着终端

先说个我每天都在经历的场面。

我在服务器上跑一个部署,或者让 AI 改一版代码、跑一批数据。活儿本身十分钟二十分钟,都不长。真正难受的是这十分钟里,人被钉在终端前面——不敢走开,怕它中途报错没人看;又不能干别的,就一直刷那几行日志。

后来我给自己定了个规矩:

任何超过两分钟的任务,跑完必须主动来找我。

于是有了这个小工具。它叫 clawbot,一条命令,把任意文本或者图片,推到你自己的微信里。

现在我的日常变成这样:

...bash

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)

一张图

配一句说明「测试配图」

命令侧只有六个:

...bash

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。

STEP 01

装它

...bash

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。可以重复跑,不会把已有环境搞坏。

STEP 02

然后必须真人操作两步,AI 帮不了你

...bash

clawbot login

终端里会画出一个 ASCII 二维码,微信「扫一扫」授权。之后在微信里主动给这个 ClawBot 发一条消息(发 hi 就行),再跑 clawbot pair 60。

这两步做完,你就能 clawbot send 了。

两个小前提:SDK 硬要求 Python ≥3.11;首次必须你本人在微信里扫码、并主动发一条消息,这一步没有任何绕过去的办法。

如果你连命令都懒得敲,把下面这段原话丢给有 shell 权限的 AI(Claude Code、Codex、pi 都行):

...发给 AI 的原话

帮我安装 wechat-clawbot-notify。请把

https://github.com/nephen/wechat-clawbot-notify 克隆到

~/.claude/skills/wechat-clawbot-notify,然后执行其中的 install.sh,

装完跑一次 clawbot status 确认命令可用,

并告诉我下一步需要我在微信里做什么。

它会自己装完,然后回头告诉你「现在去微信扫码」。

04

PART

接到你的工作流里

WORKFLOW · 它就是个普通命令

装好之后它就是个普通命令行工具,所以哪里都能塞。

让 AI 自己通知你。 干活前跟它说一句「跑完发微信通知我」,它会自己在最后一步执行:

...bash

clawbot send "改完了,测试 42 passed / 1 failed,失败在 auth.spec.ts"

发图往往比发字更值钱。 页面改好了让它甩张截图,脚本跑崩了让它把报错截图发过来:

...bash

clawbot image /tmp/login-page.png "登录页新样式"

定时任务。 crontab 里直接调:

...cron

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

github.com/nephen/wechat-clawbot-notify

装的时候卡在哪一步,评论区说一声,我看到就改。

如果你也是那种「让 AI 干活,然后自己守在终端前面刷日志」的人,试一下把通知通道接上——你会突然发现,原来这十分钟是可以还给自己的。

既然看到这里了,如果觉得有用,随手点个赞、在看、转发三连吧。

点赞
在看
转发

THANKS FOR READING

相关学习资料