渠道能力矩阵与选型建议

目的

把官方 channels 目录转为团队可执行的"渠道选型 + 风险控制"清单。

参考：

• https://docs.openclaw.ai/channels/index.md
• https://docs.openclaw.ai/channels/troubleshooting.md

选型维度

维度	说明	评估要点
接入速度	配置复杂度与首次可用时间	是否需要额外硬件？认证流程是否简单？
组织适配	是否符合团队当前沟通主阵地	团队是否已在用？是否需要迁移成本？
稳定性	渠道 API/连接策略成熟度	API 是否稳定？断连频率如何？
风险面	是否涉及额外账号权限与敏感范围	是否需要企业认证？数据合规如何？

渠道能力矩阵

即时通讯渠道

渠道	接入速度	组织适配	稳定性	风险面	推荐场景
Telegram	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐⭐	低	个人助理、小团队、快速验证
Discord	⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐	低	开源社区、游戏团队、开发者
WhatsApp	⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐	中	客服、企业对接、国际用户
Slack	⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	低	企业团队、工程协作
Signal	⭐⭐⭐⭐	⭐⭐	⭐⭐⭐	低	隐私敏感场景

企业协作渠道

渠道	接入速度	组织适配	稳定性	风险面	推荐场景
Microsoft Teams	⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	中	Microsoft 生态企业
Google Chat	⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐	低	Google 生态团队
Feishu	⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐	中	国内企业、多语言团队
Mattermost	⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐	低	自托管、安全敏感场景

其他渠道

渠道	接入速度	组织适配	稳定性	风险面	推荐场景
iMessage	⭐⭐⭐	⭐⭐⭐	⭐⭐⭐	中	Apple 生态个人使用
IRC	⭐⭐⭐⭐	⭐⭐	⭐⭐⭐	低	开源社区
Web Chat	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐	低	产品集成、客服
Nostr	⭐⭐⭐	⭐⭐	⭐⭐⭐	低	Web3 社区

常见渠道建议

推荐起步顺序

1. Telegram（最快跑通）
   └── 配置简单、API 稳定、适合个人和小团队

2. Discord（社区首选）
   └── 功能丰富、支持频道和线程、适合开发者社区

3. Slack（企业首选）
   └── 企业友好、集成丰富、适合工程团队

4. WhatsApp（用户覆盖）
   └── 用户基数大、适合客服场景

5. 企业 IM（按需接入）
   └── 根据团队现有工具选择

按场景选择

场景	推荐渠道	原因
个人助理	Telegram	简单可靠、个人友好
开发团队	Slack / Discord	集成丰富、开发者友好
客服场景	WhatsApp / Web Chat	用户覆盖广、易于接入
企业内部	Teams / Feishu	企业认证、合规支持
开源社区	Discord / IRC	社区友好、成本低
隐私敏感	Signal / Mattermost	端到端加密、自托管

分阶段接入策略

阶段一：单渠道上线

# 目标：跑通消息闭环
channels:
  telegram:
    enabled: true
    bot_token: ${secrets.telegram_bot_token}

agents:
  defaults:
    model: gpt-4-turbo
    tools: minimal

# 验收标准
acceptance:
  - 能发送消息并收到回复
  - 响应时间 < 5s
  - 无连续错误

阶段二：第二渠道

# 目标：容灾或场景分流
channels:
  telegram:
    enabled: true
    # ...
  discord:
    enabled: true
    # ...

routing:
  by_channel:
    telegram: personal-agent
    discord: dev-agent

# 验收标准
acceptance:
  - 两个渠道都能正常工作
  - 路由规则按预期生效
  - 渠道间隔离正确

阶段三：按业务域绑定

# 目标：业务域隔离
channels:
  telegram-support:
    enabled: true
    # ...
  slack-dev:
    enabled: true
    # ...
  slack-ops:
    enabled: true
    # ...

pairing:
  - name: customer-support
    channels: [telegram-support]
    agent: cs-agent
    tools: minimal

  - name: development
    channels: [slack-dev]
    agent: dev-agent
    tools: coding

  - name: operations
    channels: [slack-ops]
    agent: ops-agent
    tools: full

角色分工

开发者负责

• 完成渠道接入与技术排障
• 维护渠道运行状态和日志
• 配置路由规则和权限策略

产品经理负责

• 定义渠道归属（哪些场景走哪个渠道）
• 定义异常时的用户沟通与兜底流程
• 制定渠道使用规范和响应 SLA

协作检查清单

开发者：

- [ ] 渠道配置正确
- [ ] 连接测试通过
- [ ] 日志记录启用
- [ ] 监控告警配置

产品经理：

- [ ] 使用场景明确
- [ ] 响应 SLA 定义
- [ ] 异常流程设计
- [ ] 用户沟通模板

渠道配置模板

Telegram 配置模板

channels:
  telegram:
    enabled: true
    bot_token: ${secrets.telegram_bot_token}

    # 私聊配置
    private:
      enabled: true
      allowed_users: [] # 空 = 允许所有

    # 群组配置
    groups:
      enabled: true
      allowed_groups: [] # 空 = 允许所有

    # 触发配置
    trigger:
      mention: true # @bot 触发
      reply: true # 回复触发
      prefix: '' # 前缀触发

Discord 配置模板

channels:
  discord:
    enabled: true
    bot_token: ${secrets.discord_bot_token}
    application_id: ${secrets.discord_app_id}

    # 服务器配置
    guilds:
      enabled: true
      allowed_guilds: [] # 空 = 允许所有

    # 频道配置
    channels:
      enabled: true
      allowed_channels: [] # 空 = 允许所有

    # 权限配置
    permissions:
      admin_only: false
      admin_roles: [Admin, Moderator]

Slack 配置模板

channels:
  slack:
    enabled: true
    app_token: ${secrets.slack_app_token}
    bot_token: ${secrets.slack_bot_token}

    # 工作区配置
    workspace: '' # 空 = 所有工作区

    # 频道配置
    channels:
      enabled: true
      allowed_channels: [] # 空 = 允许所有

    # 触发配置
    trigger:
      mention: true # @bot 触发
      direct_message: true # 私聊触发
      channel_prefix: '' # 频道前缀触发

上线前清单

# 检查渠道列表
openclaw channels list

# 检查渠道状态
openclaw channels status --probe

# 检查配对状态
openclaw pairing list

# 检查整体状态
openclaw status

# 安全审计
openclaw security audit

上线验收清单

基础检查：

- [ ] 渠道配置正确
- [ ] 连接状态 active
- [ ] 消息收发正常
- [ ] 路由规则生效

安全检查：

- [ ] 权限策略正确
- [ ] 敏感信息隔离
- [ ] 审批流程工作

监控检查：

- [ ] 日志记录启用
- [ ] 告警配置完成
- [ ] 响应 SLA 定义