
上一篇我们探讨了如何用五个文件定义一个完整的数字分身 Agent。但功能再强大的 Agent,也需要一个触手可及的入口——你得能随时随地与它对话。
飞书?太办公了。Telegram?国内不方便。Discord?还是小众。
真正的国民级入口,只有一个:微信。
而现在,微信原生支持 OpenClaw 的时代真的来了。这不是通过企业微信“曲线救国”,也不是使用有封号风险的第三方协议,而是实打实的个人微信直接接入。微信官方推出了 ClawBot 插件,目前正处于灰度测试阶段,部分 iPhone 用户已经可以抢先体验。
整个过程简化到只需一行命令,再扫个码,你的 OpenClaw 就能出现在微信的聊天列表里,与你的家人、朋友和同事平起平坐。
这篇文章,我将手把手带你了解如何将个人微信接入 OpenClaw。
先看全景:三种接入方案怎么选?
为微信生态接入 OpenClaw,目前主要有三种路径。每种方案都旨在解决一个不同的核心问题:

你可以把这三种方案想象成进入一栋大楼的三种方式——原生 ClawBot 是正门钥匙,企业微信是物业统一管理的侧门,第三方协议则是风险极高的翻窗户。能走正门,就别考虑翻窗。
方案一:微信原生 ClawBot(推荐,当前最优解)
这是目前最理想、最便捷的接入方式。全程大约5分钟,一行命令,扫码即用。
1. 检查你的微信版本
首先,确保你的微信已升级到最新版本。目前该功能仅支持 iPhone 用户,但安卓版本的跟进显然不会等太久。
升级路径:微信 → 我 → 设置 → 关于微信 → 检查新版本。
需要升级到 8.0.70 或以上版本。升级完成后,建议完全退出并重新启动微信。
然后进入:我 → 设置 → 插件。
如果你能在插件列表里看到「微信 ClawBot」,恭喜你,说明你已经被灰度到了。如果看不到也别急,我们还有后续的通用方案。

2. 安装微信 OpenClaw CLI 工具
接入过程非常简单。在你的电脑上(需要已安装 Node.js 环境)打开终端,执行一行命令:
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
这条命令会从 npm 仓库下载腾讯官方的微信 OpenClaw CLI 工具,并自动完成安装和初始配置。
命令执行后,CLI 工具会自动完成以下事情:
- 下载并安装微信 OpenClaw 适配器。
- 检查本地 OpenClaw 环境。
- 生成微信连接配置。
- 启动本地 Gateway 服务。
稍等片刻,终端界面会显示一个微信扫码界面。这个二维码是微信官方生成的临时连接凭证,有效期大约5分钟。如果超时,工具会自动生成一个新的。
拿起你的微信,扫描这个二维码,即可完成连接。
整个流程无需配置飞书,无需注册企业微信,纯粹是个人微信的直接接入。

3. 测试消息收发
连接成功后,不妨发条消息测试一下。例如:“你好,帮我生成一份微信用户需求调研报告。”
如果能够收到来自 OpenClaw 的回复,就说明微信通道已经成功打通。消息的完整流转路径是:
微信 → 腾讯服务器 → OpenClaw Gateway → 大模型 → OpenClaw Gateway → 腾讯服务器 → 微信

