Telegram

工作原理

/add-telegram 技能引导你完成将 NanoClaw 连接到 Telegram 的全过程。无需手动编辑任何代码或配置文件——Claude Code 会以交互方式处理一切。

首先，技能检查你的 NanoClaw 安装状态，并通过技能引擎应用必要的代码变更。这会添加 TelegramChannel 类，安装 grammy 依赖，并将所有内容接入消息处理管道。如果你已经有 WhatsApp 等其他频道在运行，Telegram 会在不影响现有配置的情况下添加到其中。

接下来，你需要通过 @BotFather 创建一个 Telegram 机器人。技能会逐步引导你：为机器人命名、获取令牌，以及在你计划将机器人用于群聊时配置群组隐私设置。你将 Bot Token 粘贴回终端，技能会将其保存到你的环境变量中。

机器人上线后，你在希望 NanoClaw 运行的 Telegram 聊天中发送 /chatid 命令。技能会获取 Chat ID 并将其注册到数据库中。你可以注册多个聊天——一个作为主频道，其他作为仅触发或仅通知频道。

最后，技能运行验证步骤：通过机器人发送一条测试消息以确认一切已连接。如果出现问题，技能会针对常见问题（如令牌错误或群组隐私设置）提供具体的故障排除步骤。

频道模式

Telegram 在 NanoClaw 中支持三种注册模式：

• 主频道 ——完整的双向通信。你在此聊天中发送的消息会触发智能体，智能体在同一聊天中回复。
• 仅触发 ——此聊天中的消息会触发操作，但智能体通过你的主频道进行回复。
• 被动模式 ——智能体可以向此聊天发送通知，但此处的消息不会触发智能体。

当你希望使用 Telegram 发送快速指令而将 WhatsApp 保持为主要对话频道时，或者反过来使用时，这非常有用。

智能体集群

如果你在使用 NanoClaw 的智能体集群功能，Telegram 对多智能体群组提供一流支持。每个子智能体可以在群聊中拥有自己的机器人身份，这样你就能看到是哪个智能体在回复。/add-telegram-swarm 技能会在你的基础 Telegram 频道正常工作后单独处理此设置。

使用技巧

• 群聊需要在 @BotFather 中禁用”Group Privacy”，这样机器人才能读取所有消息，而不仅仅是针对它的命令。
• grammy 库高效处理 Telegram 的 Bot API，内置重试逻辑和速率限制。
• 与其他消息平台相比，Telegram 的速率限制更为宽松，非常适合产生较长回复的智能体交互。