渠道与路由

约 1589 字大约 5 分钟

2026-03-02

什么是 Channel

Channel（渠道）是 OpenClaw 与外部聊天平台的连接器，负责接收和发送消息。通过 Channel，你可以在日常使用的聊天应用中与 OpenClaw Agent 交互。

Channel 的核心功能

消息接收：从聊天平台接收用户消息
消息发送：将 Agent 的回复发送回聊天平台
格式转换：处理不同平台的消息格式差异
连接管理：维护与聊天平台的长连接
事件处理：处理平台特定的事件（如群组变更、用户加入等）

支持的平台

OpenClaw 支持广泛的聊天平台：

即时通讯

平台	状态	国内可用	配置难度	推荐场景
Telegram	✅ 稳定	✓	⭐ 简单	个人使用、快速测试
Discord	✅ 稳定	✓	⭐⭐ 中等	开发者社区、游戏团队
飞书/Lark	✅ 稳定	✓	⭐⭐ 中等	企业协作、团队管理
微信	⚠️ 实验性	✓	⭐⭐⭐ 复杂	国内日常沟通
WhatsApp	✅ 稳定	需翻墙	⭐⭐ 中等	国际用户
Signal	✅ 稳定	需翻墙	⭐⭐ 中等	隐私保护
Slack	✅ 稳定	需翻墙	⭐⭐ 中等	企业协作

企业通讯

平台	状态	配置难度
Microsoft Teams	✅ 稳定	⭐⭐⭐ 复杂
Google Chat	✅ 稳定	⭐⭐ 中等
钉钉	⚠️ 实验性	⭐⭐⭐ 复杂
企业微信	⚠️ 实验性	⭐⭐⭐ 复杂

其他平台

iMessage（通过 BlueBubbles）
IRC
Matrix
Mattermost
Nextcloud Talk
Nostr
Twitch
WebChat（内置 Web 聊天界面）

管理 Channels

查看已配置的 Channels

# 列出所有 Channels
openclaw channels list

# 详细信息
openclaw channels list --verbose

输出示例：

Channels:
✓ telegram (Running)
  - Account: main
  - Users: 15
  - Groups: 3
  
✓ discord (Running)
  - Account: main
  - Servers: 2
  - Channels: 8
  
⚠ feishu (Error)
  - Account: main
  - Error: Connection timeout

添加新 Channel

openclaw channels add

按照交互式向导选择平台并完成配置。

删除 Channel

openclaw channels remove <channel-name>

重启 Channel

# 重启特定 Channel
openclaw channels restart telegram

# 重启所有 Channels
openclaw channels restart --all

启用/禁用 Channel

# 禁用 Channel
openclaw channels disable telegram

# 启用 Channel
openclaw channels enable telegram

路由策略

什么是路由

路由决定了消息如何从 Channel 分发到 Agent。OpenClaw 支持灵活的路由规则。

路由策略类型

1. Open（开放策略）

响应所有消息，适合测试环境：

{
  "channels": {
    "telegram": {
      "groupPolicy": "open"
    }
  }
}

2. Allowlist（白名单策略）

仅响应白名单中的用户/群组，推荐生产环境：

{
  "channels": {
    "telegram": {
      "groupPolicy": "allowlist",
      "allowedUsers": ["123456", "789012"],
      "allowedGroups": ["group_id_1", "group_id_2"]
    }
  }
}

3. Blocklist（黑名单策略）

响应除黑名单外的所有消息：

{
  "channels": {
    "telegram": {
      "groupPolicy": "blocklist",
      "blockedUsers": ["spam_user_1", "spam_user_2"]
    }
  }
}

配置路由规则

基于渠道路由

{
  "bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "telegram"
      }
    },
    {
      "agentId": "coder",
      "match": {
        "channel": "discord"
      }
    }
  ]
}

基于用户路由

{
  "bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "telegram",
        "userId": "123456"
      }
    },
    {
      "agentId": "support",
      "match": {
        "channel": "telegram",
        "userId": "789012"
      }
    }
  ]
}

基于群组路由

{
  "bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "discord",
        "serverId": "server_1",
        "channelId": "general"
      }
    },
    {
      "agentId": "coder",
      "match": {
        "channel": "discord",
        "serverId": "server_1",
        "channelId": "dev"
      }
    }
  ]
}

基于关键词路由

