我把个人 Agent 控制台做进了微信

大家好,我是 WeiWill,深耕软件工程一线,专注 AI 应用落地与 Agent 开发。

最近做内容中台的时候,我遇到一个很小但很真实的问题:任务跑到哪一步了,我不想一直盯着终端,也不想专门打开一个管理后台。

如果是在飞书、钉钉里,这件事很好办,放一个机器人就能推送通知。但我平常用得最多的是微信。于是问题变成了:有没有办法让我的个人 Agent 主动给微信发消息,甚至进一步通过微信聊天窗口反向控制它?

研究了一圈之后,我没有停在“为什么可以把微信当入口”这个层面,而是直接做了一个可用的个人 Agent 微信控制台。

这个控制台不需要用户关注服务号,也不依赖第三方服务号链路,而是基于微信官方的 openclaw-weixin 仓库做改造。这里的关键前提是:入口不是我随便找的第三方服务号,而是微信里的 微信 ClawBot。

从账号功能介绍可以看到,它的说明是“连接 OpenClaw 与微信。当你发消息后,微信 ClawBot 仅接收 OpenClaw 24 小时内的回复。”也就是说,这个账号本质上提供的是 OpenClaw 和微信之间的官方通信通道。我后面的改造,都是围绕这个通道去做最小闭环,而不是重新设计一套服务号体系。

微信 ClawBot 账号功能介绍

最后实现出来以后,它既能主动推送文字、图片、视频、富文本,也能接收微信里的消息事件,再把这些事件转成后端接口可以处理的控制指令。

我做的不是聊天入口,而是控制台

过去我们控制一个工具,常见方式是打开桌面客户端、IDE 插件,或者在命令行里执行任务。对工程师来说,这些都不陌生。

但真实工作中,很多任务并不是发生在“我正坐在电脑前、已经打开完整工作环境”的时刻。比如内容中台跑完一轮处理,需要告诉我结果;某个资料同步失败,需要我确认是否重试;某个 Agent 想继续执行下一步,需要我给一句明确指令。

所以我做这个项目时,没有把目标定成“再接一个聊天机器人”。微信不适合承担复杂编排,也不应该变成 Agent 的“大脑”。我真正想做的是一个控制台:低摩擦、随手可达、天然支持确认和追踪。

如果以后我能像聊天一样给 Agent 下指令,比如“接收到程序编译失败的通知”“把失败日志发我”“这篇文章帮我分析一下”,这个体验其实就已经很接近个人工作流入口了。

我是怎么把问题问清楚的

这里记录几组我当时用来推进实现的提示词。它们不是为了展示某个标准答案,而是为了说明一个工程问题怎么一步步拆开。

提示词 1:先把前提和目标说清楚

1
2
3
4
5
6
7
8
9
10
前提:
1. 微信 ClawBot 是微信官方小龙虾号。
2. 微信 ClawBot 的账号功能介绍明确写着:连接 OpenClaw 与微信。
3. Hermes 能够登录它,并利用它完成消息控制。

基于这几个前提,我的理解是:这个号本质上提供了一个和用户通信的官方通道。

我现在想做的是:利用这个通道给自己的微信推送消息,最好可以自己完成绑定。某个服务只要调用 curl 接口,就能把消息推送到我的微信。

请先理解我的思路,然后帮我找开源项目里的实现逻辑,再分析应该怎么实现。

这个提示词解决的是“目标定义”问题。不要一上来就问代码怎么写,而是先把已有前提、目标形态、调用方式讲清楚。这里的关键不是微信,而是把“我想要一个可被服务调用的消息通道”说清楚。

提示词 2:追问能不能减少依赖

1
可以不安装 Hermes 或 QClaw 这些工具,直接实现这个能力吗?

一开始反馈是建议安装 QClaw 或 Hermes。我当时的第一反应是:Hermes 也不是微信官方的一部分,既然它能实现,那我为什么不可以?

这一步其实是在判断边界:我是要直接复用一个完整工具,还是只抽取里面必要的登录、推送和事件接收逻辑。

提示词 3:继续追问为什么必须经过中间工具

1
2
3
为什么使用“微信 ClawBot”这个号时,一定要转到 Hermes 或 QClaw?

如果它们本质上只是完成登录、消息推送和事件接收,那这些能力能不能单独抽出来?

这个问题很重要。因为如果答案是“必须依赖某个完整平台”,那它就不是一个轻量控制台;如果答案是“需要一个微信协议控制器”,那实现路径就变成了:我能不能自己做一个最小可用的协议控制器。

提示词 4:把实现方案压到最小闭环

1
2
3
4
5
6
7
8
我想把 Hermes / QClaw 里的登录逻辑、消息推送逻辑和事件接收逻辑抽出来,做成一个“自己实现的微信协议控制器”。

它不需要完整复刻 Hermes / QClaw,只需要完成三个能力:
1. 处理登录和绑定。
2. 主动向指定微信发送消息。
3. 被动接收微信消息事件,并暴露给后端服务处理。

请从已有开源实现出发,评估这个最小闭环的复杂度、风险点和接口设计。

这个提示词比原来的问法更清楚。它把“我要重造一个工具”改成了“我要抽取一个最小闭环”。这两句话听起来差不多,但工程成本完全不同。

如果目标是重造 Hermes / QClaw,那范围会越来越大;如果目标是研发一个个人 Agent 的微信控制台,就只需要围绕登录、发送、接收、外部调用这几个关键点做取舍。

最终做出来的形态

最终我做了一个守护程序,主要处理四件事:

  1. 处理登录和绑定。
  2. 主动发送微信消息。
  3. 被动接收微信消息事件。
  4. 把核心能力封装成接口,方便外部通过 curl 调用。

这样一来,内容中台、自动化脚本、个人 Agent 都可以通过这个控制台和微信打通。它们不需要理解微信内部逻辑,只需要调用接口;微信这一侧也不需要变成复杂系统,只负责通知、确认和触发。下面是具体的效果图片,如果需要这套代码,后台加我好友,我发给你。

个人 Agent 微信控制台效果图

这件事真正说明了什么

很多 Agent 项目卡住,不是因为模型不会回答,而是因为它缺少一个低成本的人机确认面。它不知道什么时候该通知人,也不知道人怎么用最自然的方式给它补充指令。

微信不适合承载所有复杂逻辑,但它适合做一个轻量入口。尤其对个人工作流来说,最重要的不是做一个大而全的平台,而是先把几个高频动作跑通:

  1. 任务完成后能通知我。
  2. 出错时能把关键信息发给我。
  3. 需要确认时能让我直接回复。
  4. 我能用一句话触发下一步动作。

如果这些动作跑通了,这个控制台就不只是消息通知工具,而会成为个人 Agent 进入真实工作流的一层人机控制面。

当然,这里也有边界:登录、协议适配、消息权限、稳定性、隐私和账号风险都要认真评估。个人使用可以先小范围验证,但如果要做成团队级、产品级能力,就必须重新设计权限、审计、限流和异常处理。

我的下一步是继续把这个个人 Agent 微信控制台接到内容中台里,让它先承担三个最具体的任务:任务状态通知、失败日志推送、定稿流程确认。先不追求大而全,先把一个真实闭环跑稳。

我是 WeiWill,深耕软件工程一线,专注 AI 应用落地与 Agent 开发。