乐于分享
好东西不私藏

13 | OpenClaw 接入微信:个人微信原生接入,终于来了

13 | OpenClaw 接入微信:个人微信原生接入,终于来了

OpenClaw 接入微信:个人微信原生接入,终于来了

上一篇我们聊了 Agent 设置,五个文件定义一个完整的数字分身。但 Agent 再强大,也得有个入口——你得能随时随地找到它。

飞书?太办公了。Telegram?国内不方便。Discord?小众。

真正的国民级入口,只有一个:微信

而现在,微信原生支持 OpenClaw 了。不是企业微信曲线救国,不是第三方协议冒封号风险,是个人微信直接接入。微信官方推出了 ClawBot 插件,灰度测试中,iPhone 用户已经可以用了。

一行命令,扫个码,你的 OpenClaw 就出现在微信聊天列表里——和你的家人、朋友、同事在同一个界面。

这篇我就手把手教你,怎么把个人微信接入 OpenClaw。

先看全景:三种接入方案怎么选?

微信生态接入 OpenClaw 一共有三种路径。每种路径回答一个不同的问题:

你可以把这三种方案想象成进一栋楼的三种方式——原生 ClawBot 是正门钥匙,企业微信是物业开的侧门,第三方协议是翻窗户。能走正门,就别翻窗。

方案一:微信原生 ClawBot(推荐)

这是最优解。全程 5 分钟,一行命令,扫码即用。

01、检查你的微信版本

首先,微信需要升级到最新版。目前仅支持 iPhone,安卓显然不会等太久。

升级路径:微信 → 我 → 设置 → 关于微信 → 检查新版本

需要升级到 8.0.70 版本。升级完成后,杀掉微信进程,重新打开。

然后进入:我 → 设置 → 插件

如果能看到「微信 ClawBot」,就说明你已经灰度到了。看不到?别急,往下看方案二。

02、安装微信 OpenClaw CLI

接入非常简单,在电脑上执行一行命令:

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

这个命令会从 npm 下载腾讯官方的微信 OpenClaw CLI 工具,自动完成安装配置。

命令执行后,CLI 工具会自动完成以下事情:

  1. 下载并安装微信 OpenClaw 适配器
  2. 检查本地 OpenClaw 环境
  3. 生成微信连接配置
  4. 启动本地 Gateway 服务

稍等片刻,就会看到微信的扫码界面。这个二维码是微信官方生成的临时连接凭证,有效期大概 5 分钟。超时了会重新生成一个新的。

拿起微信,扫码,连接成功。

整个流程不需要配置飞书,不需要注册企业微信,就是个人微信直接接入

03、测试消息收发

连接成功后,发个消息测试一下:你好,帮我生成一份微信用户需求调研。

如果能收到回复,就说明微信已经成功接入 OpenClaw。消息通道是这样走的:

微信 → 腾讯服务器 → OpenClaw Gateway → 大模型 → OpenClaw Gateway → 腾讯服务器 → 微信

04、和飞书接入的对比

用过飞书接入的小伙伴应该深有体会。两者的差距不是"简化了几步",而是思路完全不同

飞书接入流程:

  1. 注册飞书开放平台账号
  2. 创建企业自建应用,填写应用名称和描述
  3. 添加机器人能力,获取 App ID 和 App Secret
  4. 配置权限管理,开通权限
  5. 配置事件订阅,开启长链接模式,添加 im.message.receive_v1 事件
  6. 在 OpenClaw 中配置飞书通道,填入 App ID 和 App Secret
  7. 在飞书里找到机器人,发送消息测试进行配对

整个过程 10-20 分钟,还要在飞书后台和 OpenClaw 配置之间来回切换。

微信原生接入流程:

  1. 升级微信到 8.0.70
  2. 检查是否灰度到 ClawBot 插件
  3. 执行一行命令
  4. 扫码连接

全程 5 分钟搞定,零配置。

当然,微信接入目前还是灰度阶段,功能不如飞书那么完整。飞书支持的多维表格操作、日程管理、审批流程等高级功能,微信暂时还没有。

