$ cat ~/map/pi-telegram-gateway.md

Pi Telegram Gateway

基于官方 SDK 的 Telegram 网关：独立会话、消息排队与定时任务。

tools✓ 9月8日

事实速查

## 速览

基于官方 SDK 的 pi Telegram 网关：分聊天持久会话、pi 忙碌时消息自动排队、/steer 中途转向、/cron 定时自治任务，以及实时的节流工具通知。

## 要点

$把 pi 的完整工具面——bash、read、write、edit，以及已安装的技能与扩展——放到基于官方 @earendil-works/pi-coding-agent SDK（配合 grammY 与 croner）的 Telegram 机器人之后。
$每个 Telegram 聊天拥有独立的持久对话历史与上下文管理。
$pi 忙碌时发来的消息会自动排队为跟进任务；/steer <instruction> 可在执行中途调整 agent 方向。
$/cron 创建定时自治后台任务（如每日简报）；工具通知实时流式推送并带节流。
$配置流程：BotFather 令牌 → .env（TELEGRAM_BOT_TOKEN，可选 ALLOWED_USERS）→ bun run start；npm run daemon 提供自动重启的后台运行（Termux 唤醒锁），另有 4080 端口上的 /health 回环健康检查端点。

## 常见问题

Q 多方可以共用一个网关吗？

在 .env 里设置 ALLOWED_USERS 限定谁能与机器人对话；每个聊天都保留独立的持久会话与上下文。

Q 如何长期保持运行？

npm run daemon 以自动重启的后台进程方式运行（Android 上带 Termux 唤醒锁），npm run status 报告实时健康状态——网关还在 4080 端口暴露 /health JSON 端点。

## 参考链接

## 相关条目

## 教程

最后更新: 2026年9月8日