附录 D：通道配置指南

通道 (Channel) 是 OpenClaw 跟外界对话的"接口"。配上通道，你就能在飞书、微信、Telegram 等平台上跟 Agent 聊天了。

---

📋 常见通道快速配置表

通道	获取方式	所需信息	难易度
飞书 (Feishu)	飞书开放平台创建应用	appId + appSecret	⭐⭐
钉钉 (DingTalk)	钉钉开放平台创建应用	appKey + appSecret	⭐⭐
企业微信 (WeCom)	企业微信后台创建应用	corpId + agentId + secret	⭐⭐⭐
Discord	Discord Developer Portal 创建 Bot	Bot Token	⭐
Telegram	@BotFather 创建 Bot	Bot Token	⭐
Slack	Slack API 创建 App	Bot Token + Signing Secret	⭐⭐
Signal	Signal Messenger 注册	Signal 账号	⭐⭐⭐
WhatsApp	WhatsApp Business API 或 Web	Web 扫码	⭐⭐
微信个人号	微信机器人方案	需额外工具	⭐⭐⭐⭐
QQ Bot	QQ 开放平台	Bot 配置	⭐⭐⭐

---

📝 各通道所需信息清单

飞书 (Feishu)

1. 去 飞书开放平台 → 创建企业自建应用
2. 获取 App ID 和 App Secret
3. 开启机器人能力
4. 发布并授权

openclaw channels add --channel feishu \
  --app-id cli_xxxxxxxxxxxx \
  --app-secret "你的密钥"

Telegram

1. 在 Telegram 中找到 @BotFather
2. 发送 /newbot 按提示创建
3. 拿到 Bot Token（类似 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）

openclaw channels add --channel telegram --token "你的 Bot Token"

Discord

1. 去 Discord Developer Portal
2. 创建 Application → 创建 Bot → 复制 Token
3. 在 OAuth2 页面生成邀请链接，邀请 Bot 到服务器
4. 开启 Message Content Intent

openclaw channels add --channel discord --token "你的 Bot Token"

企业微信 (WeCom)

1. 登录 企业微信管理后台
2. 应用管理 → 创建应用
3. 获取 AgentId 和 Secret
4. 在"我的企业"中获取 CorpId
5. 配置接收消息的 URL（指向你的 Gateway 地址）

openclaw channels add --channel wecom \
  --corp-id "xxx" \
  --agent-id "xxx" \
  --secret "xxx"

Slack

1. 去 Slack API 创建 App
2. 开启 Socket Mode
3. 添加需要的 Bot Token Scopes
4. 安装 App 到工作区
5. 获取 Bot Token 和 Signing Secret

openclaw channels add --channel slack \
  --token "xoxb-xxx" \
  --signing-secret "xxx"

WhatsApp

有两种方式：

Web 版（推荐个人用户）：

openclaw channels add --channel whatsapp
openclaw channels login --channel whatsapp
# 扫码登录

Business API（推荐团队）：

openclaw channels add --channel whatsapp \
  --provider business \
  --phone-number-id "xxx" \
  --token "xxx"

---

🖊️ 通用配置步骤

不管什么通道，流程都是三步：

# 1. 添加通道配置
openclaw channels add --channel <通道名> <参数>

# 2. 查看状态
openclaw channels status

# 3. 有问题就诊断
openclaw doctor

❌ 删除/禁用通道

# 删除某个通道
openclaw channels remove --channel telegram

# 临时禁用（在 openclaw.json 中）
"channels": {
  "telegram": {
    "enabled": false,
    ...
  }
}

🔄 通道路由

配置好通道后，还可以设置路由——哪个通道的消息发给哪个 Agent：

# 查看当前路由
openclaw agents bindings

# 添加路由
openclaw agents bind --agent writer --channel feishu

💡 常见问题

Q：添加通道后 Agent 没反应？ A：先跑 openclaw status 检查通道状态，再用 openclaw doctor 诊断。

Q：飞书通道添加好了，但发了消息没回复？ A：检查飞书开放平台→事件订阅→请求 URL 是否配置正确，以及应用权限是否已发布。

Q：能在多个通道跟同一个 Agent 聊天吗？ A：完全可以。多个通道可以绑定到同一个 Agent，实现「飞书写→微信群回」，都走同一个大脑。

---

💡 建议先从最简单的 Telegram 或飞书开始，跑通了再添加其他通道。