但从体验上来说,个人微信直接能用这件事本身,就是巨大的进步。它把 OpenClaw 的门槛从企业级应用降到了个人玩具。

方案二:企业微信 + 微信插件(通用方案)

没灰度到 ClawBot?不要紧。企业微信 + 微信插件是目前最稳定、最合规的通用方案。

核心思路:在企业微信中创建自建应用 → 对接 OpenClaw → 通过「微信插件」桥接到个人微信。不用第三方协议,不用担心封号,可以用大号。

01、前置准备

公网服务器(必需)。企业微信方案需要 OpenClaw 部署在可被外网访问的服务器上。阿里云、腾讯云、百度云均提供 OpenClaw 一键部署镜像。

确保 OpenClaw 已安装并运行:

将 Gateway 配置为公网模式,编辑 ~/.openclaw/openclaw.json

⚠️ allowInsecureAuth 仅适用于 HTTP 模式。生产环境务必配置 HTTPS。

重启网关:openclaw gateway restart

02、企业微信后台配置

注册企业微信:访问 企业微信管理后台,微信扫码注册,个人使用可填写个人工作室名称。

创建自建应用:应用管理 → 自建 → 创建应用。起个名字,上传个 🦞 小龙虾头像,选好可见范围。

创建成功后,记录三个核心参数

🔒 Secret 泄露 = 企业微信安全风险。保管好,不要提交到 Git。

配置消息接收:在应用详情页找到「接收消息」→ 设置 API 接收 → 点击「随机获取」,得到 Token 和 EncodingAESKey。保存备用,URL 先不填

03、OpenClaw 侧配置

这一步是核心对接。编辑 ~/.openclaw/openclaw.json

也可以用命令行逐条配置:

04、完成回调验证

回到企业微信管理后台「接收消息」配置页,现在填写 URL:

http://你的公网IP:18789/wecom/app

点击保存。如果配置正确,会显示「验证成功」。

验证失败? 按这个顺序排查:Gateway 是否重启了 → 防火墙是否放通 18789 → Token/AESKey 是否一致 → openclaw logs --follow 看日志。

05、打通个人微信

这一步是关键——让个人微信也能用这个企业应用。

  1. 管理后台 → 我的企业 → 微信插件
  2. 用个人微信扫描页面上的二维码
  3. 关联成功后,个人微信会收到企业微信通知

完成后,在微信的 通讯录 → 我的企业 中找到应用入口,发条消息测试。收到回复就说明全链路打通了。

方案三:第三方协议(仅供研究)

⚠️ 此方案使用第三方协议模拟登录,存在封号风险。仅供学习研究,请用小号测试。

社区项目 openclaw-wechat 提供了个人微信直连能力:

首次启动会显示二维码,微信扫码登录即可。但再次强调:有封号风险,非必要不推荐。

五个场景协同工作:微信 ClawBot完整的一天

光说"能聊天"太抽象了。真正的价值在于它们一起工作的样子——就像上一篇我们讲的五个文件协同,场景之间也会串联起来。

假设你是一个小团队负责人,看看微信里的 ClawBot 怎么陪你过一天。

早上 8:30 · 通勤路上

你在地铁上刷到一篇行业分析文章,觉得不错,随手转发给 ClawBot。

以前的你:收藏 → 吃灰 → 三个月后翻收藏夹 → "这啥?当时为什么收藏的?"

现在:ClawBot 调用 Chrome DevTools MCP 打开链接,读取全文,30 秒后给你回一条消息——三句话摘要 + 和你上周让它整理的竞品报告的关联点。你到公司前,这篇文章已经进入你的知识库了。

关键能力:ClawBot 不只是"读文章",它有上下文——它记得你之前让它干过什么,所以能做关联,而不是每次都从零开始。

上午 10:00 · 审批地狱

同事在微信群里发了一份合同 PDF,让你看看有没有问题。你不想打开电脑。

