OpenClaw 接入微信个人号教程（iPad 协议 + 中转网关 + OpenClaw）

OpenClawZH Team 2026-02-13

目标：让微信个人号变成一个 24 小时在线的 AI 好友

核心优势：不走微信 Web 协议（高风险封号），改走 iPad 协议 + 消息中转，稳定性更高。


总体架构（先把链路想清楚）

整个系统就是一条流水线，分 3 个模块：

  1. 微信消息接收（iPad 协议层）
  2. 消息中转网关（系统大脑）
  3. 对接 OpenClaw（最后一公里）


数据流如下：


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


1) 模块一：微信消息接收（iPad 协议层）

1.1 要解决的问题

  • 稳定接收微信消息
  • 尽量降低封号风险
  • 支持扫码登录、长连接推送

1.2 开发思路（为什么不用 Web 协议）

  • 微信 Web 协议经常触发风控，封号风险高
  • iPad 协议模拟 iPad 客户端登录
  • 通过长连接接收消息推送，稳定性更强

1.3 标准化输出（很关键）

这一层不要把“微信原始消息”直接往后丢，先统一成标准格式（后面网关、OpenClaw 才好接）：

  • 发送者（userId / 昵称）
  • 消息类型（文本/图片/语音/文件/链接…）
  • 内容（text / mediaUrl / fileMeta）
  • 群聊信息（群 id、群名、是否@机器人、@内容等）
  • 消息唯一标识（msgId）+ 时间戳（timestamp）

1.4 让 AI 帮你写代码的 Prompt

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


2) 模块二：消息中转网关（整个系统的大脑）

2.1 要解决的问题

这里要干“脏活累活”，但体验好不好全靠它：

  • 消息格式转换
  • 去重（微信同一条消息可能推 2–3 次）
  • 限流（防刷屏/防模型爆账单）
  • 路由（群聊 vs 私聊、@触发规则）
  • 多模型选择（省钱 + 稳定）
  • “思考中…”提示（避免对方以为你已读不回）

2.2 推荐技术栈

  • TypeScript（和 OpenClaw 技术栈一致，集成更顺）

2.3 必做功能清单

(1) LRU 去重缓存

  • Key：msgId + 时间窗口
  • 目的：同一条消息多次推送时只处理一次

(2) 群聊触发规则（只在 @ 时回复）

  • 避免 AI 在群里无限输出造成社死
  • 只有命中 @机器人 才转发到 OpenClaw

(3) 私聊直连

  • 私聊直接转发给 OpenClaw，体验最顺

(4) 多模型智能路由

  • 闲聊 / 简单问答 → DeepSeek（省钱）
  • 写代码 / 复杂任务 → Claude / GPT（更靠谱）

(5) “思考中...”状态提示

  • 模型响应 3–10 秒很正常
  • 先回一条占位提示，体验会好很多

2.4 让 AI 帮你写代码的 Prompt

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


3) 模块三：对接 OpenClaw（最后一公里）

3.1 要解决的问题

  • 把标准化消息推给 OpenClaw
  • 接收 OpenClaw 的回复回调
  • 把 AI 回复转发回微信
  • 维护会话上下文（多轮对话）

3.2 推荐对接方式

  • 通过 Webhook / HTTP POST 把消息推给 OpenClaw Gateway
  • OpenClaw 处理完回调回来
  • 中转网关把回复转发回微信

3.3 会话状态管理（必须）

至少要做到：

  • 私聊：按对方 userId 维持 session
  • 群聊：按 群ID + 发送者ID 维持 session（否则群里多人聊天会串线）

3.4 让 AI 帮你写代码的 Prompt

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


4) 踩坑提醒（照着避雷）

  • 消息去重必须做：微信同一条消息推 2–3 次很常见，不去重 AI 会变复读机
  • 先用小号测试：iPad 协议更稳，但毕竟第三方接入，谨慎为上
  • 固定 IP 部署：频繁换 IP 更容易触发风控，别省服务器钱
  • 别搞群发营销：定位就当 AI 助手用，腾讯风控不是吃素的
  • 处理回复延迟：大模型想几秒很正常，加“思考中…”提示，避免误会


5) 成本预估（原文数字保留）

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


6) 能做什么（典型玩法）

  • 智能群聊助手：技术群里 @机器人问代码问题
  • 个人知识管家：**链接丢给它，自动总结存 Notion
  • 日程提醒：“明天下午3点提醒我开会”，到点微信戳你
  • 自动回复：有人加好友问“在吗”，AI 自动接待
  • 全网资讯搜集：自动搜集行业资讯，汇总发你


7) 部署步骤（5 分钟版本）

下面命令照抄即可（把你的 Key / 代理地址换掉）：

# 第一步：克隆项目
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 @canghe/openclaw-wechat


8) 最终验收（你应该看到的结果）

  • 微信私聊机器人 → 能收到 AI 回复
  • 群里不 @ 不说话；@ 机器人 → 才回复
  • 同一条消息不会重复回复（去重生效）
  • 模型慢的时候会先发“思考中…”
  • 多轮对话不串线（session 正常）


5 分钟搞定，不需要公司认证，不需要企业微信，普通个人号直接用！！！

说真的，OpenClaw + 微信这个组合太猛了。AI Agent 不再是实验室里的玩具，而是真正能帮你干活的微信好友。

觉得有帮助？

加入我们的社区，获取更多实战模板与教程。

加入交流群 GitHub Star