# OpenClaw 渠道插件详细配置手册

更新时间：2026-03-12  
适用项目：`auto-install-Openclaw`

## 1. 使用顺序（推荐）

1. 先运行官方模型向导：`openclaw onboard`
2. 再运行渠道菜单：`bash config-menu.sh`
3. 每次改动后执行：
   - `openclaw doctor --fix`
   - `openclaw gateway restart`
   - `openclaw channels list`

## 2. 渠道总览

| 菜单项 | 渠道 | 插件来源 | 插件包 |
|---|---|---|---|
| 1 | Telegram | 官方 | 内置 |
| 2 | Discord | 官方 | 内置 |
| 3 | WhatsApp | 官方 | 内置 |
| 4 | Slack | 官方 | 内置 |
| 5 | 飞书 Feishu | 官方 | `@openclaw/feishu` |
| 6 | Signal | 官方 | `@openclaw/signal` |
| 7 | Microsoft Teams | 官方 | `@openclaw/msteams` |
| 8 | Mattermost | 官方 | `@openclaw/mattermost` |
| 9 | Google Chat | 官方 | `@openclaw/googlechat` |
| 10 | Matrix | 官方 | `@openclaw/matrix` |
| 11 | LINE | 官方 | `@openclaw/line` |
| 12 | Nextcloud Talk | 官方 | `@openclaw/nextcloud-talk` |
| 13 | 更多官方渠道 | 官方 | IRC/Twitch/Zalo/Nostr... |
| 15 | 微信 WeChatPad | 社区 | `openclaw-wechat-channel` |
| 17 | QQ | 社区 | `@sliverp/qqbot` |
| 18 | 企业微信 WeCom | 社区 | `@marshulll/openclaw-wecom` |

## 3. 官方渠道配置要点

### Telegram
- 必填：`Bot Token`、`User ID`
- 菜单流程：`[3]消息渠道 -> [1]Telegram`

### Discord
- 必填：`Bot Token`、`Channel ID`
- 注意：需开启 `Message Content Intent`
- 菜单流程：`[3]消息渠道 -> [2]Discord`

### WhatsApp
- 通过 `openclaw channels login --channel whatsapp` 扫码登录
- 菜单流程：`[3]消息渠道 -> [3]WhatsApp`

### Slack
- 必填：`xoxb Bot Token`、`xapp App Token`
- 菜单流程：`[3]消息渠道 -> [4]Slack`

### 飞书（官方）
- 插件固定官方包：`@openclaw/feishu`
- 必填：`App ID`、`App Secret`
- 配置写入：`channels.feishu.accounts.main.*`
- 菜单流程：`[3]消息渠道 -> [5]飞书`

### Signal / Teams / Mattermost / Google Chat / Matrix / LINE / Nextcloud Talk
- 统一路径：`[3]消息渠道 -> 对应官方项`
- 由 `openclaw channels add --channel <name>` 引导完成

## 4. 社区渠道配置要点

### 微信（LangBot WeChatPad）
- 插件：`openclaw-wechat-channel`
- 必填：
  - `proxyUrl`
  - `apiKey`
  - 回调参数 `webhookHost/webhookPort/webhookPath`
- 菜单路径：`[3]消息渠道 -> [15]微信（社区）`

### QQ（社区）
- 插件：`@sliverp/qqbot`
- 必填：`AppID`、`AppSecret`
- 推荐配置：`allowFrom` 白名单
- 菜单路径：`[3]消息渠道 -> [17]QQ（社区）`

### 企业微信 WeCom（社区）
- 插件：`@marshulll/openclaw-wecom`
- 模式：
  - `bot`：Bot API
  - `app`：内部应用
  - `both`：双模式（推荐）
- 关键配置结构：
  - `channels.wecom.mode`
  - `channels.wecom.defaultAccount`
  - `channels.wecom.accounts.bot.*`
  - `channels.wecom.accounts.app.*`
- Bot 模式必填：
  - `token`
  - `encodingAESKey`
  - `receiveId`
  - `webhookPath`（默认 `/wecom/bot`）
- App 模式必填：
  - `corpId`
  - `corpSecret`
  - `agentId`（数字）
  - `callbackToken`
  - `callbackAesKey`
  - `webhookPath`（默认 `/wecom/app`）
- 菜单路径：`[3]消息渠道 -> [18]企业微信（社区）`

## 5. 常用排障命令

```bash
openclaw doctor --fix
openclaw plugins update --all
openclaw channels list
openclaw gateway restart
openclaw status
```

## 6. 版本策略建议

1. 生产环境优先使用官方渠道插件。  
2. 社区插件务必固定版本（`--pin`），避免 `latest` 漂移。  
3. 每次升级 OpenClaw 后，执行 `doctor -> plugins update --all -> 渠道探针`。