$ cat ~/map/pi-telegram.md

Pi Telegram

Telegram 机器人配对活跃 pi 会话：仅限所有者输入、转向与富文本回复。

tools✓ 9月10日

事实速查

安装

pi install npm:@comput/pi-telegram

## 速览

面向活跃 pi 会话的 Telegram 前端：一个项目机器人配对一个会话，仅限所有者输入、! 前缀转向、跟进请求，推理过程不外发，回复以原生 Rich Messages 呈现。

$将一个项目专属机器人与一个活跃 pi 会话配对；getMe 令牌校验通过后，手动创建的机器人经一次性配对码完成配对并确立所有者身份。
$输入语法：普通消息发起独立的跟进请求，!message 中途转向当前工作，!!message 发送字面上的前导 !，stop 或 /stop 取消当前 Telegram 任务。
$Telegram 先展示原生 Rich Thinking 或工具活动草稿，首次公开消息出现后替换为一行持续演进的纯文本进度提示；隐藏推理与原始工具流量不会离开本机。
$管理者模式下，由上报 can_manage_bots 的管理者机器人经审批链接创建项目机器人，用户名必须显式指定；手动模式则使用自建机器人。模式决定与全局管理者配置存于 ~/.pi/agent/pi-telegram/settings.json。
$各项目的机器人凭据存放在 .pi/pi-telegram.local.json 并自动加入本地 Git 排除列表；令牌绝不通过模型工具参数或聊天接收。
$telegram_send_file 工具把项目文件作为原生 Telegram 文档上传，规范路径限定在当前项目内并屏蔽凭据、私钥、环境变量与 .git 文件，受 Telegram 50 MB 上传上限约束，可选说明文字最长 1024 字符。
$配置与状态以 pi 斜杠命令运行：/telegram-setup、/telegram-setup-manager、/telegram-setup-bot 与 /telegram-status；完成的回复持久化为原生 Telegram Rich Messages。

Q Pi Telegram 与普通的 Telegram 桥接有何不同？

它是 pi 原生的：配置、配对与状态查询都作为 pi 斜杠命令运行，连接按项目存放在 .pi/pi-telegram.local.json，完成的回答持久化为原生 Telegram Rich Messages 而非纯文本气泡。

Q 谁能与机器人对话？

只有已配对的所有者——Pi Telegram 只接受配对码确立的所有者发来的私聊文本，绝不把隐藏推理或原始工具结果发到 Telegram。