OpenClaw 接入企业微信机器人超详细图文教程
前置准备
- 本地已安装 OpenClaw Windows 客户端，可正常启动运行
- 保持 OpenClaw 顶部 Gateway 服务处于在线正常状态
- 电脑端已安装并登录企业微信客户端
- 当前企业微信账号具备新建、管理智能机器人权限
- 提前准备可用的企业微信个人账号或内部群聊，用于后期消息测试验证
一键安装包下图地址栏
图文配置步骤
步骤 1：进入企业微信工作台 打开智能机器人
打开企业微信电脑客户端，点击左侧工作台 ，在应用列表中找到并进入智能机器人功能。
步骤 2：新建智能机器人
进入智能机器人页面，左侧默认选中「创建」栏目，点击页面中央创建机器人按钮。
步骤 3：填写场景描述并完成创建
弹出创建弹窗，场景描述可按需自定义填写，也可留空不填，直接点击右下角创建即可。
步骤 4：进入编辑页面 修改机器人资料
机器人创建完成自动进入详情页面，点击机器人名称旁的编辑按钮，准备设置头像、名称与简介。
步骤 5：配置机器人头像、名称和简介
在编辑弹窗中依次完成设置：
- 上传自定义机器人头像
- 设置机器人对外展示名称
- 填写功能简介说明全部设置完成后点击确定保存。
步骤 6：切换至 API 模式接入方式
返回机器人配置页面，滚动页面至底部，点击API 模式创建，后续将通过 Bot ID 和 Secret 完成与 OpenClaw 的对接。
步骤 7：选择长连接方式并获取密钥
进入 API 配置界面：
- 连接方式选择使用长连接
- 在 Secret 栏目点击点击获取 记录页面展示的 Bot ID 和 Secret，这是渠道对接核心参数。
步骤 8：展开全部权限列表
下滑找到「可使用权限」板块，点击右上角展开按钮，进入完整权限授权页面。
步骤 9：一键全部授权
在权限授权页面滚动至最底部，点击全部授权，一次性开通机器人所需全部接口权限。
步骤 10：确认授权完成
页面弹出全部授权成功提示，即代表权限配置完成，返回上一级页面继续操作。
步骤 11：确认权限已授权并保存
回到 API 配置主页，核对所有权限均显示已授权 ，确认无误后点击页面底部保存。
步骤 12：重新进入 API 配置查看参数
保存完成回到机器人详情页，再次点击API 配置，准备复制对接所需参数。
步骤 13：复制 Bot ID 和 Secret
在 API 配置页面，完整复制：
- Bot ID
- Secret妥善保存两组参数，后续需要填入 OpenClaw 企业微信渠道配置中。
步骤 14：OpenClaw 进入聊天配置 安装企业微信插件
切回 OpenClaw 客户端：
- 点击右上角设置
- 进入左侧聊天配置
- 找到 企业微信（WeCom） 配置卡片若页面显示安装插件，先点击完成插件部署，再进行参数填写。
步骤 15：粘贴参数并保存渠道配置
将从企业微信后台复制的参数一一对应填入：
- Bot ID
- Secret开启渠道启用开关，点击右上角保存渠道配置。
步骤 16：进入机器人使用页面
回到企业微信机器人详情页，点击右上角去使用。
步骤 17：发起聊天准备测试
进入机器人主页后，点击发消息，进入一对一聊天窗口。
步骤 18：发送消息验证接入成功
在聊天窗口发送测试语句，例如：你好。若机器人可以正常自动应答，说明企业微信已成功接入 OpenClaw，整套配置完成。
接入完成自检清单
- 已在企业微信成功新建智能机器人
- 已切换为 API 模式创建方式
- 连接方式已选定使用长连接
- 完整获取并备份 Bot ID、Secret
- 机器人全部接口权限已完成授权
- OpenClaw 企业微信渠道插件安装完毕
- Bot ID 与 Secret 粘贴无误、无多余空格
- 已手动保存 OpenClaw 渠道配置
- 可正常给机器人发消息并收到自动回复
常见问题解答
1. 企业微信渠道为什么提示需要安装插件？
企业微信接入依赖专属插件支撑，如果本地环境未预装，会自动提示安装，直接点击安装即可正常使用。
2. OpenClaw 需要填写哪两个参数？
直接对应企业微信 API 配置页面生成的：Bot ID、Secret，原样填入对应输入框即可。
3. 为什么必须执行全部授权？
权限缺失会导致机器人无法接收消息、无法调用 AI 能力、无法正常回复。一键全部授权可规避权限缺失带来的各类异常。
4. 配置保存后机器人不回复怎么排查？
按顺序逐项检查：
- OpenClaw 顶部 Gateway 是否在线
- 企业微信插件是否安装成功
- Bot ID、Secret 是否复制完整无空格
- API 配置是否选定长连接模式
- 所有权限是否已授权完成
- 是否在 OpenClaw 内保存渠道配置仍异常可重启 OpenClaw 或 Gateway 服务后重新测试。
参考地址
企业微信官方平台：https://work.weixin.qq.com/
openclaw一键部署如下图：
