Cygnus Tech Blog
Cygnus Tech Blog

第04章 多渠道接入 —— 如何支持 25+ 聊天平台

Cygnus Yang 收录于 01-AI 工具与智能体/01-OpenClaw
 约 500 字 预计阅读 2 分钟 

OpenClaw 最方便的一点就是：你不用换聊天软件，AI 直接出现在你天天都用的聊天软件里。

本章我们讲解 OpenClaw 怎么做到支持 25+ 聊天平台，架构设计是什么样的。

什么是多渠道接入

“多渠道"就是：

  • 你天天用 WhatsApp → OpenClaw 接进去，你就在 WhatsApp 用 AI
  • 你团队在 Discord → OpenClaw 接进去，你就在 Discord 用 AI
  • 你喜欢苹果生态，用 iMessage → OpenClaw 接进去，你就在 iMessage 用 AI
  • 甚至你喜欢用网页 → OpenClaw 内置 WebChat，直接浏览器用

一句话：AI 跟着你走，你不用换环境。

架构设计：渠道即插件

OpenClaw 设计：每个渠道都是独立插件。

图表 代码
%%{init: {'theme':'base','themeVariables': {'primaryColor':'#f1f5f9','primaryBorderColor':'#0f4c81','primaryTextColor':'#0f172a','secondaryColor':'#f1f5f9','secondaryBorderColor':'#0f4c81','secondaryTextColor':'#0f172a','tertiaryColor':'#fbbf24','tertiaryBorderColor':'#fbbf24','tertiaryTextColor':'#0f172a','background':'#f8fafc','fontFamily':'Inter, system-ui, sans-serif','fontSize':'14px','textColor':'#0f172a','lineColor':'#334155','edgeLabelBackground':'#ffffff','actorBorderColor':'#0f4c81','actorTextColor':'#0f172a','actorFill':'#f1f5f9'}}}%%
graph TD
  G[Gateway] --> P[Channel Plugin]
  P --> C1[WhatsApp]
  P --> C2[Telegram]
  P --> C3[Discord]
  P --> C4[iMessage]
  P --> C5[Signal]
  P --> C6[Slack]
  P --> C7[... 20+ more]
%%{init: {'theme':'base','themeVariables': {'primaryColor':'#f1f5f9','primaryBorderColor':'#0f4c81','primaryTextColor':'#0f172a','secondaryColor':'#f1f5f9','secondaryBorderColor':'#0f4c81','secondaryTextColor':'#0f172a','tertiaryColor':'#fbbf24','tertiaryBorderColor':'#fbbf24','tertiaryTextColor':'#0f172a','background':'#f8fafc','fontFamily':'Inter, system-ui, sans-serif','fontSize':'14px','textColor':'#0f172a','lineColor':'#334155','edgeLabelBackground':'#ffffff','actorBorderColor':'#0f4c81','actorTextColor':'#0f172a','actorFill':'#f1f5f9'}}}%%
graph TD
  G[Gateway] --> P[Channel Plugin]
  P --> C1[WhatsApp]
  P --> C2[Telegram]
  P --> C3[Discord]
  P --> C4[iMessage]
  P --> C5[Signal]
  P --> C6[Slack]
  P --> C7[... 20+ more]
%%{init: {'theme':'base','themeVariables': {'primaryColor':'#f1f5f9','primaryBorderColor':'#0f4c81','primaryTextColor':'#0f172a','secondaryColor':'#f1f5f9','secondaryBorderColor':'#0f4c81','secondaryTextColor':'#0f172a','tertiaryColor':'#fbbf24','tertiaryBorderColor':'#fbbf24','tertiaryTextColor':'#0f172a','background':'#f8fafc','fontFamily':'Inter, system-ui, sans-serif','fontSize':'14px','textColor':'#0f172a','lineColor':'#334155','edgeLabelBackground':'#ffffff','actorBorderColor':'#0f4c81','actorTextColor':'#0f172a','actorFill':'#f1f5f9'}}}%%
graph TD
  G[Gateway] --> P[Channel Plugin]
  P --> C1[WhatsApp]
  P --> C2[Telegram]
  P --> C3[Discord]
  P --> C4[iMessage]
  P --> C5[Signal]
  P --> C6[Slack]
  P --> C7[... 20+ more]
%%{init: {'theme':'base','themeVariables': {'primaryColor':'#f1f5f9','primaryBorderColor':'#0f4c81','primaryTextColor':'#0f172a','secondaryColor':'#f1f5f9','secondaryBorderColor':'#0f4c81','secondaryTextColor':'#0f172a','tertiaryColor':'#fbbf24','tertiaryBorderColor':'#fbbf24','tertiaryTextColor':'#0f172a','background':'#f8fafc','fontFamily':'Inter, system-ui, sans-serif','fontSize':'14px','textColor':'#0f172a','lineColor':'#334155','edgeLabelBackground':'#ffffff','actorBorderColor':'#0f4c81','actorTextColor':'#0f172a','actorFill':'#f1f5f9'}}}%%
graph TD
  G[Gateway] --> P[Channel Plugin]
  P --> C1[WhatsApp]
  P --> C2[Telegram]
  P --> C3[Discord]
  P --> C4[iMessage]
  P --> C5[Signal]
  P --> C6[Slack]
  P --> C7[... 20+ more]

