企业微信智能机器人长连接搭建搭配 OpenClaw 参数填写手册（含安装包）

OpenClaw 2.7.9 连接企业微信完整实操教程

前置准备事项

1. 本地完成 Windows 端 OpenClaw 2.7.9 安装，程序能够正常启动运行，安装包大小 45.8MB Windows 端安装包下载链接：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
2. 苹果系统安装包下载链接：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
3. 确保 OpenClaw 顶部 Gateway 运行标识处于在线状态，不存在离线故障
4. 设备安装企业微信客户端，且已完成账号登录操作
5. 当前登录的企业微信账号拥有智能机器人创建、管理相关操作权限
6. 准备企业内部群聊或测试账号，用于后期校验机器人消息回复能力

分步操作流程

步骤 1：在企业微信工作台找到智能机器人功能入口

打开本地企业微信客户端，点击左侧导航栏工作台板块，在应用列表内找到智能机器人功能并点击进入。

步骤 2：发起机器人新建流程

进入智能机器人管理页面，左侧菜单栏选中创建分类，点击页面内创建机器人按钮，开启机器人搭建流程。

步骤 3：完善基础场景备注后完成创建

弹出新建配置弹窗，场景描述内容可按需填写，无特殊需求也可留空，填写完毕点击右下角创建按钮生成机器人。

步骤 4：进入资料编辑界面调整机器人基础信息

机器人创建完成会自动跳转详情页面，点击机器人名称旁编辑按键，即可自定义头像、名称等展示信息。

步骤 5：自定义机器人头像、名称与简介内容

在弹出的编辑弹窗中，按需设置机器人头像、对外展示名称与简介文案，全部调整完成后点击确定保存修改。

步骤 6：切换至 API 对接创建模式

返回机器人详情页面，滑动页面至底部区域，选择 API 模式创建选项，后续会依靠 Bot ID 与密钥完成和 OpenClaw 的对接工作。

步骤 7：选定长连接模式并获取专属密钥

跳转至 API 配置页面，连接方式选择使用长连接，在密钥栏目点击获取按钮，页面生成的 Bot ID 与 Secret 参数需要留存备用。

步骤 8：展开完整权限管理面板

页面下滑定位至可使用权限区域，点击右上角展开控件，打开全部权限授权弹窗。

步骤 9：一键完成全部权限授予

在权限授权弹窗内滑动至页面最底端，点击全部授权按键，一次性开通机器人运行所需的各类操作权限。

步骤 10：核对授权完成提示

权限批量授予完毕后，页面顶部会弹出全部授权成功提示，确认提示出现后再返回上一级页面保存设置。

步骤 11：确认权限状态并保存 API 配置

回到 API 配置主页面，逐项核对所有权限状态均显示已授权，确认无遗漏后点击页面底部保存按钮。

步骤 12：调取 API 配置页面复制对接参数

保存设置后跳转机器人主页，点击 API 配置选项，页面内会展示对接所需的两组核心参数。

步骤 13：复制 Bot ID 与密钥妥善留存

在 API 配置界面分别复制 Bot ID、Secret 两组参数，单独保存记录，后续需要填入 OpenClaw 对应配置栏。

步骤 14：打开 OpenClaw 聊天配置板块安装配套插件

切换至 OpenClaw 软件界面执行以下操作：

1. 点击软件右上角设置入口
2. 左侧菜单栏选择聊天配置分类
3. 找到企业微信（WeCom）配置卡片
4. 若页面展示安装插件按钮，优先完成插件部署，再填写对接参数

步骤 15：粘贴参数并保存渠道配置

将企业微信后台复制的 Bot ID、Secret 分别填入对应输入框，参数填写完成后点击右上角保存渠道配置。

步骤 16：回到机器人页面进入交互测试界面

参数保存完毕后，切回企业微信机器人详情页，点击页面右上角去使用按钮进入对话页面。

步骤 17：发起对话发送测试消息

进入机器人交互界面，点击发消息功能，即可向当前机器人发送测试文本校验连通状态。

步骤 18：校验机器人自动回复效果

在聊天窗口发送测试语句，例如 “你好”，机器人正常输出应答内容即代表 OpenClaw 与企业微信渠道对接成功。

接入完成自检核对清单

1. 在企业微信客户端成功完成智能机器人新建操作
2. 机器人搭建选用 API 创建模式
3. 连接模式选定使用长连接选项
4. 完整复制 Bot ID 与 Secret 两组参数并妥善保存
5. 机器人运行所需全部权限完成批量授权
6. OpenClaw 端企业微信配套插件安装完成
7. Bot ID 与密钥准确填入 OpenClaw 对应输入框
8. 执行保存渠道配置操作
9. 在企业微信内发送测试消息，机器人可正常反馈回复内容

常见问题排查方案

1. 企业微信渠道页面出现安装插件按钮是什么原因？

企业微信交互渠道依赖插件 @wecom/wecom-openclaw-plugin，软件未部署该插件时页面会弹出安装提示，直接点击安装等待部署完成即可。

2. OpenClaw 配置栏需要填写哪两组参数？

参数来源于企业微信机器人 API 配置页面，分别为 Bot ID、Secret，对应 OpenClaw 企业微信渠道的两组输入框。

3. 权限必须选择全部授权的原因是什么？

权限缺失会造成机器人无法读取对话消息、调用对应功能、输出回复内容，直接选择全部授权能够规避各类功能异常问题。

4. 参数保存后机器人依旧无法回复消息处理办法

按照顺序逐项排查以下内容：

1. OpenClaw 顶部 Gateway 是否处于在线状态
2. 企业微信配套插件是否完整安装
3. Bot ID 与 Secret 复制无遗漏、无多余空格符号
4. 企业微信 API 配置内是否选定使用长连接模式
5. 机器人全部权限是否完成授权
6. 参数修改后是否执行保存渠道配置操作 排查完毕仍异常可重启 OpenClaw 软件后重新测试对话功能。

参考访问地址

企业微信官方站点：https://work.weixin.qq.com/