直接把 PDF 转发给 ClawBot:

"帮我看一下这份合同,重点关注付款条款和违约责任,列出可能有风险的地方。"

两分钟后,ClawBot 回复了一份结构化的风险清单。你在手机上扫一眼,发现第 7 条的违约金比例确实偏高,直接在群里回复同事。

你没打开电脑,没下载文件,没切换任何应用。 这件事从头到尾在微信里完成了。

下午 2:00 · 会议间隙

项目群里讨论了一上午,消息 99+。你开完另一个会,根本没空爬楼。

给 ClawBot 发一条:

"帮我看一下项目群今天上午的讨论,整理成待办清单,标注每条是谁提的。"

ClawBot 回复一份按人分组的待办列表。你扫一眼,发现设计师提了三个需求你还没回应,直接在群里 @ 她对齐。

这里有个细节:如果你在上一篇里配好了 TOOL.md,ClawBot 会知道"整理群聊"该用消息读取工具,"生成待办"该用文件写入工具,而不是反过来。Agent 设置的质量直接决定了这类复杂任务的执行效果。

傍晚 6:00 · 下班前

你想给老板发一封本周工作汇报邮件,但实在不想写。

给 ClawBot 发:

"根据这周我们的聊天记录,帮我写一封周报邮件,发给老板。重点突出合同审核和项目推进两件事。"

ClawBot 回溯本周的对话上下文,知道你审了哪份合同、项目群的待办推进到什么程度,生成一封邮件草稿发给你。你改两个词,转发给老板。

⚠️ 注意:如果你在 SOUL.md 里写了"对外发送的内容必须经过确认",ClawBot 不会直接帮你发邮件——它只会生成草稿,等你确认。这就是价值观在起作用。

晚上 9:00 · 临时起意

你突然想起明天有个客户拜访,需要一份产品介绍 PPT。

把之前做过的旧版 PPT 发给 ClawBot:

"基于这个 PPT 的结构,更新一下数据,用最新的产品参数。风格活泼一点,明天给客户看。"

你去洗澡,回来的时候 ClawBot 已经把新 PPT 发到聊天窗口了。

你发现了吗? 这五个场景里,

你没有打开过任何"AI 应用"。所有交互都发生在微信里——一个你本来就要用的地方。

这就是微信接入和其他方案的本质区别。飞书接入是"多了一个机器人同事",微信接入是"你的助手住进了你的生活"。

最容易踩的四个坑

坑一:先配了企业微信回调,再配 OpenClaw

❌ 先在企业微信后台填 URL → 验证失败✅ 先在 OpenClaw 配好通道并重启 → 再去企业微信填 URL

顺序反了,回调验证一定失败。因为企业微信会立刻向你的 URL 发验证请求,OpenClaw 还没配好,自然接不住。正确顺序:先 OpenClaw,后企业微信。

坑二:防火墙没放通端口

OpenClaw 配好了,企业微信回调 URL 也填了,但就是验证不过。九成是防火墙的锅。云服务器需要在安全组里放通对应端口(默认 18789)。

坑三:个人微信收不到消息

企业微信里能用,但个人微信没反应。检查两件事:

  1. 是否在管理后台开启了「微信插件」并用个人微信扫码关联
  2. 应用的「可见范围」是否包含了你自己

坑四:配置参数写反了

CorpID、AgentId、Secret、Token、AESKey——五个参数,来自两个地方(企业信息页 + 应用详情页),很容易搞混。建议获取一个填一个,别攒到最后一起填。

微信接入 OpenClaw 的意义,不在于技术上多复杂,而在于它把 AI 助手真正融入了日常沟通场景——不是一个需要专门打开的应用,而是聊天列表里随时能找到的那个人。

下一篇教程是什么?

下一篇:OpenClaw 十问十答——从傅盛李诞呼兰的养虾热潮,到字节、阿里、百度、腾讯、Kimi、MiniMax 纷纷下场,关于 OpenClaw 大家最关心的 10 个问题一次讲清。