Telegram

Telegram 是当前 Bub 核心中内置的远程 channel 适配器。

配置

环境变量由 TelegramSettings（src/bub/channels/telegram.py）读取。

必需：

BUB_TELEGRAM_TOKEN=123456:token

可选白名单（逗号分隔）：

BUB_TELEGRAM_ALLOW_USERS=123456789,your_username
BUB_TELEGRAM_ALLOW_CHATS=123456789,-1001234567890

可选代理：

BUB_TELEGRAM_PROXY=http://127.0.0.1:7890

消息行为

• Session id 为 telegram:<chat_id>。
• /start 由内置 channel 逻辑处理。
• /bub ... 会被接受并规范化为纯 prompt 内容。
• 非命令消息会被采集；活跃/后续行为由 channel 过滤元数据和 debounce 处理决定。

出站行为

• 出站消息通过 bot API 发送回 Telegram 聊天。
• 空的出站文本会被忽略。
• 如果出站内容是 JSON，当存在 "message" 字段时会优先使用。

访问控制

• 如果设置了 BUB_TELEGRAM_ALLOW_CHATS，未列出的聊天会被忽略。
• 如果设置了 BUB_TELEGRAM_ALLOW_USERS，未列出的用户会被拒绝。
• 在群聊中，生产环境的机器人应严格设置白名单。