保姆级教程!OpenClaw 对接企业微信,Bot/Agent 双模式配置一次搞定

AI 知识库13小时前发布
736 0 0
熊猫办公
大家好,我是墨香异境。
好不容易把 OpenClaw 装好用飞书当交流通道,结果突然收到 API 额度预警,当月额度用掉 90%,眼看专属 AI 助理就要 “罢工”?
保姆级教程!OpenClaw 对接企业微信,Bot/Agent 双模式配置一次搞定
别急!亲测有效的OpenClaw 集成企业微信教程来了,不管是想一键快速部署的懒人党,还是想自定义配置的技术党,这篇保姆级攻略都能满足你,手把手教你把 OpenClaw 搬到企业微信,继续享受 24 小时在线的智能助理服务。
先给大家看一眼集成后的效果,和飞书端体验无差。
保姆级教程!OpenClaw 对接企业微信,Bot/Agent 双模式配置一次搞定

一、接入方式

OpenClaw 集成企业微信分两种接入方式,新手选第一种,一键部署零配置;技术党选第二种,自定义部署更贴合企业需求,大家按需冲!

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

直接购买腾讯云轻量云服务器,平台已做专属适配,支持企业微信、QQ、钉钉、飞书四大IM一键对接,秒级部署无需复杂配置,24 小时在线响应,还提供环境隔离保护本地数据,新手闭眼入就行。
保姆级教程!OpenClaw 对接企业微信,Bot/Agent 双模式配置一次搞定

方式 2:自行部署 OpenClaw + 安装企业微信插件(自定义首选)

自己先完成 OpenClaw 基础部署,再安装企业微信专属插件即可,目前有两个插件可选:@yanhaidao/wecom(本文主推,适配性更好)、@openclaw-china/channels,后续配置均以第一个插件为例。

二、核心配置教程:Bot/Agent 双模式,一步步教你配2.1 云上部署方式

企业微信配置分云上部署和自定义部署,云上部署直接参考腾讯云官方文档:https://cloud.tencent.com/developer/article/2625147
重点给大家讲自定义部署的两个核心模式 ——Bot 模式(智能机器人)、Agent 模式(自建应用),覆盖 90% 的使用场景

2.2 自定义部署方式 目前发现有两个插件可以使用,大家可以自行选择,本文使用的是第一个,地址在文章结尾处。

1. @yanhaidao/wecom 2. @openclaw-china/channels

不同模式的说明:

保姆级教程!OpenClaw 对接企业微信,Bot/Agent 双模式配置一次搞定

2.2.1 安装插件 使用以下命令安装,有时候会安装失败。直接把安装命令丢给OpenClaw,让它进行安装。

openclawplugins install@yanhaidao/wecom

2.2.2 Bot模式(智能机器人)

  1. 登录 企业微信管理后台
  2. 进入「安全与管理」→「管理工具」→「智能机器人」
保姆级教程!OpenClaw 对接企业微信,Bot/Agent 双模式配置一次搞定

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

保姆级教程!OpenClaw 对接企业微信,Bot/Agent 双模式配置一次搞定
保姆级教程!OpenClaw 对接企业微信,Bot/Agent 双模式配置一次搞定

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

保姆级教程!OpenClaw 对接企业微信,Bot/Agent 双模式配置一次搞定

注意:此处先不用点击“保存”按钮。否则,会报错提示“服务没有正确响应,请确认后重试”。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 模式(自建应用)

  1. 登录 企业微信管理后台
  2. 进入「应用管理」→「自建」→ 创建应用
保姆级教程!OpenClaw 对接企业微信,Bot/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" ], } }}

四、写在最后

其实 OpenClaw 集成企业微信一点都不复杂,核心就是选对接入方式、配好关键参数、避开实操坑
插件地址:

1. https://github.com/YanHaidao/wecom2. https://github.com/BytePioneer-AI/openclaw-china

如果你觉得这篇文章对你有帮助,欢迎点赞、在看、转发,让更多人受益!

如果配置过程中遇到其他问题,评论区留言,一起交流解决~,或者加群交流。

学习交流群:创建了一个学习交流群,欢迎大家加入一起学习。加入方法:关注->点击“关于我”->添加微信(备注:入群交流)->添加入群。

© 版权声明

相关文章