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

📦 安装包大小：45.8MB

💻 Windows 客户端下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

🍎 Mac 苹果系统下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

📋 前置准备清单

操作前请确认全部条件满足，避免配置中途报错：

1. 本地设备已部署 OpenClaw 2.7.9 Windows 客户端，软件可正常启动运行
2. OpenClaw 顶部 Gateway 网关状态保持在线
3. 电脑安装企业微信 PC 客户端并完成账号登录
4. 当前登录企微账号具备智能机器人创建、权限管理操作权限
5. 准备测试账号或内部群聊，配置完成后用来验证消息收发效果

---

🔧 分步图文操作流程

步骤 1：企微工作台打开智能机器人入口

打开企业微信 PC 客户端，点击左侧导航栏【工作台】，在应用列表内找到并点击【智能机器人】

步骤 2：发起新建机器人操作

页面左侧分类保持选中【创建】，点击页面中央【创建机器人】按钮，进入机器人基础配置弹窗

步骤 3：填写基础描述完成创建

弹出创建窗口，场景描述可按需填写内容，也可直接空白不填，确认后点击右下角【创建】

步骤 4：进入机器人信息编辑页面

机器人创建成功后自动跳转详情页面，点击机器人名称右侧编辑图标，准备修改对外展示信息

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

在弹出的编辑弹窗中完成三项配置：

• 上传自定义机器人头像
• 设置机器人对外展示名称
• 补充机器人功能简介 全部内容填写完毕，点击【确定】保存修改

步骤 6：切换 API 对接模式

返回机器人详情页面，滑动页面至底部区域，点击【API 模式创建】，该模式用于打通 OpenClaw 程序对接通道

步骤 7：选择长连接，获取 Bot ID 与 Secret 凭证

进入 API 配置页面执行两项操作：

1. 连接方式勾选【使用长连接】
2. Secret 输入栏点击【点击获取】 页面生成的 Bot ID、Secret 是对接核心参数，后续需要完整复制填入 OpenClaw 配置面板

步骤 8：展开完整权限配置面板

下滑页面找到【可使用权限】板块，点击板块右上角展开按钮，打开全部权限授权弹窗

步骤 9：一键批量授予全部接口权限

在权限弹窗内滑动至页面最底端，点击【全部授权】按钮，一次性开放机器人所需全部接口调用权限

步骤 10：确认权限授权生效

页面顶部弹出「全部授权成功」提示文字，代表权限配置已生效，关闭弹窗回到 API 配置主页面

步骤 11：校验权限状态并保存配置

回到 API 配置页面，逐项核对所有权限均显示「已授权」标识，确认无误后点击页面底部【保存】

步骤 12：重新打开 API 配置复制参数

保存完成跳转机器人详情页，点击【API 配置】入口，准备复制对接所需的两组凭证

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

在 API 配置页面分别复制两组参数：

1. Bot ID
2. Secret 复制完成后单独保存，下一步填入 OpenClaw 企微渠道配置栏

步骤 14：打开 OpenClaw 安装企业微信对接插件

切换至 OpenClaw 客户端进行配置：

1. 点击软件右上角【设置】
2. 左侧菜单栏选择【聊天配置】
3. 在渠道列表找到【企业微信（WeCom）】
4. 若页面显示【安装插件】按钮，先完成插件部署，插件名称为 @wecom/wecom-openclaw-plugin 插件安装完成后再进行参数填写

步骤 15：粘贴凭证并保存渠道配置

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

步骤 16：返回企微机器人页面进入使用界面

参数保存完毕，切回企业微信机器人详情页面，点击页面右上角【去使用】

步骤 17：发起测试消息验证通道连通

进入机器人对话页面，点击【发消息】，打开和当前机器人的私聊窗口

步骤 18：测试消息校验接入结果

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

---

✅ 接入完成自检核对清单

配置结束后逐项核对，避免遗漏步骤导致功能异常：

• 企业微信客户端已成功创建智能机器人
• 机器人切换至 API 对接模式
• API 连接方式选择使用长连接
• Bot ID、Secret 完整复制保存无遗漏
• 机器人全部调用权限完成批量授权
• OpenClaw 客户端企微插件部署完成
• Bot ID 与 Secret 准确粘贴至配置框，无多余空格字符
• 渠道配置页面点击保存完成更新
• 企微私聊机器人发送测试消息，可正常接收回复

---

❓ 常见问题排查指南

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

OpenClaw 对接企业微信依赖配套插件 @wecom/wecom-openclaw-plugin，软件未安装该插件时页面会展示安装入口，直接点击安装等待部署完成即可。

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

仅需填写企业微信机器人 API 配置页面生成的 Bot ID、Secret，两组参数分别对应渠道配置内同名输入框。

3. 为什么必须执行全部授权操作？

权限未完整授予会造成机器人无法读取聊天消息、调用 AI 能力、推送应答内容等各类异常，建议直接使用一键全部授权功能，减少后期调试成本。

4. 参数保存后机器人依旧无法回复消息排查步骤

按照以下顺序逐项校验，定位故障点：

1. 查看 OpenClaw 顶部 Gateway 网关是否处于在线状态
2. 确认企业微信对接插件已完整安装
3. 核对 Bot ID、Secret 复制内容无多余空格、字符缺失
4. 检查企微 API 配置页面是否勾选使用长连接模式
5. 二次确认机器人全部接口权限已授权完成
6. 确认 OpenClaw 渠道配置点击保存生效 排查后问题未解决，可重启 OpenClaw 客户端再次测试消息收发。

---

📎 参考链接

企业微信开发者平台文档：https://work.weixin.qq.com/

 💻 Windows 客户端下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

🍎 Mac 苹果系统下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C