@bytesbrains/pi-telegram-bridge
为Pi AI Agent提供Telegram消息收发能力的桥接工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@bytesbrains/pi-telegram-bridge。 它的用途是：为Pi AI Agent提供Telegram消息收发能力的桥接工具。 完整的 Skill 内容见：https://321skill.com/skills/bytesbrains-pi-telegram-bridge/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用Telegram桥接，向用户@john_doe发送问题‘您希望预约什么时间？’并等待回复。”，它会通过配置好的Bot发送消息，然后挂起当前任务流，直到在Telegram中收到该用户的回复后，再将回复内容返回给你的Agent进行处理。
介绍
这个Skill解决了Pi AI Agent与真实世界用户通过Telegram进行异步、持续交互的难题。传统的AI对话往往局限于单次会话或特定平台，而该桥接工具让部署在Pi平台上的Agent能够像一个真正的Telegram机器人一样，主动发送消息、提出问题，并持续监听来自用户的回复，从而建立起跨越时间的对话线程。
使用它，你需要先在Telegram上通过@BotFather创建一个机器人并获取API Token，然后在你的Pi Agent代码中安装并配置此Skill，将Token与你的Agent逻辑绑定。之后，你的Agent就可以通过调用相应的方法，向指定的Telegram用户或群组发送文本消息，并处理接收到的回复，实现双向通信。
它非常适合那些希望将自己的Pi AI Agent能力扩展到Telegram平台的开发者、产品经理或自动化流程构建者。例如，你可以构建一个通过Telegram通知状态的监控Agent、一个在Telegram中提供客户服务的问答Agent，或者一个接收用户指令并执行任务的个人助手Agent。
在使用时，建议妥善保管你的Telegram Bot Token，避免泄露。由于Telegram API的限制和网络环境因素，需要注意消息发送的速率限制和可能的消息延迟。确保你的Agent逻辑能够妥善处理消息发送失败和超时的情况，以提供更稳定的服务。
核心特点
这是专为Pi Agent平台设计的原生Telegram桥接方案，深度集成Pi的运行时环境，无需额外中转服务器；同时，它专注于实现Agent与人类之间可持续的、带上下文的对话线程，而非简单的单向消息推送。
注意事项
不适合需要与微信、Slack等其他即时通讯平台集成，或要求极高实时性（如毫秒级响应）的场景。
常见问题
需要自己准备Telegram机器人吗？
是的，需要先在Telegram上创建Bot并获取Token。
能用在群组聊天里吗？
可以，只要将你的Bot添加到群组并赋予相应权限即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/bytesbrains-pi-telegram-bridge/raw/index.md 读取 @bytesbrains/pi-telegram-bridge 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/bytesbrains-pi-telegram-bridge/raw/index.md（查看排版版本）