OpenClaw 接入企业微信机器人超详细图文教程

前置准备

1. 本地已安装 OpenClaw Windows 客户端，可正常启动运行
2. 保持 OpenClaw 顶部 Gateway 服务处于在线正常状态
3. 电脑端已安装并登录企业微信客户端
4. 当前企业微信账号具备新建、管理智能机器人权限
5. 提前准备可用的企业微信个人账号或内部群聊，用于后期消息测试验证

一键安装包下图地址栏

图文配置步骤

步骤 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 客户端：

1. 点击右上角设置
2. 进入左侧聊天配置
3. 找到 企业微信（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. 配置保存后机器人不回复怎么排查？

按顺序逐项检查：

1. OpenClaw 顶部 Gateway 是否在线
2. 企业微信插件是否安装成功
3. Bot ID、Secret 是否复制完整无空格
4. API 配置是否选定长连接模式
5. 所有权限是否已授权完成
6. 是否在 OpenClaw 内保存渠道配置仍异常可重启 OpenClaw 或 Gateway 服务后重新测试。

参考地址

企业微信官方平台：https://work.weixin.qq.com/

openclaw一键部署如下图：