

一、接入方式
方式一:腾讯云轻量云服务器一键部署(懒人首选)

方式 2:自行部署 OpenClaw + 安装企业微信插件(自定义首选)
二、核心配置教程:Bot/Agent 双模式,一步步教你配2.1 云上部署方式
2.2 自定义部署方式 目前发现有两个插件可以使用,大家可以自行选择,本文使用的是第一个,地址在文章结尾处。
1. @yanhaidao/wecom 2. @openclaw-china/channels
不同模式的说明:

2.2.1 安装插件 使用以下命令安装,有时候会安装失败。直接把安装命令丢给OpenClaw,让它进行安装。
openclawplugins install@yanhaidao/wecom
2.2.2 Bot模式(智能机器人)
-
登录 企业微信管理后台 -
进入「安全与管理」→「管理工具」→「智能机器人」

3. 创建机器人,选择 API 模式


在切换后的页面,依次填写名称、简介、可见范围、URL(参考后续步骤),并且点击随机获取按钮生成Token和Encoding-AESKey(这是企业微信与OpenClaw进行加密通信的密钥)。

注意:此处先不用点击“保存”按钮。否则,会报错提示“服务没有正确响应,请确认后重试”。4. OpenClaw配置
- 一个 accountId 就是一组独立通道:
- 一组 bot(群聊/流式主通道)
- 一组路由绑定(只进同组 Agent,不跨账号)
{ "channels":{ "wecom":{ "enabled":true,// 通道总开关 "defaultAccount":"person", "accounts":{ "person":{ "enabled":true, "name":"个人助手", "bot":{ "aibotid":"BOT_OPS", "token":"BOT_TOKEN_OPS", "encodingAESKey":"BOT_AES_OPS", "receiveId":"", "streamPlaceholderContent":"正在思考...", "welcomeText":"你好,我是你的专属助手", "dm":{ "policy":"allowlist", "allowFrom":["zhangsan","lisi"] } } } } } } "bindings":[ {"agentId":"person-agent","match":{"channel":"wecom","accountId":"person"}} ]}
关键参数说明:
- aibotid:机器人的ID
- token:机器人的Token
- encodingAESKey:机器人的加密Key
- bindings.agentId:agent对应的ID
在回头看企业微信中的URL需要配置Webhook 路径(必须使用账号路径)
http://YourIP:18789/plugins/wecom/bot/{accountId}例如:http://YourIP:18789/plugins/wecom/bot/person
2.2.3 Agent 模式(自建应用)
-
登录 企业微信管理后台 -
进入「应用管理」→「自建」→ 创建应用

2. 获取 AgentId、CorpId、Secret3.在应用详情中设置「接收消息 – 设置API接收」4. 填写回调 URL:
http://YourIP:18789/plugins/wecom/bot/{accountId}例如:http://YourIP:18789/plugins/wecom/bot/person
5. 记录回调 Token 和 EncodingAESKey6. OpenClaw配置
- 一个 accountId 就是一组独立通道:
- 一组 agent(文件/超时/主动消息兜底)
- 一组路由绑定(只进同组 Agent,不跨账号)
{ "channels":{ "wecom":{ "enabled":true,// 通道总开关 "defaultAccount":"person", "accounts":{ "person":{ "enabled":true, "name":"个人助手", "agent":{ "corpId":"CORP_ID", "corpSecret":"AGENT_SECRET_OPS", "agentId":1000001, "token":"AGENT_TOKEN_OPS", "encodingAESKey":"AGENT_AES_OPS", "welcomeText":"您好,我是您的专属助手", "dm":{ "policy":"allowlist", "allowFrom":["zhangsan","lisi"] } } } } } } "bindings":[ {"agentId":"person-agent","match":{"channel":"wecom","accountId":"person"}} ]}
关键参数说明:
- corpId:企业ID
- corpSecret:在应用内找到Secret
- agentId:在应用内找到Agent ID
- token:在企业微信管理后台的应用管理详情页,找到“功能-接收消息”,点击设置API接收。
- encodingAESKey:在企业微信管理后台的应用管理详情页,找到“功能-接收消息”,点击设置API接收。
URL填写后保存。三、遇到的问题1. 企业认证情况已经认证过的企业配置的Url需要域名,且是企业备案的域名。未认证的企业需要配置公网开放地址2. OpenClaw公网发布OpenClaw默认是本地回环地址:127.0.0.1,需要修改openclaw.json文件,配置以下内容公网发布
{ "gateway":{ "bind":"lan", "controlUi":{ "allowedOrigins":[ "http://yourIp:18789" ], } }}
四、写在最后
1. https://github.com/YanHaidao/wecom2. https://github.com/BytePioneer-AI/openclaw-china
如果你觉得这篇文章对你有帮助,欢迎点赞、在看、转发,让更多人受益!
学习交流群:创建了一个学习交流群,欢迎大家加入一起学习。加入方法:关注->点击“关于我”->添加微信(备注:入群交流)->添加入群。