{
  "bindings": [
    {
      "agentId": "support",
      "match": {
        "channel": "telegram",
        "keywords": ["help", "support", "问题"]
      }
    },
    {
      "agentId": "coder",
      "match": {
        "channel": "telegram",
        "keywords": ["code", "bug", "代码"]
      }
    }
  ]
}

默认路由

当没有匹配的路由规则时，使用默认 Agent：

{
  "routing": {
    "default": {
      "agentId": "main"
    }
  }
}

多智能体配置

为什么需要多 Agent

专业化分工：不同 Agent 处理不同类型的任务
隔离上下文：避免不同项目的上下文混淆
性能优化：分散负载，提高响应速度
权限控制：不同 Agent 有不同的权限和能力

创建多个 Agent

# 创建专门处理代码的 Agent
openclaw agents add coder

# 创建技术支持 Agent
openclaw agents add support

# 创建项目管理 Agent
openclaw agents add pm

为 Agent 定制"灵魂"

每个 Agent 都有独立的 Workspace，包含"灵魂三件套"：

编辑 SOUL.md（性格定义）

openclaw agents edit coder --soul

示例内容：

# Coder Agent

## 核心原则
- 专注于代码审查、编写和技术问题解答
- 遵循最佳实践和代码规范
- 提供清晰的技术解释和示例

## 风格定位
- 技术专业、逻辑清晰
- 代码示例丰富
- 注重性能和安全性

## 边界
- 不处理非技术问题
- 不提供项目管理建议
- 专注于代码质量和技术实现

编辑 USER.md（用户信息）

openclaw agents edit coder --user

编辑 AGENTS.md（工作方式）

openclaw agents edit coder --agents

多 Agent 路由示例

场景 1：按平台分配

{
  "bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "telegram"
      }
    },
    {
      "agentId": "coder",
      "match": {
        "channel": "discord"
      }
    },
    {
      "agentId": "support",
      "match": {
        "channel": "feishu"
      }
    }
  ]
}

场景 2：按群组分配

{
  "bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "discord",
        "channelId": "general"
      }
    },
    {
      "agentId": "coder",
      "match": {
        "channel": "discord",
        "channelId": "dev"
      }
    },
    {
      "agentId": "support",
      "match": {
        "channel": "discord",
        "channelId": "support"
      }
    }
  ]
}

场景 3：按时间分配

{
  "bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "telegram",
        "timeRange": {
          "start": "09:00",
          "end": "18:00"
        }
      }
    },
    {
      "agentId": "night",
      "match": {
        "channel": "telegram",
        "timeRange": {
          "start": "18:00",
          "end": "09:00"
        }
      }
    }
  ]
}

跨代理协作

长期记忆共享

多个 Agent 可以共享长期记忆：

{
  "memory": {
    "shared": true,
    "agents": ["main", "coder", "support"]
  }
}

上下文迁移

在 Agent 之间迁移会话上下文：

# 将会话从 main 迁移到 coder
openclaw sessions transfer --from main --to coder --session <session-id>

Agent 间通信

Agent 可以相互调用：

@main 请帮我问问 @coder 这段代码有什么问题

消息格式处理

文本消息

所有平台都支持基础文本消息。

富文本消息

支持 Markdown 格式：

**粗体文本**
*斜体文本*
`代码`
[链接](https://example.com)

媒体消息

图片
文件
语音
视频

交互式消息

某些平台支持交互式元素：

按钮
下拉菜单
表单

平台特定配置

Telegram 特性

支持 Bot Commands
支持 Inline Keyboards
支持文件发送（最大 50MB）

Discord 特性

支持 Slash Commands
支持 Embeds
支持 Threads

飞书特性

支持消息卡片
支持审批流程
支持日程管理

故障排查

Channel 无法连接

# 检查 Channel 状态
openclaw channels status telegram

# 查看错误日志
openclaw logs --channel telegram --level error

# 重新认证
openclaw channels reauth telegram

消息无法发送

# 测试消息发送
openclaw message send --channel telegram --to <user-id> --message "test"

# 检查权限
openclaw channels permissions telegram

路由不生效

# 验证路由规则
openclaw routing validate

# 测试路由
openclaw routing test --channel telegram --userId 123456

# 查看路由日志
openclaw logs --component router

最佳实践

使用白名单策略：生产环境务必使用 allowlist
定期检查日志：及时发现和解决问题
合理分配 Agent：根据业务需求划分 Agent 职责
配置备份：定期备份 Channel 配置
监控性能：关注消息处理延迟和错误率