插件接口

每个渠道插件只要实现几个方法：

interface Channel {
  // 启动渠道，连接到平台
  start(): Promise<void>;
  // 停止渠道
  stop(): Promise<void>;
  // 收到用户消息 → 交给 Gateway 处理
  onMessage(message: IncomingMessage): Promise<void>;
  // Gateway 处理完 → 把结果发回给用户
  sendMessage(recipient: Recipient, text: string): Promise<void>;
}

就这么简单。新增渠道只要写个新插件，不用改核心代码。

为什么这样设计

好处：

  • 正交：核心网关不需要关心渠道细节
  • 可扩展：社区想加新渠道，不用碰核心，发个 PR 就行
  • 可替换：这个渠道实现不好，换一个实现就行
  • 可配置：你只用 Telegram，就只开 Telegram，其他不用开，节省资源

渠道统一抽象

虽然渠道五花八门，OpenClaw 把渠道抽象成几个统一概念：

概念含义
channel哪个渠道（telegram/discord/…）
accountId哪个账号（如果你登了多个）
from谁发的消息（用户账号）
threadId哪个线程/频道（Discord 线程，Telegram 群）
groupId哪个群/组

这些概念抽象之后，核心路由不管你是什么渠道，都能正确路由到会话。

会话键生成算法

路由的核心是生成唯一会话键：

// 伪代码
function resolveSessionKey(config, channel, from, threadId) {
  const scope = config.session?.scope ?? "per-sender";
  switch (scope) {
    case "per-sender":
      // 每个用户一个会话
      return `${channel}:${accountId}:${from}`;
    case "per-thread":
      // 每个线程一个会话
      return `${channel}:${accountId}:${from}:${threadId}`;
  }
}

不同渠道不同配置，生成不同的会话键。这样：

  • 群聊里，每个人都有自己独立的 AI 会话
  • 同一个人不同线程，也能分开

已支持渠道列表

截止目前，OpenClaw 官方支持这些渠道：

聊天消息：

  • WhatsApp
  • Telegram
  • Discord
  • iMessage (macOS)
  • Signal
  • Matrix
  • Slack
  • Mastodon
  • Line
  • Mattermost
  • Twitch
  • Bluesky
  • … 还有很多

原生应用：

  • macOS 菜单栏 app
  • iOS app
  • Android app

其他：

  • CLI 命令行
  • WebChat 网页

完整列表看 OpenClaw 官方。

渠道权限控制

每个渠道可以独立配置，配置写在你的主配置文件 ~/.openclaw/openclaw.json 的 channels 下：

{
  channels: {
    discord: {
      enabled: true,
      token: "xxx",
      pairing: {
        // 允许哪些用户
        allowUsers: ["your-user-id"],
      },
    },
    telegram: {
      enabled: true,
      token: "yyy",
      pairing: {
        allowUsers: ["your-account"],
      },
    },
  },
}

你不用的渠道关掉就行，节省资源。

我的日常使用场景

举个实际例子：

  • 上班：公司用 Slack → OpenClaw 在 Slack 里
  • 私下聊天：用 Telegram → OpenClaw 在 Telegram 里
  • 苹果电脑：菜单栏有 app，点一下就能聊
  • iOS：手机上也有 app，随时随地

无论你在哪里，AI 都在那里。不用切 APP，不用重新登录，体验一致。

为什么多渠道接入很重要

很多 AI 助手要求你来我的网站/APP 用，这其实违背用户习惯：

  • 用户已经有习惯的聊天软件了
  • 为什么要用户换环境？
  • 为什么不能 AI 适应用户，而是用户适应 AI？

OpenClaw 的哲学：用户在哪里，AI 就去哪里。

本章小结

  • OpenClaw 支持 25+ 聊天平台，用户不用换软件，AI 适应用户
  • 架构：每个渠道都是独立插件，新增渠道不用改核心
  • 统一抽象：channel/account/from/thread → 生成唯一会话键
  • 独立配置：每个渠道可以单独开/关、单独配置权限
  • 哲学：用户在哪里，AI 就去哪里

相关内容

收录于 合集・01-AI 工具与智能体/01-OpenClaw 34
更新于 2026-05-23 
CC BY-NC-SA 4.0
返回 | 主页
如果这篇文章对你有帮助，欢迎请我喝杯咖啡 ☕
Cygnus Yang 支付宝支付宝
Cygnus Yang 微信微信

目录