arcadia-admin
/
arcadiasuite
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
arcadiasuite/server/modules/openclaw/docs/channels-configuration-guid...

3.6 KiB
Raw Blame History

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. 常用排障命令

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 -> 渠道探针。