当 AI Agent 要同时接入 Telegram、飞书、钉钉：Channel Plugin 抽象层设计之道

当 AI Agent 要同时接入 Telegram、飞书、钉钉：Channel Plugin 抽象层设计之道

• • 1. 引言：为什么要做这层抽象？
  • 2. 抽象层的核心原则：“契约先行，实现自由”
  • • 2.1 插件职责划分
  • 3. 多渠道设计的关键抽象机制
  • • 3.1 统一会话标识：sessionKey
    • 3.2 统一消息模型：ACP 协议
    • 3.3 渠道发现与元数据
  • 4. 以 `createChatChannelPlugin` 为入口的插件构建
  • 5. 消息生命周期：Receive → Dispatch → Send
  • • 5.1 Receive（接收）
    • 5.2 Dispatch & Send（分发与发送）
  • 6. 一张图看懂 Channel Plugin 抽象层设计
  • 7. 结语：让渠道适配成为“可插拔”

)

1. 引言：为什么要做这层抽象？

如果你要给一个 AI Agent 系统接入多个即时通讯渠道——比如 Telegram、飞书、钉钉、WhatsApp、Discord——你很快就发现每个平台的“脾气”完全不同：

• 消息格式：Telegram 用 JSON，飞书用事件卡片，钉钉用 Webhook 回调
• 认证方式：Telegram 用 Bot Token，WhatsApp 用 Twilio，飞书用 App Secret
• 会话 ID 规则：每个平台都有自己的用户标识格式
• 回复方式：有的支持消息编辑，有的只能发新消息，有的支持 Markdown，有的只支持纯文本

如果为每个平台单独写一套完整集成，维护成本会随着渠道数量指数级增长。 OpenClaw 的解法是：将渠道视为可插拔模块，通过统一的 Channel Plugin 接口抽象，让核心引擎与具体渠道解耦。

2. 抽象层的核心原则：“契约先行，实现自由”

OpenClaw 的 Channel Plugin 抽象设计遵循一个核心原则：Channel plugins do not need their own send/edit/react tools. OpenClaw keeps one shared message tool in core（渠道插件不需要自己的发送/编辑/回复工具。OpenClaw 在核心中保留一个共用的消息工具）。

这意味着什么？核心引擎只关心“发一条消息”这个抽象动作，至于这条消息到了 Telegram 是发文本还是卡片，到了飞书是发富文本还是消息卡片，这是插件自己的事。

2.1 插件职责划分

根据 OpenClaw 官方文档，Channel Plugin 负责以下内容：

而核心引擎（Core）则负责：共用的 message 工具、提示词装配、外层会话键结构、通用 :thread: 簿记与消息分发。

渲染错误: Mermaid 渲染失败: Lexical error on line 2. Unrecognized text. …art TD subgraph “Core Engine” ———————-^

3. 多渠道设计的关键抽象机制

3.1 统一会话标识：sessionKey

不同渠道的用户 ID 格式完全不同：WhatsApp 是 +1234567890，Telegram 是数字 ID 123456789，Web 是随机字符串。OpenClaw 通过标准化 sessionKey 统一标识：

所有会话状态、记忆、任务都按 sessionKey 存储，用户从 WhatsApp 切换到 Telegram，只要绑定同一身份，对话上下文可以无缝衔接。

3.2 统一消息模型：ACP 协议

渠道插件不直接与 AI 核心交互，而是通过 ACP（Agent Communication Protocol） 消息总线。

