如何将 HappyCapy 连接到 Telegram：在任意对话中运行完整的 AI Agent
你的 HappyCapy agent ——连同它的全部工具、技能与能力——现可直接在 Telegram 中使用。
大多数 Telegram 机器人只会回答问题。HappyCapy 的 Telegram 桥接运行的是 claude --print——你发送的每一条消息都会触发一次完整的 Claude Code 会话，具备 Bash 访问权限、文件操作、网络搜索、图像生成，以及 300,000+ 个 Skills。让它抓取一个网站、编写并执行一段 Python 脚本、或者生成一段视频。它都能做到。这不是一个聊天机器人，而是一个恰好生活在你 Telegram 聊天里的智能体。
为什么这与 Telegram 机器人不同
构建一个 Telegram 机器人只是一个周末项目：在 BotFather 注册、获取一个 token、调用 Telegram Bot API、把收到的消息传给 LLM API、再返回结果。最终得到的只是一台精巧的自动补全机器。它没有文件系统，无法运行代码，无法触发工作流，做不了任何 LLM API 在单次无状态响应之外的事情。
HappyCapy 的架构在每一层都不一样。HappyCapy 在 Fly.io 上以一个始终在线的 Linux 沙箱运行——拥有 root 权限、Python 3.11、Node.js v24、持久化的文件存储。当你的 Telegram 消息到达时，桥接程序会以你的消息为输入调用 claude --print。这次调用拥有完整的工具访问权限：Bash 执行、文件读写、网络搜索、图像生成、视频生成，以及整个 300,000+ 的 Skills 库。智能体可以打开一个新的 shell、运行脚本、读取输出，并在同一个对话回合内把结果发回给你。
这两种方案之间的实际差距并不是渐进式的。一个普通的 Telegram 机器人只能告诉你天气情况。而 HappyCapy 的 Telegram 机器人可以编写代码，从三个 API 中拉取天气数据、进行对比、绘制图表、保存为 PNG，并以图片形式发给你——全部在一条消息内完成，你无需离开 Telegram。
| 功能 | 普通 Telegram 机器人 | HappyCapy Telegram 机器人 |
|---|---|---|
| 回答问题 | 是 | 是 |
| 运行 Bash 命令 | 否 | 是 |
| 编写并执行代码 | 否 | 是 |
| 访问持久化文件 | 否 | 是 |
| 生成 AI 图像 | 否（需要单独集成） | 是，原生支持 |
| 生成视频 | 否 | 是 |
| 网页抓取 | 否 | 是 |
| 访问 300,000+ Skills | 否 | 是 |
| 无需你的电脑即可 24/7 运行 | 否 | 是（Fly.io 常驻在线） |
| 按用户区分的对话历史 | 有限 | 完整、持久化 |
你实际能做什么
这份能力清单并非纸上谈兵，以下都是用户今天正在做的事情：
- 让机器人抓取一个网站，并以表格或 JSON 形式返回结构化数据
- 让它编写一段 Python 脚本，在沙箱中执行，并返回 stdout——完全不需要 IDE
- 根据提示生成一张 AI 图像，直接在 Telegram 聊天中收到
- 在对话中途触发 HappyCapy 的 300,000+ 个 Skills 中的任意一个——PDF 生成、电子表格创建、PPTX 幻灯片、音频合成
- 搜索网络、阅读多个来源，并返回带引用的综合摘要
- 创建文件并保存到持久化存储中，之后在后续消息中检索或更新
- 运行定时任务：智能体可以每天早晨运行一段脚本，并把输出发给你
- 监控某个 URL 或 API 端点，在发生变化时提醒你
- 处理上传的文档——粘贴一个 CSV 链接，获取分析结果
- 串联原本需要在五个不同工具之间切换才能完成的多步骤工作流
优点
- 始终在线，无需笔记本电脑。 沙箱运行在 Fly.io 基础设施上。你可以在凌晨两点用手机给机器人发消息，它会在一台你完全不需要接触的服务器上执行代码。
- 一个界面搞定一切。 无需先打开 Claude，再打开代码编辑器，再打开浏览器，再打开图像工具——一条 Telegram 消息就能触发所有这些操作。
- 上下文持续保留。 对话历史按用户存储。你可以引用三天前问过的内容，而无需重新解释上下文。
- 沙箱内拥有完整 root 权限。 智能体可以安装软件包、写入文件、运行任意 Unix 命令，没有消费级聊天机器人会施加的那些限制。
- 300,000+ 个 Skills 即刻可用。 任何已经打包为 HappyCapy Skill 的工作流，只需一句话即可调用。
- 可分享。 把机器人用户名分享给同事或客户，多个用户可以同时使用，各自拥有独立隔离的对话历史。
- 提供免费层级。 Telegram 桥接本身不会在你现有的 HappyCapy 套餐之上产生额外费用。
真实使用场景
把笔记本电脑落在办公室的自由职业开发者。 你推送了一个提交，在部署日志里发现了一个 bug，而你已经出门了。你从手机上给机器人发消息："从服务器拉取最新的部署日志，告诉我第 847 行报的是什么错。"三十秒后你就得到了答案。你回复："写一个补丁并开一个 PR。"搞定，全程没有打开笔记本电脑。
每天监控指标的小企业主。 无需每天早晨登录五个不同的仪表盘，机器人会运行一份定时摘要。每天早上 8 点：它从 Stripe 拉取营收数据、从分析 API 拉取访客数量、从 Shopify 拉取库存水平，整理成摘要，并在你喝完第一杯咖啡之前以 Telegram 消息形式发给你。整个设置只需要与机器人进行一次对话即可完成配置。
需要快速提取数据的研究人员。 你正在阅读一篇论文，想要与另外三个来源的数据集进行交叉比对。切换到浏览器、逐一访问每个来源、下载 CSV、再运行对比，需要 20 分钟。而把 URL 和需求说明发给机器人，只需要两分钟。机器人会完成抓取、解析、比对，并返回一张表格。
为孩子搭建作业助手的家长。 孩子们已经有了 Telegram 账号。HappyCapy 机器人被添加进了一个家庭群组，它可以逐步讲解数学题、生成图表、编写练习题并检查答案——没有广告、无需注册账号，也没有消费级聊天机器人那种令人分心的循环。家长保管管理员 token，孩子们则得到一个专注的工具。
如何设置
如果你已经拥有 HappyCapy 账号，设置只需不到五分钟。整个流程从 Telegram 的 BotFather 开始：给 @BotFather 发消息，运行 /newbot，选择一个名称，然后获得一个机器人 token——一串类似 7384920156:AAF... 的字符串。有了这个 token，HappyCapy 就知道该把对话路由到哪里。
在 HappyCapy 内部，Telegram skill 会处理剩下的一切。运行该 skill，在提示时粘贴你的机器人 token，桥接就上线了。该 skill 会在沙箱中启动一个轮询循环，监听传入的 Telegram 消息，并通过拥有完整工具访问权限的 claude --print 进行路由。对话历史按 Telegram 用户 ID 分别存储，因此每一个给你的机器人发消息的人，都拥有属于自己的持久化会话。
包含设置脚本、环境变量文档，以及限流和用户白名单配置选项在内的完整 skill，可在 github.com/ndpvt-web/happycapy-telegram 获取。如果你想在开始之前更深入地理解 HappyCapy 的智能体架构为何与典型的聊天机器人设置不同，AI Agent vs Chatbot 详细讨论了两者的区别。而如果你正在考虑搭建自己的持久化 AI 基础设施，而不是依赖 Fly.io，那么 Mac Mini as AI Server 2026 这篇解析文章值得先读一读。
常见问题
机器人是 24/7 运行，还是只有在我电脑开机时才运行？ 它是 24/7 运行的。沙箱运行在 Fly.io 的基础设施上，而不是你的本地机器。一旦你部署了 Telegram skill，即使你的电脑没有开机、甚至没有联网，它也会持续保持在线。
机器人能访问我的 HappyCapy 文件和工具吗？ 可以。机器人运行在你的 HappyCapy 沙箱内部，这意味着它可以访问该环境中的一切：你存储的文件、你安装的 skills、你设置的环境变量，以及你连接的任何集成。它就是你的智能体，只是换了一个访问入口。
这是免费使用的吗？ Telegram 桥接 skill 本身是免费的。你的成本由你的 HappyCapy 套餐决定，该套餐覆盖沙箱算力和 AI 模型使用。Telegram 集成层不会产生额外费用。
按用户区分的对话历史是如何工作的？ 每个 Telegram 用户 ID 都会在沙箱中拥有一条独立存储的对话线程。当用户 A 发送消息时，机器人会加载用户 A 的历史记录并追加新的一轮对话。用户 B 的消息则完全隔离。历史记录会跨会话持久保留——一周前的对话在上下文中依然可以访问，除非你明确清除它。
我可以限制谁能使用这个机器人吗？ 可以。该 skill 支持白名单配置。你可以指定一份允许与机器人交互的 Telegram 用户 ID 或用户名列表。不在白名单上的用户发来的消息，会被静默忽略，或者返回一条自定义的拒绝消息——由你决定。
如果 Telegram 对我的机器人进行限流怎么办？ 该 skill 通过指数退避来处理限流。如果 Telegram 返回 429 响应，桥接程序会暂停，等待所需的重试时间，然后自动恢复。你不会丢失任何消息。实际上，只有在非常高的并发负载下才会触发限流，而这一点在 skill 设置中是可配置的。
多个人可以同时使用这个机器人吗？ 可以。轮询循环是异步处理消息的，每个用户会话都是独立的。不存在某个队列会因为正在服务另一个用户而阻塞当前用户的情况。在负载非常高的情况下，你可以在 Fly.io 上扩展沙箱实例以支持更多并发会话——skill 文档中涵盖了相关配置说明。
结语
Telegram 集成不是为了功能而功能——它消除了你与一个功能完备的 AI 智能体之间的最后一道摩擦。你的 HappyCapy 沙箱已经能够运行代码、生成媒体内容、调度 300,000+ 个 Skills。而 Telegram 桥接意味着，无论你身在何处，都能访问这一切，无需任何上下文切换。无论是在凌晨两点远程调试时派上用场，还是在每天早晨、你打开笔记本电脑之前想要一份结构化简报时派上用场——都是同一个智能体，如今已经装进了每一个口袋。
