Telegram 插件：架构与数据流
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)
(申请发送: agentupdate)
与官方桥接方案相比，Telegram 插件的架构更为去中心化。
组件架构
flowchart LR
subgraph Cloud[Telegram 云端]
BotAPI[Bot API]
end
subgraph Local[开发机]
Server[Bun MCP 服务器]
Access[(access.json)]
Inbox[(inbox/*)]
CLI[Claude Code CLI]
end
Phone[Telegram 客户端] <--> BotAPI
Server <--长轮询--> BotAPI
Server --- Access
Server --- Inbox
Server <--MCP Channels--> CLI数据流
- 入站 (Inbound): 用户发送消息 → Bot API → 本地服务器 (长轮询) → 校验 (access.json) →
<channel>通知发送至 CLI。 - 出站 (Outbound): 助手调用
reply→ 本地服务器 → Bot API → 消息到达客户端。 - 文件处理: 图片会自动下载到
~/.claude/channels/telegram/inbox/，因为 Bot API 不允许稍后获取旧图片。
配对状态机
stateDiagram-v2 [*] --> 陌生人 陌生人 --> 待定: 配对模式下的首条私聊 待定 --> 已允许: /telegram:access pair <代码> 已允许 --> 已允许: 后续私聊通过 已允许 --> [*]: /telegram:access remove