#mermaid-svg-wqEQU0hOGv7ijI1P{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-wqEQU0hOGv7ijI1P .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-wqEQU0hOGv7ijI1P .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-wqEQU0hOGv7ijI1P .error-icon{fill:#552222;}#mermaid-svg-wqEQU0hOGv7ijI1P .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-wqEQU0hOGv7ijI1P .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-wqEQU0hOGv7ijI1P .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-wqEQU0hOGv7ijI1P .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-wqEQU0hOGv7ijI1P .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-wqEQU0hOGv7ijI1P .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-wqEQU0hOGv7ijI1P .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-wqEQU0hOGv7ijI1P .marker{fill:#333333;stroke:#333333;}#mermaid-svg-wqEQU0hOGv7ijI1P .marker.cross{stroke:#333333;}#mermaid-svg-wqEQU0hOGv7ijI1P svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-wqEQU0hOGv7ijI1P p{margin:0;}#mermaid-svg-wqEQU0hOGv7ijI1P .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-wqEQU0hOGv7ijI1P .cluster-label text{fill:#333;}#mermaid-svg-wqEQU0hOGv7ijI1P .cluster-label span{color:#333;}#mermaid-svg-wqEQU0hOGv7ijI1P .cluster-label span p{background-color:transparent;}#mermaid-svg-wqEQU0hOGv7ijI1P .label text,#mermaid-svg-wqEQU0hOGv7ijI1P span{fill:#333;color:#333;}#mermaid-svg-wqEQU0hOGv7ijI1P .node rect,#mermaid-svg-wqEQU0hOGv7ijI1P .node circle,#mermaid-svg-wqEQU0hOGv7ijI1P .node ellipse,#mermaid-svg-wqEQU0hOGv7ijI1P .node polygon,#mermaid-svg-wqEQU0hOGv7ijI1P .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-wqEQU0hOGv7ijI1P .rough-node .label text,#mermaid-svg-wqEQU0hOGv7ijI1P .node .label text,#mermaid-svg-wqEQU0hOGv7ijI1P .image-shape .label,#mermaid-svg-wqEQU0hOGv7ijI1P .icon-shape .label{text-anchor:middle;}#mermaid-svg-wqEQU0hOGv7ijI1P .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-wqEQU0hOGv7ijI1P .rough-node .label,#mermaid-svg-wqEQU0hOGv7ijI1P .node .label,#mermaid-svg-wqEQU0hOGv7ijI1P .image-shape .label,#mermaid-svg-wqEQU0hOGv7ijI1P .icon-shape .label{text-align:center;}#mermaid-svg-wqEQU0hOGv7ijI1P .node.clickable{cursor:pointer;}#mermaid-svg-wqEQU0hOGv7ijI1P .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-wqEQU0hOGv7ijI1P .arrowheadPath{fill:#333333;}#mermaid-svg-wqEQU0hOGv7ijI1P .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-wqEQU0hOGv7ijI1P .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-wqEQU0hOGv7ijI1P .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-wqEQU0hOGv7ijI1P .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-wqEQU0hOGv7ijI1P .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-wqEQU0hOGv7ijI1P .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-wqEQU0hOGv7ijI1P .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-wqEQU0hOGv7ijI1P .cluster text{fill:#333;}#mermaid-svg-wqEQU0hOGv7ijI1P .cluster span{color:#333;}#mermaid-svg-wqEQU0hOGv7ijI1P div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-wqEQU0hOGv7ijI1P .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-wqEQU0hOGv7ijI1P rect.text{fill:none;stroke-width:0;}#mermaid-svg-wqEQU0hOGv7ijI1P .icon-shape,#mermaid-svg-wqEQU0hOGv7ijI1P .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-wqEQU0hOGv7ijI1P .icon-shape p,#mermaid-svg-wqEQU0hOGv7ijI1P .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-wqEQU0hOGv7ijI1P .icon-shape .label rect,#mermaid-svg-wqEQU0hOGv7ijI1P .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-wqEQU0hOGv7ijI1P .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-wqEQU0hOGv7ijI1P .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-wqEQU0hOGv7ijI1P :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

Telegram Webhook

TelegramPlugin

飞书事件

FeishuPlugin

钉钉回调

DingPlugin

ACP 消息总线

Agent Core

Tool Execution

TelegramPlugin.send

FeishuPlugin.send

DingPlugin.send

ACP 是渠道与智能体之间的通用语言，消息格式统一为 JSON Schema，包含 source、message_id、content、attachments、timestamp 等标准字段。

