整体架构：一条消息的完整旅程

在动手之前，先理解整条数据流水线：

微信消息 → iPad 协议接收 → 消息中转网关 → OpenClaw Agent → AI 回复 → 微信

三个核心模块，各司其职。为什么不用更常见的微信 Web 协议？因为 Web 协议极不稳定，动不动就封号。这个方案走的是 iPad 协议配合消息中转，稳定性高出一个量级。

理解了这条流水线，接下来逐个拆解每个模块。

第一步：iPad 协议层——稳定接收微信消息

这一步要解决的核心问题是：怎么让程序稳定地收发微信消息，同时不被封号？

思路很直接：模拟 iPad 客户端登录微信，通过长连接接收消息推送。相比 Web 协议那种「说封就封」的体验，iPad 协议的稳定性要好得多。

如果你用 AI 辅助开发，可以这样描述需求：

帮我实现一个基于 iPad 协议的微信消息接收模块，要求：
1）模拟 iPad 客户端登录
2）支持扫码认证
3）长连接接收消息
4）输出标准化消息格式（包含发送者、消息类型、内容、群聊信息）

协议选对了，后面所有环节都会顺畅很多。这一步是整个系统的地基。

第二步：消息中转网关——系统的大脑

iPad 协议解决了「收消息」的问题，但原始消息到 AI 之间还有一堆脏活要处理：消息格式转换、去重、限流、路由。这就是中转网关的职责。

项目用 TypeScript 编写（与 OpenClaw 技术栈一致），核心设计包含几个关键机制：

  • LRU 缓存做消息去重：微信的推送机制有个「特色」——同一条消息有时会推送 2-3 次。不做去重，AI 就变成复读机
  • 群聊只响应 @ 触发，私聊直接连接：避免 AI 在群里疯狂刷屏的尴尬场面
  • 多模型智能路由：闲聊用 DeepSeek 省钱，写代码切 Claude 保质量
  • 「思考中...」状态提示：大模型推理需要几秒，加个提示避免对方以为你已读不回

用 AI 写这个模块时，可以把上面这些要求逐条列清楚：

帮我实现一个消息中转网关，TypeScript 编写，包含以下功能：
1）基于消息ID+时间窗口的 LRU 去重缓存
2）群聊 @ 触发机制（只有 @ 机器人才回复）
3）私聊消息直接转发
4）根据消息内容自动路由到不同大模型
5）"思考中..."状态提示机制

这一步的质量直接决定了日常使用体验。去重没做好，AI 变复读机；路由没做好，成本白白翻倍。

第三步：对接 OpenClaw——最后一公里

消息能收、能处理了，最后只需要把它推给 OpenClaw，再把 AI 的回复转发回微信。

技术上通过 Webhook 实现：中转网关将标准化消息通过 HTTP POST 推送到 OpenClaw Gateway，OpenClaw 处理完成后回调，中转网关再把回复转发回微信。这里还需要维护会话状态，让 AI 能记住上下文，支持多轮对话。

帮我实现 OpenClaw Webhook 对接模块：
1）将标准化消息通过 HTTP POST 推送到 OpenClaw Gateway
2）接收 OpenClaw 的回调响应
3）维护会话状态（支持多轮对话上下文）
4）错误重试和超时处理

三步走完，整个系统就能跑起来了。

部署：5 分钟上线

实际部署非常简单，不需要公司认证，不需要企业微信，普通个人号直接可用：

# 克隆项目
git clone https://github.com/freestylefly/openclaw-wechat.git

# 配置环境变量
openclaw config set channels.wechat.apiKey "你的API Key"
openclaw config set channels.wechat.proxyUrl "你的代理地址"
openclaw config set channels.wechat.enabled true

# 安装插件，扫码登录
openclaw plugins install /openclaw-wechat

踩坑提醒

几个过来人的经验，能帮你少走不少弯路：

  • 消息去重必须做：微信同一条消息推 2-3 次是常态，不处理体验很差
  • 用小号测试：iPad 协议虽然比 Web 协议稳定，但毕竟是第三方接入，稳妥起见先拿小号跑通
  • 固定 IP 部署：频繁更换 IP 容易触发腾讯风控，这点服务器钱别省
  • 别搞群发营销：老老实实当 AI 助手用，腾讯的风控系统不是摆设
  • 回复延迟要处理：加「思考中...」提示，不然对方以为你故意不回

成本与应用场景

算一笔账：

  • OpenClaw：开源免费
  • 大模型 API：GLM-5 开源免费，Claude/GPT 按量计费，日常使用约 30-50 元/月
  • 云服务器（固定 IP）：50-100 元/月
  • 总计：100-150 元/月

一个月一百多块，能换来什么？

  • 智能群聊助手：技术群里随时回答代码问题
  • 个人知识管家：文章链接丢给它，自动总结存入 Notion
  • 日程提醒：自然语言设定提醒，到点微信通知你
  • 自动回复：好友消息即时响应，解放双手
  • 资讯搜集：让 OpenClaw 自动抓取行业动态，汇总推送

这个项目真正有意思的地方在于，它把 AI Agent 从「实验室玩具」拉到了国内用户最高频的沟通场景里。当你的微信好友列表里多了一个 24 小时在线、能查资料、能写代码、能做总结的 AI 助手，工作流的想象空间就完全不一样了。那么问题来了——如果你有一个随时待命的 AI 微信助手，你会让它先帮你做什么？