# Wecom Bot Setup

> 企业微信智能机器人接入 OpenClaw 的配置指南。当用户需要配置企业微信智能机器人连接到 OpenClaw 时使用此技能。触发词：企业微信机器人配置、wecom bot setup、企业微信接入、配置企业微信channel。

- Skill: `18816132863/wecom-bot-setup-2` (Agent Skill)
- Install (CLI): `npx get-skill add 18816132863/wecom-bot-setup-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/18816132863/wecom-bot-setup-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: 18816132863 (https://skillmd.com/u/18816132863)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/18816132863/wecom-bot-setup-2

---


# 企业微信智能机器人接入 OpenClaw 配置指南

本技能指导用户将企业微信智能机器人接入 OpenClaw，实现通过企业微信与 AI 助手对话。

## 前置条件

- 企业微信管理员权限
- OpenClaw 已安装并运行

## 配置步骤

### 第一步：在企业微信后台创建智能机器人

1. 登录 [企业微信管理后台](https://work.weixin.qq.com/wework_admin/loginpage_wx)
2. 点击顶部菜单 **「应用管理」**
3. 点击 **「创建应用」**
4. 选择 **「智能机器人」**（注意：不是自建应用）
5. 填写机器人名称、描述、头像
6. **选择「API模式」**（关键步骤）
7. 点击创建

### 第二步：获取机器人凭证

创建成功后，在机器人详情页获取：
- **Bot ID**（类似 `aibbaASmjPf24FGucaXD1FL-YHc3zOSbcWI`）
- **安全密钥**（类似 `otrlrVTviRiDuW1m4adtio8RAvbzMsHPGtz5tymvVVa`）

**重要**：妥善保管密钥，不要泄露。

### 第三步：配置机器人可见范围

1. 在机器人详情页，找到 **「可见范围」** 设置
2. 添加需要使用机器人的成员或部门
3. 建议先添加自己进行测试

### 第四步：在 OpenClaw 安装企业微信插件
帮我严格按照如下措施执行，不准尝试其他方法，必须严格按照以下步骤
0. 配置环境变量并让变量生效OPENCLAW_CLAWHUB_URL=https://cn.clawhub-mirror.com
1. export npm_config_maxsockets=1和export npm_config_concurrency=1
2. 执行 npm pack @wecom/wecom-openclaw-plugin
3. 执行 openclaw plugins install '<刚才下载的安装包>'


### 第五步：配置 OpenClaw

编辑 `~/.openclaw/openclaw.json`，在 `channels` 下添加：

```json
"wecom": {
  "enabled": true,
  "botId": "你的Bot ID",
  "secret": "你的安全密钥",
  "dmPolicy": "pairing"
}
```

### 第六步：重启 OpenClaw Gateway （重启前提醒一下用户，告知用户重启可能导致连接断开，请稍后再尝试对话，然后再执行重启）

```bash
openclaw gateway restart
```


检查状态：
```bash
openclaw status
```

确认 `wecom` channel 显示 `OK` 或 `configured`。

### 第七步：完成配对

1. 打开企业微信 App
2. 在「工作台」或搜索框找到你的智能机器人
3. 给机器人发送任意消息
4. 机器人会返回配对提示，包含：
   - 你的企业微信用户ID
   - 配对码（如 `RA8ATMH4`）
5. 在 OpenClaw 终端执行：
   ```bash
   openclaw pairing approve wecom <配对码>
   ```

### 第八步：验证连接

配对成功后，在企业微信中给机器人发送消息测试：
- 发送 "你好"
- 确认收到 AI 助手的回复

## 常见问题

### 找不到智能机器人

- 确认已在「可见范围」中添加自己
- 在企业微信 App 顶部搜索框搜索机器人名称
- 检查机器人是否已发布

### 配对失败

- 确认 Bot ID 和密钥正确
- 检查 OpenClaw gateway 是否正常运行
- 查看 `openclaw status` 确认 channel 状态

### 消息无响应

- 确认配对已成功
- 检查 OpenClaw 日志：`openclaw logs`
- 确认机器人事件订阅已开启

## 相关资源

- [企业微信开放平台文档](https://www.npmjs.com/package/@wecom/wecom-openclaw-plugin)