4. 与飞书接入的体验对比
如果你体验过飞书接入 OpenClaw,就会深刻感受到两者间的差距。这不仅仅是“简化了几步”,而是设计思路上的根本不同。
飞书接入典型流程:
- 注册飞书开放平台账号。
- 创建企业自建应用,填写应用名称和描述。
- 添加机器人能力,获取 App ID 和 App Secret。
- 配置权限管理,开通必要权限。
- 配置事件订阅,开启长链接模式,添加
im.message.receive_v1 事件。
- 在 OpenClaw 中配置飞书通道,填入 App ID 和 App Secret。
- 在飞书中找到该机器人,发送消息进行配对测试。
整个过程耗时约10-20分钟,并且需要在飞书后台和 OpenClaw 配置页面之间来回切换。
微信原生接入流程:
- 升级微信到 8.0.70+。
- 检查是否被灰度到 ClawBot 插件。
- 执行一行安装命令。
- 扫码连接。
全程5分钟搞定,接近零配置。
当然,需要客观指出的是,微信原生接入目前仍处于灰度阶段,在功能完整性上可能暂时不如飞书。例如飞书支持的多维表格操作、日程管理、审批流程触发等高级功能,微信 ClawBot 可能尚未支持。
但从用户体验和普及性角度来看,个人微信能够直接使用这件事本身,就是一次巨大的进步。它成功地将 OpenClaw 的接入门槛从企业级应用降维到了个人“玩具”级别。
方案二:企业微信 + 微信插件(稳定可靠的通用方案)
如果你暂时没有被灰度到 ClawBot,不用担心。企业微信 + 微信插件是目前最稳定、最合规,且对所有用户开放的通用方案。
核心思路是:在企业微信中创建一个自建应用,然后将这个应用对接 OpenClaw,最后通过企业微信的「微信插件」功能,将这个应用的能力桥接到你的个人微信。整个过程完全不依赖第三方协议,无封号风险,可以使用你的主微信号。
1. 前置准备
公网服务器(必需)。企业微信方案要求你的 OpenClaw 实例部署在一台可以被外网访问的服务器上。各大云服务商(如阿里云、腾讯云)通常都提供预装 OpenClaw 的一键部署镜像。
首先,确保 OpenClaw 已在服务器上安装并运行。可以通过以下命令检查:
# 检查网关状态
openclaw gateway status
# 如果未安装,使用官方脚本安装
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

接着,需要将 Gateway 配置为公网可访问模式。编辑配置文件 ~/.openclaw/openclaw.json,在 gateway 部分进行如下配置:
{
"gateway": {
"port": 18789,
"bind": "lan",
"controlUi": {
"allowedOrigins": ["http://你的公网IP:18789"]
},
"auth": {
"allowInsecureAuth": true,
"dangerouslyDisableDeviceAuth": true
}
}
}

⚠️ 注意:allowInsecureAuth 配置项仅适用于 HTTP 模式的测试环境。在生产环境中,务必配置 HTTPS 以确保通信安全。
配置完成后,重启网关使配置生效:
openclaw gateway restart
2. 企业微信后台配置
注册企业微信:访问 企业微信管理后台,使用微信扫码注册。个人使用可以随意填写一个工作室或团队名称。
创建自建应用:进入“应用管理” → “自建” → “创建应用”。为应用起个名字,上传一个头像(比如小龙虾图标),并设置好可见范围(至少包含你自己)。
应用创建成功后,请立即记录以下三个核心参数,它们散落在不同页面:

🔒 安全警告:Secret 相当于应用密码,一旦泄露将带来安全风险。请妥善保管,切勿提交到公开的 Git 仓库中。
配置消息接收:在刚才创建的应用详情页面,找到「接收消息」模块,点击“设置 API 接收”。在设置页面,点击「随机获取」按钮,系统会生成 Token 和 EncodingAESKey。请将这两串字符保存好,下方的 URL 回调地址先留空不填。
3. OpenClaw 侧配置
这一步是打通两者连接的核心。你需要将上一步获取的参数配置到 OpenClaw 中。编辑 ~/.openclaw/openclaw.json 文件,在 channels 对象下添加 wecom-app 配置:
{
"channels": {
"wecom-app": {
"enabled": true,
"corpId": "wwxxxxxxxxxxxxxx",
"agentId": 1000002,
"secret": "你的应用Secret",
"token": "企业微信回调的Token",
"aesKey": "企业微信回调的EncodingAESKey"
}
}
}

你也可以选择使用 OpenClaw 命令行逐条进行配置,效果相同:
openclaw config set channels.wecom-app.corpId "wwxxxxxxxxxxxxxxx"
openclaw config set channels.wecom-app.agentId 1000002
openclaw config set channels.wecom-app.secret "你的应用Secret"
openclaw config set channels.wecom-app.token "企业微信回调的Token"
openclaw config set channels.wecom-app.aesKey "企业微信回调的EncodingAESKey"
openclaw config set channels.wecom-app.enabled true
# 配置完成后,重启网关
openclaw gateway restart