3.3 渠道发现与元数据

在插件包加载之前，OpenClaw 通过 package.json 中的 openclaw.channel 元数据完成渠道发现：

{
"openclaw": {
"channel": {
"id": "acme-chat",
"label": "Acme Chat",
"blurb": "Connect to Acme Chat messaging platform",
"docsPath": "/channels/acme-chat",
"markdownCapable": true,
"exposure": {
"configured": true,
"setup": true,
"docs": true
}
}
}
}

exposure 控制渠道在设定列表、交互式选择器和文档页面中的可见性。

4. 以 createChatChannelPlugin 为入口的插件构建

对于开发者而言，不需要手动实现复杂的底层适配器。OpenClaw 提供了 createChatChannelPlugin 构建器，传入声明式选项即可组合完整插件。

以下是一个构建自定义渠道插件的示例：

import { createChatChannelPlugin, createChannelPluginBase } from "openclaw/plugin-sdk";

// 1. 账号解析：从配置中读取该渠道的 token
function resolveAccount(cfg, accountId) {
const section = cfg.channels?.["acme-chat"];
if (!section?.token) throw new Error("acme-chat: token is required");
return { accountId, token: section.token };
}

// 2. 构建插件
export const acmeChatPlugin = createChatChannelPlugin({
base: createChannelPluginBase({
id: "acme-chat",
setup: { resolveAccount }
}),

// DM 安全策略
security: {
dm: {
channelKey: "acme-chat",
resolvePolicy: (account) => account.dmPolicy,
resolveAllowFrom: (account) => account.allowFrom,
defaultPolicy: "allowlist",
},
},

// 配对待定：新联系人需要验证
pairing: {
text: {
idLabel: "Acme Chat username",
message: "Send this code to verify your identity:",
notify: async ({ target, code }) => {
await acmeChatApi.sendDm(target, `Pairing code: ${code}`);
},
},
},

// 线程模式
threading: { topLevelReplyToMode: "reply" },

// 出站消息发送
outbound: {
attachedResults: {
sendText: async (params) => {
const result = await acmeChatApi.sendMessage(params.to, params.text);
return { messageId: result.id };
},
},
base: {
sendMedia: async (params) => {
await acmeChatApi.sendFile(params.to, params.filePath);
},
},
},
});

5. 消息生命周期：Receive → Dispatch → Send

Channel Plugin 的抽象不仅是“接口定义”，还覆盖了消息的完整生命周期：

5.1 Receive（接收）

入站消息通过 runChannelInboundEvent 处理：

接收确认策略是显式声明的：

5.2 Dispatch & Send（分发与发送）

发送侧同样基于上下文：

