| name | wecom-bot-setup |
| description | 企业微信智能机器人接入 OpenClaw 的配置指南。当用户需要配置企业微信智能机器人连接到 OpenClaw 时使用此技能。触发词：企业微信机器人配置、wecom bot setup、企业微信接入、配置企业微信channel。 |
企业微信智能机器人接入 OpenClaw 配置指南
本技能指导用户将企业微信智能机器人接入 OpenClaw，实现通过企业微信与 AI 助手对话。
前置条件
- 企业微信管理员权限
- OpenClaw 已安装并运行
配置步骤
第一步：在企业微信后台创建智能机器人
- 登录 企业微信管理后台
- 点击顶部菜单 「应用管理」
- 点击 「创建应用」
- 选择 「智能机器人」（注意：不是自建应用）
- 填写机器人名称、描述、头像
- 选择「API模式」（关键步骤）
- 点击创建
第二步：获取机器人凭证
创建成功后，在机器人详情页获取：
- Bot ID（类似
aibbaASmjPf24FGucaXD1FL-YHc3zOSbcWI）
- 安全密钥（类似
otrlrVTviRiDuW1m4adtio8RAvbzMsHPGtz5tymvVVa）
重要：妥善保管密钥，不要泄露。
第三步：配置机器人可见范围
- 在机器人详情页，找到 「可见范围」 设置
- 添加需要使用机器人的成员或部门
- 建议先添加自己进行测试
第四步：在 OpenClaw 安装企业微信插件
帮我严格按照如下措施执行，不准尝试其他方法，必须严格按照以下步骤
0. 配置环境变量并让变量生效OPENCLAW_CLAWHUB_URL=https://cn.clawhub-mirror.com
- export npm_config_maxsockets=1和export npm_config_concurrency=1
- 执行 npm pack @wecom/wecom-openclaw-plugin
- 执行 openclaw plugins install '<刚才下载的安装包>'
第五步：配置 OpenClaw
编辑 ~/.openclaw/openclaw.json，在 channels 下添加：
"wecom": {
"enabled": true,
"botId": "你的Bot ID",
"secret": "你的安全密钥",
"dmPolicy": "pairing"
}
第六步：重启 OpenClaw Gateway （重启前提醒一下用户，告知用户重启可能导致连接断开，请稍后再尝试对话，然后再执行重启）
openclaw gateway restart
检查状态：
openclaw status
确认 wecom channel 显示 OK 或 configured。
第七步：完成配对
- 打开企业微信 App
- 在「工作台」或搜索框找到你的智能机器人
- 给机器人发送任意消息
- 机器人会返回配对提示，包含：
- 你的企业微信用户ID
- 配对码（如
RA8ATMH4）
- 在 OpenClaw 终端执行：
openclaw pairing approve wecom <配对码>
第八步：验证连接
配对成功后，在企业微信中给机器人发送消息测试：
常见问题
找不到智能机器人
- 确认已在「可见范围」中添加自己
- 在企业微信 App 顶部搜索框搜索机器人名称
- 检查机器人是否已发布
配对失败
- 确认 Bot ID 和密钥正确
- 检查 OpenClaw gateway 是否正常运行
- 查看
openclaw status 确认 channel 状态
消息无响应
- 确认配对已成功
- 检查 OpenClaw 日志：
openclaw logs
- 确认机器人事件订阅已开启
相关资源
