一、前置准备

在正式接入配置前，需提前完成以下准备工作，规避配置报错、功能异常等问题：

1. 已安装OpenClaw Windows版本，且软件可正常启动运行；

2. OpenClaw顶部Gateway状态显示在线，无离线、异常提示；

3. 电脑端已安装并正常登录企业微信客户端；

4. 当前登录的企业微信账号，拥有智能机器人的创建与管理权限；

5. 准备可用的企业微信测试账号或测试群聊，用于后续消息回复功能验证。

二、详细图文配置步骤

步骤1：进入企业微信工作台，打开智能机器人功能

启动企业微信客户端，点击左侧导航栏的【工作台】，在应用列表中找到并点击【智能机器人】功能入口。

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

进入智能机器人页面后，左侧默认选中【创建】选项，直接点击页面核心位置的【创建机器人】按钮，开始新建机器人。

步骤3：填写场景信息并完成创建

弹出机器人创建弹窗后，场景描述可根据自身需求自定义填写，也可直接留空。确认无误后，点击右下角【创建】按钮，生成全新机器人。

步骤4：进入编辑页面，准备修改机器人基础信息

机器人创建完成后，自动跳转至详情页面。点击机器人名称右侧的编辑图标，进入信息编辑界面，用于后续修改头像、名称、简介等基础信息。

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

在弹出的编辑窗口中，完成三项基础配置：

1. 上传自定义机器人头像；

2. 设置贴合使用场景的机器人名称；

3. 填写对应的机器人功能简介。

全部信息设置完成后，点击【确定】保存修改。

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

返回机器人详情主页面，向下滚动页面至底部，点击【API模式创建】。本次接入需通过Bot ID和Secret参数实现企业微信机器人与OpenClaw的联动，必须选择该模式。

步骤7：选择长连接方式，获取Secret参数

进入API配置页面后，完成两项核心设置：

1. 连接方式选择【使用长连接】，保障消息稳定传输；

2. 在Secret参数栏，点击【点击获取】生成密钥。

此处生成的Bot ID和Secret，是OpenClaw接入配置的核心参数，需妥善留存。

步骤8：展开全部权限列表

在API配置页面向下滑动，找到【可使用权限】模块，点击页面右上角的展开按钮，进入完整权限授权页面。

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

在权限授权弹窗中，滚动页面至最底部，点击【全部授权】按钮，一次性开通机器人所需的所有权限，避免后续功能缺失。

步骤10：确认授权成功

权限授权完成后，页面顶部会弹出【全部授权成功】提示，确认该提示出现后，返回上一级配置页面。

步骤11：保存API权限配置

返回API配置主页面，核对所有权限均显示为【已授权】，确认配置无误后，点击页面底部【保存】按钮，固化权限设置。

步骤12：重新进入API配置，获取核心参数

保存完成后自动返回机器人详情页，再次点击【API配置】选项，进入参数展示页面，准备复制接入所需参数。

步骤13：复制留存Bot ID和Secret

在API配置页面，分别复制页面展示的【Bot ID】和【Secret】两个参数，单独保存备用，后续需填入OpenClaw配置界面。

步骤14：OpenClaw安装企业微信插件

打开OpenClaw软件，进行渠道配置准备：

1. 点击软件右上角【设置】；

2. 左侧菜单栏选择【聊天配置】；

3. 找到【企业微信（WeCom）】配置项；

4. 若页面显示【安装插件】按钮，点击安装企业微信专属插件，等待安装完成。

步骤15：填入参数并保存渠道配置

将此前从企业微信复制的Bot ID、Secret参数，对应粘贴到OpenClaw企业微信配置的输入框中，填写完成后，点击右上角【保存渠道配置】。

步骤16：进入机器人使用页面

参数配置保存完成后，返回企业微信机器人详情页，点击右上角【去使用】按钮，进入机器人聊天交互页面。

步骤17：发送测试消息验证功能

点击页面【发消息】按钮，进入聊天窗口，向机器人发送测试消息，例如“你好”，验证机器人响应状态。

步骤18：确认接入成功

若机器人可以正常回复测试消息，无超时、无响应、报错等问题，即代表企业微信机器人已成功接入OpenClaw，全部配置完成。

三、接入完成自检清单

配置完成后，可对照以下清单逐一核对，规避隐性问题：

1. 已在企业微信客户端成功创建智能机器人，基础信息配置完整；

2. 机器人已切换为API创建模式，非默认模式；

3. API配置已选择【使用长连接】传输方式；

4. 已成功获取并完整留存Bot ID、Secret参数；

5. 机器人所有可用权限已完成全部授权；

6. OpenClaw企业微信专属插件已安装完毕；

7. Bot ID和Secret参数已准确填入OpenClaw配置界面；

8. 已点击保存OpenClaw渠道配置，参数生效；

9. 完成消息测试，机器人可正常回复消息。

四、常见问题解决方案

1、OpenClaw企业微信渠道显示“安装插件”怎么办？

企业微信渠道接入依赖专属插件 @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渠道配置已点击保存并生效；

7. 上述配置均无误时，可重启OpenClaw后重新测试。

五、参考链接

1、企业微信官网：https://work.weixin.qq.com/

2、OpenClaw工具获取：http://b.m6z.cn/hayK4