tutorial channels

ZeroClaw 多频道配置:一个智能体同时连 Telegram + Discord + WhatsApp

ZeroClaws.io

ZeroClaws.io

@zeroclaws

2026年4月1日

7 分钟

ZeroClaw 多频道配置:一个智能体同时连 Telegram + Discord + WhatsApp

3 月 31 日,Telegram 发布了多年来最大的机器人平台更新。Bot API 现在允许机器人自主创建和管理其他机器人,每个 Telegram 客户端内置了 AI 驱动的文本编辑器。对 AI 智能体开发者来说,Telegram 变得更有吸引力了。

但大多数 AI 智能体不只活在一个平台上。你的团队用 Discord。你的家人用 WhatsApp。你的个人项目在 Telegram。ZeroClaw 多频道架构的威力在于一个智能体同时跑在所有平台上——同一个人设、同一份记忆、同一套工具,不同的界面。

下面教你怎么设置三个平台。

架构概览

ZeroClaw 的频道系统把每个消息平台当作一个独立的频道实现。频道是 Rust trait——每个平台实现相同的接口,底下是平台特定的逻辑。智能体不知道也不关心消息来自哪个平台。它处理消息、生成回复、通过来源频道发回去。

记忆跨频道共享。你在 Telegram 上的对话在 Discord 聊天时也能作为上下文。智能体是一个智能体——频道只是进入它的不同窗口。

频道一:Telegram

Telegram 是最容易设置的频道,也是对 AI 智能体最强大的。

创建你的机器人:

  1. 1.打开 Telegram,给 @BotFather 发消息
  2. 2.发送 `/newbot`
  3. 3.选择名字和用户名
  4. 4.复制 API token

配置 ZeroClaw:

添加到 `~/.zeroclaw/config.toml`:

```toml [[channels]] type = "telegram" token = "YOUR_BOT_TOKEN_HERE" allowed_users = [123456789] # 你的 Telegram 用户 ID ```

在 Telegram 上给 @userinfobot 发消息获取你的用户 ID。

Telegram 提供什么:

  • 机器人回复中的 Markdown 格式
  • 用于交互的内联键盘
  • 文件和图片收发
  • 群聊支持(机器人可以参与群对话)
  • 语音消息(ZeroClaw 通过 Whisper 集成处理)
  • 新 Bot API(2026 年 3 月)支持机器人管理的机器人——你的 ZeroClaw 智能体理论上可以为特定任务创建专用子机器人

Telegram 的优势: 零 API 摩擦。创建机器人、拿到 token、开始聊天。不需要企业验证,没有审批流程,不收使用费。这就是 Telegram 成为开发者默认 AI 机器人部署平台的原因。

频道二:Discord

Discord 集成几乎跟 Telegram 一样简单,对团队/社区场景支持更好。

创建你的机器人:

  1. 1.去 discord.com/developers/applications
  2. 2.点"New Application",起个名字
  3. 3.进"Bot"部分,点"Add Bot"
  4. 4.复制 token
  5. 5.在"Privileged Gateway Intents"下启用 Message Content Intent
  6. 6.生成邀请链接:OAuth2 -> URL Generator -> 选"bot"范围和"Send Messages"+"Read Message History"权限
  7. 7.打开邀请链接把机器人添加到你的服务器

配置 ZeroClaw:

```toml [[channels]] type = "discord" token = "YOUR_DISCORD_BOT_TOKEN" allowed_guilds = ["your_server_id"] command_prefix = "!" # 可选:只回复以 ! 开头的消息 ```

Discord 提供什么:

  • 用于格式化回复的 Rich embed
  • 线程支持(机器人可以为长对话创建线程)
  • Slash 命令实现结构化交互
  • 频道级权限(机器人可以限制在特定频道)
  • 语音频道集成(ZeroClaw 中实验性支持)

Discord 的优势: 为社区而生。如果你的智能体服务一个团队或 Discord 服务器,Discord 的权限模型和频道组织让限定智能体的访问和可见性变得自然。

频道三:WhatsApp

WhatsApp 是全球最受欢迎的消息平台,但也是 AI 智能体最难集成的。

官方方式: WhatsApp Business API 需要企业验证、Facebook Business Manager 账号和 Meta 的审批。流程需要几天到几周。这是商业部署的正确路径。

社区方式: Baileys 库提供了非官方的 WhatsApp Web API,通过模拟 WhatsApp Web 会话工作。ZeroClaw 支持这种集成。

Baileys 方式配置:

```toml [[channels]] type = "whatsapp" method = "baileys" data_dir = "~/.zeroclaw/whatsapp" allowed_numbers = ["+1234567890"] ```

首次启动时,ZeroClaw 会在终端显示一个二维码。用手机上的 WhatsApp 扫描(设置 -> 已关联设备 -> 关联设备)。这把你的 WhatsApp 账号链接到 ZeroClaw。

Baileys 的注意事项:

  • 不被 Meta 官方支持——他们随时可能封掉协议
  • 需要一部安装了 WhatsApp 的活跃手机
  • 会话会定期过期(过期时重新扫描二维码)
  • 速率限制比 Telegram/Discord 低
  • 不适合商业或高流量使用

WhatsApp 的优势: 覆盖面。你的非技术家人、客户和联系人都在 WhatsApp 上。如果你想让 AI 助手对不用 Telegram 或 Discord 的人也可达,WhatsApp 就是方式。

三个同时运行

完整的多频道配置:

```toml [provider] type = "openai-compatible" base_url = "http://localhost:11434/v1" model = "llama3.1:8b"

[agent] name = "Assistant" personality = "Helpful and concise. Adapt response length to the platform -- shorter on WhatsApp, can be longer on Discord."

[memory] type = "sqlite" path = "~/.zeroclaw/memory.db"

[[channels]] type = "telegram" token = "TELEGRAM_TOKEN" allowed_users = [123456789]

[[channels]] type = "discord" token = "DISCORD_TOKEN" allowed_guilds = ["guild_id"]

[[channels]] type = "whatsapp" method = "baileys" data_dir = "~/.zeroclaw/whatsapp" allowed_numbers = ["+1234567890"] ```

启动一次 ZeroClaw。三个频道同时连接。来自任何频道的消息都由同一个智能体用同一份记忆和工具处理。

跨频道记忆

多频道配置最强大的方面是共享记忆。在 Telegram 上问你的智能体关于一个项目的问题,然后在 Discord 上继续对话。上下文能衔接,因为记忆是集中存储的而不是按频道分的。

ZeroClaw 给每条记忆条目打上来源频道标签,所以你可以问"我昨天在 Telegram 上讨论了什么?"智能体能相应过滤。但默认情况下,不管你当前在哪个频道,所有上下文都可用。

平台选择指南

| 场景 | 最佳平台 | 原因 | |------|----------|------| | 个人助手 | Telegram | 最快上手,最好的 Bot API | | 团队/社区机器人 | Discord | 频道组织,权限管理 | | 家庭助手 | WhatsApp | 所有人都有 | | 开发/测试 | CLI | 无外部依赖 | | 以上全部 | 多频道 | 一个智能体,到处都在 |

从一个频道开始。按需添加更多。ZeroClaw 的频道系统是叠加式的——每个新频道是一个配置块,不是重新架构。

开始用 ZeroClaw 构建 AI Agent

获取新版本、集成和 Rust 驱动的 Agent 基础设施更新。不发垃圾邮件,随时退订。