Telegram

工作原理

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

首先，技能检查你的 NanoClaw 安装状态，并从 channels 分支复制 Telegram 适配器：src/channels/telegram.ts、其配对与 markdown 清理辅助模块，以及 pair-telegram 设置步骤。它会向 src/channels/index.ts 追加一条自注册导入语句，并安装固定版本的 @chat-adapter/telegram 包。如果你已经有 WhatsApp 等其他频道在运行，Telegram 会在不影响现有配置的情况下添加到其中。

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

机器人上线后，聊天会通过配对流程完成注册——你无需查找任何 Chat ID。技能会运行 pair-telegram 设置步骤并向你显示一个 4 位数字的配对码。你从希望注册的 Telegram 聊天中将该配对码作为消息发送：私信机器人以注册你的主频道，或在群组中发送（如果已开启群组隐私，需以 @botname 作为前缀），NanoClaw 便会注册该聊天。

技能会通过构建项目并运行频道注册测试来验证此变更。端到端的消息投递会在服务运行后，通过向机器人发送消息来进行验证。

将聊天关联到智能体

聊天通过 /manage-channels 关联到智能体群组。Telegram 的配对步骤接受一个意图参数——main、wire-to:<folder> 或 new-agent:<folder>——因此同一个 4 位配对码流程既可以注册你的主频道，也可以将聊天关联到现有智能体，或创建一个新的智能体。

每个关联都有一个会话模式：agent-shared（关联到该智能体的所有频道共享一个对话）、shared（相同的智能体和工作区，但对话线程相互独立）或 per-thread。若需要完全隔离，请将聊天关联到拥有独立文件夹的单独智能体群组。

使用技巧

• 群聊需要在 @BotFather 中禁用”Group Privacy”，这样机器人才能读取所有消息，而不仅仅是针对它的命令。
• 固定版本的 @chat-adapter/telegram 包通过 Chat SDK 桥接与 Telegram 的 Bot API 通信——技能会为你安装它。
• 与其他消息平台相比，Telegram 的速率限制更为宽松，非常适合产生较长回复的智能体交互。