附完整避坑指南 | 全程安全无黑科技

微信是全民APP, 日活超13亿。如果你的AI助手能直接在微信里用, 那体验感直接拉满。

今天这篇, 手把手教你把OpenClaw(小龙虾)接入个人微信。方案很干净 - 通过企业微信的微信插件, 完全合法合规, 没有任何封号风险。

一、实现原理: 企微微信插件

核心思路很简单:

OpenClaw -> 企业微信自建应用 -> 微信插件 -> 个人微信

企业微信自带一个"微信插件"功能。只要你关注了这个插件, 企业微信里的应用消息就能直接推送到个人微信里。这是腾讯官方提供的能力, 不需要root、不需要hook、不需要任何黑科技。

所用核心插件是 @openclaw-china/wecom-app, 支持企业微信自建应用的完整能力。

二、前置准备: 版本升级(重要!)

这一步是重中之重。旧版本OpenClaw存在回调验证的bug, 会导致企业微信配置回调地址时报错 "openapi回调地址请求不通过"。很多人卡在这一步卡了一整天。

先检查版本:

openclaw --version

确保升级到最新版本:

openclaw update

三、安装企微应用插件

在云服务器上执行:

openclaw plugins install @openclaw-china/wecom-app

安装完成后, 插件就准备好了。

四、配置OpenClaw允许公网访问

编辑 /root/.openclaw/openclaw.json, 做以下修改:

• mode
   改为 local
• bind
   改为 lan
• allowedOrigins
   改为 http://你的公网IP:18789
• allowInsecureAuth
   改为 true
• dangerouslyDisableDeviceAuth
   改为 true

保存后重启网关:

openclaw gateway restart

五、创建企业微信自建应用

登录 企业微信管理平台, 进入"应用管理", 点击"创建应用", 填写应用名称和介绍即可。

创建完成后, 记录下应用页面的 AgentId。

六、配置OpenClaw接入企微

需要依次配置以下参数, 每一个都从企微管理后台获取:

1. 获取企业ID (Corp ID)

企微管理后台 -> "我的企业" -> 最下方的企业ID

openclaw config set channels.wecom-app.corpId 你的企业ID

2. 获取应用Secret

应用管理 -> 点击Secret旁的"查看" -> 按提示在企微客户端确认查看

openclaw config set channels.wecom-app.corpSecret 你的Secret

3. 配置AgentId

openclaw config set channels.wecom-app.agentId 你的AgentId

4. 生成Token和AES Key

在应用页面找到"接收消息" -> "设置API接收" -> 点击"生成"Token和EncodingAESKey

openclaw config set channels.wecom-app.token 你的Tokenopenclaw config set channels.wecom-app.encodingAESKey 你的AESKey

5. 启用插件并重启

openclaw config set channels.wecom-app.enabled trueopenclaw config set channels.wecom-app.webhookPath /wecom-appopenclaw gateway restart

七、配置企微回调地址

回到企微应用管理页面, 在"设置API接收"中填入回调URL:

http://你的服务器公网IP:18789/wecom-app

同时在"企业可信IP"中填入你的服务器公网IP。

保存后, 如果提示"openapi回调地址请求不通过", 请回看第二步确认版本是否已升级到最新。

八、微信中启用并测试

最后一步, 在企微管理平台找到"微信插件"页面, 用微信扫描"邀请关注"的二维码。关注后, 微信中会出现企业微信入口, 你创建的应用就在里面。

打开应用, 发条消息试试 - 你的AI助手已经在微信里待命了。

避坑总结

整个过程不需要任何hack手段, 全程走的是腾讯官方的企业微信生态。配置完成后, 你就能在微信里直接和你的OpenClaw对话了 - 随时随地, 不受平台限制。

关于openclaw配套资料

私信 zh-an-gh获取openclaw配套资料，内容不定期持续更新。

- END -