4. 完成企业微信回调验证
现在,回到企业微信管理后台的「接收消息」配置页面。此时,在 URL 地址栏中填写你的回调地址:
http://你的公网IP:18789/wecom/app
点击“保存”按钮。如果前面所有配置都正确,页面会立即显示“验证成功”的提示。
如果验证失败? 请按以下顺序排查:
- 确保 OpenClaw Gateway 已经重启 (
openclaw gateway restart)。
- 检查服务器防火墙或云服务商安全组是否放通了 18789 端口。
- 核对填写的
Token 和 EncodingAESKey 是否与后台生成的一致。
- 运行
openclaw logs --follow 查看实时日志,寻找错误信息。
5. 打通个人微信(关键一步)
这是让个人微信也能使用该企业应用的关键。在企业微信管理后台:
- 进入 我的企业 → 微信插件。
- 使用你的个人微信扫描页面上的二维码。
- 关联成功后,你的个人微信会收到来自企业微信的通知。
完成以上步骤后,在你的微信 通讯录 → 我的企业 中,就能找到刚刚创建的应用入口。发送一条消息测试,如果能收到 OpenClaw 的回复,则说明从个人微信到企业微信,再到 OpenClaw 的全链路已成功打通。
方案三:第三方协议(仅供学习研究)
⚠️ 风险提示:此方案通过模拟微信客户端登录的第三方协议实现,存在明确的微信账号封禁风险。仅供技术学习与研究,强烈建议使用备用小号进行测试。
社区中存在如 openclaw-wechat 这类开源项目,提供了绕过官方接口的个人微信直连能力。其配置方式通常如下:
openclaw config set channels.wechat.apiKey "wc_live_xxxxxxxxxxxxxxxx"
openclaw config set channels.wechat.proxyUrl "http://你的代理:3000"
openclaw config set channels.wechat.webhookHost "你的服务器公网IP"
openclaw config set channels.wechat.enabled true
openclaw gateway restart