#mermaid-svg-hpBnaoW77lHyDub6{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-hpBnaoW77lHyDub6 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-hpBnaoW77lHyDub6 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-hpBnaoW77lHyDub6 .error-icon{fill:#552222;}#mermaid-svg-hpBnaoW77lHyDub6 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-hpBnaoW77lHyDub6 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-hpBnaoW77lHyDub6 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-hpBnaoW77lHyDub6 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-hpBnaoW77lHyDub6 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-hpBnaoW77lHyDub6 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-hpBnaoW77lHyDub6 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-hpBnaoW77lHyDub6 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-hpBnaoW77lHyDub6 .marker.cross{stroke:#333333;}#mermaid-svg-hpBnaoW77lHyDub6 svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-hpBnaoW77lHyDub6 p{margin:0;}#mermaid-svg-hpBnaoW77lHyDub6 .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-hpBnaoW77lHyDub6 .cluster-label text{fill:#333;}#mermaid-svg-hpBnaoW77lHyDub6 .cluster-label span{color:#333;}#mermaid-svg-hpBnaoW77lHyDub6 .cluster-label span p{background-color:transparent;}#mermaid-svg-hpBnaoW77lHyDub6 .label text,#mermaid-svg-hpBnaoW77lHyDub6 span{fill:#333;color:#333;}#mermaid-svg-hpBnaoW77lHyDub6 .node rect,#mermaid-svg-hpBnaoW77lHyDub6 .node circle,#mermaid-svg-hpBnaoW77lHyDub6 .node ellipse,#mermaid-svg-hpBnaoW77lHyDub6 .node polygon,#mermaid-svg-hpBnaoW77lHyDub6 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-hpBnaoW77lHyDub6 .rough-node .label text,#mermaid-svg-hpBnaoW77lHyDub6 .node .label text,#mermaid-svg-hpBnaoW77lHyDub6 .image-shape .label,#mermaid-svg-hpBnaoW77lHyDub6 .icon-shape .label{text-anchor:middle;}#mermaid-svg-hpBnaoW77lHyDub6 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-hpBnaoW77lHyDub6 .rough-node .label,#mermaid-svg-hpBnaoW77lHyDub6 .node .label,#mermaid-svg-hpBnaoW77lHyDub6 .image-shape .label,#mermaid-svg-hpBnaoW77lHyDub6 .icon-shape .label{text-align:center;}#mermaid-svg-hpBnaoW77lHyDub6 .node.clickable{cursor:pointer;}#mermaid-svg-hpBnaoW77lHyDub6 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-hpBnaoW77lHyDub6 .arrowheadPath{fill:#333333;}#mermaid-svg-hpBnaoW77lHyDub6 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-hpBnaoW77lHyDub6 .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-hpBnaoW77lHyDub6 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-hpBnaoW77lHyDub6 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-hpBnaoW77lHyDub6 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-hpBnaoW77lHyDub6 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-hpBnaoW77lHyDub6 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-hpBnaoW77lHyDub6 .cluster text{fill:#333;}#mermaid-svg-hpBnaoW77lHyDub6 .cluster span{color:#333;}#mermaid-svg-hpBnaoW77lHyDub6 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-hpBnaoW77lHyDub6 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-hpBnaoW77lHyDub6 rect.text{fill:none;stroke-width:0;}#mermaid-svg-hpBnaoW77lHyDub6 .icon-shape,#mermaid-svg-hpBnaoW77lHyDub6 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-hpBnaoW77lHyDub6 .icon-shape p,#mermaid-svg-hpBnaoW77lHyDub6 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-hpBnaoW77lHyDub6 .icon-shape .label rect,#mermaid-svg-hpBnaoW77lHyDub6 .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-hpBnaoW77lHyDub6 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-hpBnaoW77lHyDub6 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-hpBnaoW77lHyDub6 :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

生成回复内容

创建发送意图

开始持久化

平台 I/O 发送

获取回执

提交/确认

返回调用方

核心是 Intent（意图）先于传输 I/O 存在：在尝试平台发送之前，出站消息意图已经持久化；成功后提交平台回执。这样即使在发送过程中崩溃，系统也具备至少一次的恢复能力。

sendDurableMessageBatch 返回明确的生命周期结果：

• sent：至少有一条可见的平台消息已传递
• suppressed：被钩子取消，不应投递
• partial_failed：部分成功、部分失败
• failed：全部失败

6. 一张图看懂 Channel Plugin 抽象层设计

