小学子讲技术 - OpenClaw 消息工具详解：跨平台消息发送机制

tianbaolc

228人浏览 · 2026-03-13 07:49:46

tianbaolc · 2026-03-13 07:49:46 发布

OpenClaw 消息工具详解：跨平台消息发送机制

大家好，我是小学子！今天要带大家深入了解一下 OpenClaw 的消息工具——这是实现跨平台智能交互的核心组件。如果你正在寻找一个能够统一管理 Discord、Slack、Telegram 等多个消息平台的解决方案，那这篇教程你可不能错过！

一、message 工具是什么？

message 是 OpenClaw 暴露的第一类工具（first-class agent tool），专门用于在多个即时通讯平台上发送消息和管理频道操作。它取代了传统的 openclaw-* 技能，提供类型安全的命令执行，让 AI 代理能够直接在各种聊天应用中交互。

简单来说，message 工具就是 OpenClaw 的"统一消息中枢"——无论你想发消息到 Discord、Telegram 还是 WhatsApp，都通过这一个工具完成。

二、支持哪些平台？

OpenClaw 的消息工具支持相当广泛的平台，真正实现了"一处配置，多端通行"：

主流社交平台：

Discord — 通过 Bot API + Gateway，支持服务器、频道和私信
Slack — 使用 Bolt SDK，支持工作区应用
Telegram — 通过 grammY 的 Bot API，支持群组
WhatsApp — 使用 Baileys 库，需要 QR 配对
Microsoft Teams — 通过 Bot Framework，支持企业场景

其他通讯渠道：

Google Chat — Webhook 方式接入
Signal — 通过 signal-cli，注重隐私
iMessage — 推荐使用 BlueBubbles（macOS 服务器）
IRC — 经典 IRC 协议支持
Feishu/Lark — 飞书机器人（需安装插件）
LINE — LINE Messaging API（需安装插件）
Matrix — 去中心化协议（需安装插件）
Mattermost — 自托管团队工具（需安装插件）

💡 小贴士：配置多个渠道后，OpenClaw 会根据聊天上下文自动路由，无需手动指定。

三、核心功能详解

message 工具提供了丰富的操作能力，分为几个大类：

1. 消息发送（send）

最基础也是最常用的功能——发送文本和媒体消息：

{
  "action": "send",
  "channel": "discord",
  "to": "channel:123456789",
  "message": "Hello from OpenClaw!"
}

对于 Microsoft Teams，还支持 Adaptive Cards（自适应卡片），可以实现丰富的交互界面：

{
  "action": "send",
  "channel": "msteams",
  "to": "user:123456",
  "card": {
    "type": "AdaptiveCard",
    "body": [...],
    "actions": [...]
  }
}

2. 互动功能

poll（投票）：WhatsApp、Discord、MS Teams 都支持创建投票
react / reactions（反应）：对消息添加 emoji 回应
thread 操作：创建帖子、列出帖子、回复帖子

3. 消息管理

read / edit / delete：读取、编辑、删除消息
pin / unpin / list-pins：固定消息和查看固定列表

4. 频道管理

channel-info / channel-list：获取频道信息和列表
member-info / role-info：获取成员和角色信息
emoji-list / emoji-upload / sticker-upload：emoji 和贴纸管理
role-add / role-remove：角色分配

5. 高级管理

event-list / event-create：日历事件管理
timeout / kick / ban：成员管理（禁言、踢出、封禁）
voice-status：语音频道状态
permissions：权限管理
search：搜索消息

四、消息路由机制

这是理解 OpenClaw 消息工具的关键！

直接路由 vs Gateway 路由

WhatsApp：消息通过 Gateway 路由（因为需要状态管理）
其他平台（Discord、Slack、Telegram 等）：直接连接

这种设计有什么意义呢？简单来说：

WhatsApp 需要在磁盘上存储配对状态，所以通过 Gateway 中转
其他平台有成熟的 Bot API，直接连接更快更高效

会话绑定安全机制

当 message 工具调用绑定到活跃的聊天会话时，发送会被限制在该会话的目标中。这防止了跨上下文泄露——简单来说，就是"在 Discord 收到的消息，只会回复到 Discord，不会串到 Telegram"。

回复路由规则

以 Discord 为例：

私信（DM）默认共享主会话（agent:main:main）
服务器频道有独立的会话（agent:<agentId>:discord:channel:<channelId>）
原生斜杠命令在隔离的命令会话中运行

五、配置示例

1. 启用消息工具

在 openclaw.json 中配置工具权限：

{
  tools: {
    profile: "messaging",  // 使用消息配置
    allow: ["discord", "slack", "telegram"]
  }
}

2. Discord 完整配置

{
  channels: {
    discord: {
      enabled: true,
      token: "YOUR_BOT_TOKEN",
      // 访问控制
      dmPolicy: "pairing",  // 配对模式
      groupPolicy: "allowlist",  // 服务器白名单
      guilds: {
        "YOUR_SERVER_ID": {
          requireMention: false,  // 无需 @ 也能回复
          users: ["YOUR_USER_ID"]
        }
      }
    }
  }
}

3. 多平台同时启用

{
  channels: {
    discord: { enabled: true },
    slack: { enabled: true },
    telegram: { enabled: true },
    whatsapp: { enabled: true }
  }
}

六、实战：发送一条消息

通过 Agent 发送

只需要告诉你的 OpenClaw 代理：

“请在 Discord 的 #general 频道发送一条消息：‘团队会议将在下午3点开始’”

代理会自动调用 message 工具完成发送。

通过 CLI 发送

openclaw message send --channel discord \
  --target channel:123456789 \
  --message "团队会议将在下午3点开始"

通过 API 发送

{
  "action": "send",
  "channel": "telegram",
  "to": "chat:123456789",
  "message": "Hello from OpenClaw API!"
}

七、高级特性：交互式组件

Discord 平台支持丰富的交互式组件，包括：

按钮（Buttons）：可设置样式（success、danger、primary）和权限
选择菜单（Select）：支持 string、user、role、channel 等类型
模态表单（Modal）：最多 5 个字段，支持文本、复选框、单选、选择器

{
  "action": "send",
  "channel": "discord",
  "to": "channel:123456",
  "message": "请选择操作：",
  "components": {
    "blocks": [
      {
        "type": "actions",
        "buttons": [
          { "label": "批准", "style": "success" },
          { "label": "拒绝", "style": "danger" }
        ]
      }
    ]
  }
}