项目首次启动时,通常会显示一个登录二维码,使用微信扫码即可登录。但必须再次强调:此方案稳定性差,且封号风险高,非必要不推荐使用。
五个场景看 ClawBot 如何协同工作
光说“能聊天”可能有些抽象。微信接入 OpenClaw 的真正价值,在于它如何无缝融入并串联起你的日常工作流。就像我们上篇讲的五个文件(SOUL.md, BRAIN.md等)需要协同工作一样,不同的生活与工作场景也能被它串联起来。
假设你是一名团队负责人,让我们看看微信里的 ClawBot 如何陪你度过高效的一天。
场景一:早上 8:30 · 通勤路上信息处理
你在地铁上刷到一篇行业深度分析文章,觉得很有价值,随手就转发给了微信里的 ClawBot。
- 以前的你:点击收藏 → 文章在收藏夹吃灰 → 三个月后翻到 → “这啥?当时为啥收藏来着?”
- 现在的你:ClawBot 调用其集成的 Chrome DevTools MCP 工具打开链接,读取全文,30秒后给你回复——包含三句话核心摘要,并指出该文章观点与你上周让它整理的竞品分析报告中的第三点高度关联。在你到达公司前,这篇文章的精华已被自动归档到你的知识库。
关键能力:ClawBot 不只是“读取”,它有上下文记忆。它能关联你之前交代的任务,让信息处理不再是孤立的动作。
场景二:上午 10:00 · 移动端快速合同初审
同事在微信项目群里丢了一份合同 PDF,@你让你帮忙看看条款。你正在开会,不想打开电脑。
你直接将 PDF 文件转发给 ClawBot,并附上指令:
“帮我看一下这份合同,重点关注付款条款和违约责任,列出所有可能存在风险的地方。”
两分钟后,ClawBot 回复了一份结构清晰的风险点清单。你在手机上快速浏览,发现第7条的违约金比例确实约定过高,于是直接在微信群里回复了同事。
你没有打开电脑,没有下载文件,没有切换任何应用。这件事,从头到尾在微信里完成了。
场景三:下午 2:00 · 会议间隙快速同步
项目群里上午讨论激烈,消息早已99+。你刚开完另一个会,根本没时间爬楼。
你给 ClawBot 发去指令:
“帮我看一下‘xxx项目群’今天上午的所有讨论,整理成一份待办事项清单,并标注每条是谁提出的。”
很快,ClawBot 回复了一份按提出人分组的待办列表。你扫一眼就发现,设计师提出的三个界面需求你还没回应,于是立刻在群里@她进行对接。
这里的细节在于:如果你在上一篇教程中配好了 TOOL.md,ClawBot 会智能地知道“整理群聊消息”该调用消息读取工具,“生成待办清单”该调用文件写入工具。Agent 基础设置的质量,直接决定了这类复杂串联任务的执行效果。
场景四:傍晚 6:00 · 基于上下文的周报生成
下班前,你需要给老板发一封本周工作汇报邮件,但实在懒得动笔。
你对 ClawBot 说:
“根据这周我和你的所有聊天记录,帮我起草一封发给老板的周报邮件。重点突出本周完成的合同审核工作和项目A的推进情况。”
ClawBot 会自动回溯本周的对话上下文,知道你审核了哪份合同、项目群里的待办推进到了什么阶段,并据此生成一封语气得当的邮件草稿发给你。你只需略作修改,即可转发给老板。
⚠️ 注意:如果你在 SOUL.md 中明确写了“所有对外发送的内容必须经过我本人确认”,那么 ClawBot 绝不会直接发送邮件——它只会生成草稿等你确认。这就是预先定义的“价值观”在起作用。
场景五:晚上 9:00 · 灵感突发的快速创作
你突然想起明天上午有个客户拜访,急需一份最新的产品介绍PPT。
你把半年前做过的旧版 PPT 发给 ClawBot,并下达指令:
“基于这个PPT的原有结构,更新里面的所有业务数据,替换为最新的产品参数。整体风格希望更活泼一些,用于明天给客户展示。”
你去洗个澡,回来时发现 ClawBot 已经将生成好的新版 PPT 文件发到了聊天窗口。
发现了吗? 在这五个贯穿整天的场景里,你没有主动打开过任何一个所谓的“AI应用”。所有交互都自然而然地发生在微信里——这个你每天必然会打开数十次的地方。
这就是微信接入与其他方案最本质的区别。飞书接入像是“多了一个机器人同事”,而微信接入则让“你的AI助手住进了你的日常生活”。
实操中最容易踩的四个坑
坑一:配置顺序错误
- ❌ 错误顺序:先在企业微信后台填写了回调 URL → 点击保存导致验证失败。
- ✅ 正确顺序:先在 OpenClaw 中完整配置好
wecom-app 通道并重启 Gateway → 再去企业微信后台填写回调 URL 并保存。
核心:企业微信在保存URL的瞬间就会发送验证请求。如果你的 OpenClaw 还没准备好接收,验证必然失败。
坑二:网络端口不通
OpenClaw 配置好了,企业微信回调URL也填了,但就是验证不过。90%的问题出在网络上。请确保:
- 你的云服务器安全组规则已放行 18789 端口(TCP)。
- 服务器本地的防火墙(如
ufw 或 firewalld)也放行了该端口。
坑三:个人微信无法使用
企业微信里测试应用可以正常收发消息,但个人微信里没反应。请检查:
- 是否在企业管理后台的「微信插件」页面,用个人微信完成了扫码关联?
- 创建应用时设置的「可见范围」,是否确实包含了你的企业微信账号(即你自己)?
坑四:参数混淆填错
CorpID、AgentId、Secret、Token、AESKey——这五个参数分别来自“我的企业”和“应用详情”两个页面,极易混淆。建议获取一个,就立即填写一个,不要全部复制到最后再统一填写,很容易张冠李戴。
结语
微信接入 OpenClaw,其深远意义不在于技术实现有多么复杂,而在于它成功地将 AI 助手的能力,无缝融入了我们最高频的日常沟通场景。它不再是一个需要你特意去打开、去想起的独立应用,而是变成了你微信聊天列表里那个随时待命、触手可及的智能伙伴。无论你选择原生的 ClawBot,还是稳定的企业微信方案,都意味着你的工作流将迎来一次显著的效率提升。对于更多深入的技术讨论和开源项目实践,欢迎到 云栈社区 的开源实战板块交流探索。
下一篇预告:OpenClaw 十问十答——从行业热议到巨头纷纷布局,关于 OpenClaw 大家最关心的10个核心问题,一次为你讲清。