#mermaid-svg-5lYJPGFmtEccGuzu{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-5lYJPGFmtEccGuzu .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-5lYJPGFmtEccGuzu .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-5lYJPGFmtEccGuzu .error-icon{fill:#552222;}#mermaid-svg-5lYJPGFmtEccGuzu .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-5lYJPGFmtEccGuzu .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-5lYJPGFmtEccGuzu .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-5lYJPGFmtEccGuzu .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-5lYJPGFmtEccGuzu .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-5lYJPGFmtEccGuzu .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-5lYJPGFmtEccGuzu .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-5lYJPGFmtEccGuzu .marker{fill:#333333;stroke:#333333;}#mermaid-svg-5lYJPGFmtEccGuzu .marker.cross{stroke:#333333;}#mermaid-svg-5lYJPGFmtEccGuzu svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-5lYJPGFmtEccGuzu p{margin:0;}#mermaid-svg-5lYJPGFmtEccGuzu .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-5lYJPGFmtEccGuzu .cluster-label text{fill:#333;}#mermaid-svg-5lYJPGFmtEccGuzu .cluster-label span{color:#333;}#mermaid-svg-5lYJPGFmtEccGuzu .cluster-label span p{background-color:transparent;}#mermaid-svg-5lYJPGFmtEccGuzu .label text,#mermaid-svg-5lYJPGFmtEccGuzu span{fill:#333;color:#333;}#mermaid-svg-5lYJPGFmtEccGuzu .node rect,#mermaid-svg-5lYJPGFmtEccGuzu .node circle,#mermaid-svg-5lYJPGFmtEccGuzu .node ellipse,#mermaid-svg-5lYJPGFmtEccGuzu .node polygon,#mermaid-svg-5lYJPGFmtEccGuzu .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-5lYJPGFmtEccGuzu .rough-node .label text,#mermaid-svg-5lYJPGFmtEccGuzu .node .label text,#mermaid-svg-5lYJPGFmtEccGuzu .image-shape .label,#mermaid-svg-5lYJPGFmtEccGuzu .icon-shape .label{text-anchor:middle;}#mermaid-svg-5lYJPGFmtEccGuzu .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-5lYJPGFmtEccGuzu .rough-node .label,#mermaid-svg-5lYJPGFmtEccGuzu .node .label,#mermaid-svg-5lYJPGFmtEccGuzu .image-shape .label,#mermaid-svg-5lYJPGFmtEccGuzu .icon-shape .label{text-align:center;}#mermaid-svg-5lYJPGFmtEccGuzu .node.clickable{cursor:pointer;}#mermaid-svg-5lYJPGFmtEccGuzu .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-5lYJPGFmtEccGuzu .arrowheadPath{fill:#333333;}#mermaid-svg-5lYJPGFmtEccGuzu .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-5lYJPGFmtEccGuzu .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-5lYJPGFmtEccGuzu .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-5lYJPGFmtEccGuzu .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-5lYJPGFmtEccGuzu .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-5lYJPGFmtEccGuzu .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-5lYJPGFmtEccGuzu .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-5lYJPGFmtEccGuzu .cluster text{fill:#333;}#mermaid-svg-5lYJPGFmtEccGuzu .cluster span{color:#333;}#mermaid-svg-5lYJPGFmtEccGuzu div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-5lYJPGFmtEccGuzu .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-5lYJPGFmtEccGuzu rect.text{fill:none;stroke-width:0;}#mermaid-svg-5lYJPGFmtEccGuzu .icon-shape,#mermaid-svg-5lYJPGFmtEccGuzu .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-5lYJPGFmtEccGuzu .icon-shape p,#mermaid-svg-5lYJPGFmtEccGuzu .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-5lYJPGFmtEccGuzu .icon-shape .label rect,#mermaid-svg-5lYJPGFmtEccGuzu .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-5lYJPGFmtEccGuzu .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-5lYJPGFmtEccGuzu .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-5lYJPGFmtEccGuzu :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

Core Engine

ACP 消息总线

Channel Plugin 层

用户入口

Telegram

飞书

钉钉

WhatsApp

Discord

TelegramPlugin

FeishuPlugin

DingPlugin

WhatsAppPlugin

DiscordPlugin

统一消息模型入站

统一消息模型出站

会话管理sessionKey

Agent Loop推理/工具调用

消息分发调度/路由

7. 结语：让渠道适配成为“可插拔”

OpenClaw Channel Plugin 接口的设计智慧可以概括为三句话：

当你需要给 Agent 系统新增一个渠道时，不需要修改一行核心代码，只需实现一个 Channel Plugin 并注册到系统中。 这正是抽象层的核心价值：把“多渠道接入”从架构负担转化为可组合能力，让开发者用最低成本接入新平台。