openclaw-wecom-channel

# OpenClaw 企业微信 Channel 插件

企业微信 (WeCom/WxWork) 消息通道插件，让 OpenClaw AI Agent 通过企业微信收发消息，与 Telegram、Discord、Signal 等并列为原生 Channel。

## 功能

- **📩 接收消息** — 企业微信用户发送文本，Agent 自动回复
- **📤 主动推送** — Agent 通过企业微信 API 主动发送消息
- **🔐 消息加解密** — 完整实现企业微信 AES-256-CBC 消息加解密（WXBizMsgCrypt 标准）
- **🔑 Token 管理** — access_token 自动缓存 + 提前 5 分钟刷新
- **🛡️ 访问控制** — open / pairing / allowlist 三种策略
- **⚡ 智能回复** — 5 秒内被动回复，超时自动降级为主动推送

## 前置条件

- OpenClaw 已安装并运行
- 企业微信管理员权限（创建自建应用）
- 公网可达的回调 URL（推荐 Cloudflare Tunnel）

## 快速开始

### 1. 安装插件

```bash
# 克隆到 OpenClaw extensions 目录
git clone https://github.com/darrryZ/openclaw-wecom-channel.git ~/.openclaw/extensions/wecom
```

### 2. 配置 OpenClaw

编辑 `~/.openclaw/openclaw.json`：

```json
{
  "channels": {
    "wecom": {
      "enabled": true,
      "corpId": "你的企业ID",
      "agentId": 1000003,
      "secret": "应用Secret",
      "token": "回调Token",
      "encodingAESKey": "回调EncodingAESKey",
      "port": 18800,
      "dmPolicy": "open"
    }
  },
  "plugins": {
    "entries": {
      "wecom": { "enabled": true }
    }
  }
}
```

### 3. 配置公网回调（Cloudflare Tunnel）

```bash
cloudflared tunnel create wecom-tunnel
cloudflared tunnel route dns wecom-tunnel wecom.yourdomain.com
cloudflared tunnel run --edge-ip-version 4 --url http://localhost:18800 wecom-tunnel
```

企业微信后台回调 URL 设置为：`https://wecom.yourdomain.com/wecom/callback`

### 4. 重启 Gateway

```bash
openclaw gateway restart
```

## 详细文档

完整的配置指南、企业微信后台设置步骤、故障排查请参考 README.md。

## 链接

- **GitHub**: https://github.com/darrryZ/openclaw-wecom-channel
- **OpenClaw**: https://github.com/openclaw/openclaw
- **企业微信开发文档**: https://developer.work.weixin.qq.com/document/

# 企业微信 (WeCom) Channel 插件

企业微信是企业内部沟通协作平台。本插件将 OpenClaw 连接到企业微信自建应用，通过 HTTP 回调接收消息，通过 API 发送消息。

---

## 需要安装插件

将插件克隆到 OpenClaw extensions 目录：

```bash
git clone https://github.com/darrryZ/openclaw-wecom-channel.git ~/.openclaw/extensions/wecom
```

或手动复制：

```bash
mkdir -p ~/.openclaw/extensions/wecom
cp -r . ~/.openclaw/extensions/wecom/
```

---

## 快速开始

有两种方式添加企业微信 Channel：

### 方式一：CLI 设置（推荐）

```bash
openclaw channels add
```

选择 **WeCom**，然后按提示输入企业 ID、应用 Secret 等信息。

✅ **配置完成后**，管理 Gateway：

- `openclaw gateway status`
- `openclaw gateway restart`
- `openclaw logs --follow`

### 方式二：手动编辑配置文件

参见下方 [Step 2: 配置 OpenClaw](#step-2-配置-openclaw)。

---

## Step 1: 创建企业微信应用

### 1. 登录企业微信管理后台

访问 [企业微信管理后台](https://work.weixin.qq.com/wework_admin/frame) 并登录。

### 2. 获取企业 ID

进入 **我的企业** → **企业信息**，复制 **企业 ID**（格式：`wwxxxxxxxxxx`）。

### 3. 创建自建应用

进入 **应用管理** → **自建** → **创建应用**：

1. 填写应用名称和描述
2. 选择可见范围（建议先选自己测试）
3. 创建后进入应用详情页

### 4. 获取应用凭证

在应用详情页复制：

- **AgentId** — 应用 ID（数字格式，如 `1000003`）
- **Secret** — 应用密钥

❗ **重要：** Secret 请妥善保管，不要泄露。

### 5. 配置接收消息

在应用详情页 → **接收消息** → **设置 API 接收**：

1. **URL**: `https://你的域名/wecom/callback`（需公网可达，见 [公网访问](#公网访问)）
2. **Token**: 点击随机生成，复制保存
3. **EncodingAESKey**: 点击随机生成，复制保存
4. 点击保存（此时 Gateway 必须已启动，否则验证会失败）

### 6. 配置可信 IP

在应用详情页 → **企业可信IP**：

添加你的服务器公网 IP。如果使用家庭宽带，IP 可能会变化，需要及时更新。

> 💡 **提示：** 可以通过 `curl ifconfig.me` 查询当前公网 IP。

---

## Step 2: 配置 OpenClaw

### 通过配置文件

编辑 `~/.openclaw/openclaw.json`：

```json5
{
  channels: {
    wecom: {
      enabled: true,...