Hermes 接 Telegram

一句话：这个项目是干什么的

适合想把 AI 放进 Telegram、又不想让它乱动你电脑的人。做完你应该能回答：消息怎么从 Telegram 到 AI、AI 怎么回消息、怎么限制 AI 只能在受控范围内工作、出问题怎么第一时间停下来。群里用的是共享会话，别在群里聊私密事。

原理篇：先懂，再动手

整体分四层，缺一层都不完整：

你在 Telegram 里 @ 机器人 / 发命令
        │  Telegram Bot API
        ▼
本机网关（只监听本地地址，负责收发消息、会话管理）
        │  调用模型 API
        ▼
模型服务（免费档轮换制，单个模型没有永久保留承诺）
        │
        ▼
回答回到 Telegram，同时写日志、接受看门狗巡检

关键判断标准：网关只监听本地地址，不直接暴露到公网；机器人进群后是普通成员，不是管理员；群里只在被 @、被回复或收到命令时才回应，平时不插话；AI 的工具集要分级，默认只开轻量工具，代码执行、子代理、定时任务、浏览器、电脑操控、账号连接这些高危能力默认关着，扩权要走“机器人提出、主助手审核、用户批准、主助手配置”三步，不能自扩权。

模型取向是稳定性优先于强度：免费名单是轮换制，探活发现某个模型被下架或失联时，按事先定好的顺序自动切换并重启网关，主模型连续两轮探活健康后再自动切回。不要把某个免费模型当成永久可用的。

四层架构表

动手篇：一步一步，从零到跑通

1. 准备清单

一个 Telegram 机器人（在 BotFather 里建好）、一台能长期跑网关的本机或服务器、一个模型服务的账号与密钥、一份项目档案（目标、已定决定、状态、绝不公开清单）。密钥只放环境文件，不进聊天、记忆和公开页面。

2. 建网关，跑通私聊

先让网关在本机跑起来，确认它只监听本地地址，再用私聊测通一轮问答：你发消息、网关收到、模型返回、回答回到 Telegram。私聊没通，不要急着进群。

3. 进群，关隐私模式，设只 @ 才回应

机器人进群后，先处理好 Telegram 的隐私模式问题：超级群里 @ 更新不投递时，常见原因是隐私模式没关，关掉后移出重加群才能生效。再设成只在被 @、被回复或收到命令时回应，避免机器人在群里乱插话。进群后先做两轮实测：一轮是你自己 @，一轮是群里另一位成员 @，都通了才算群里跑通。

4. 定工具集和受控区

把 AI 的工作目录钉在受控区，建项目或存占空间的东西要先向用户报备获许可。工具集先定为轻量档：联网、看图、读写受控区文件、查会话、记待办、澄清问题可以开；代码执行、子代理、定时任务、浏览器、电脑操控、账号连接默认关。以后要扩权，必须经过审核和用户批准。

5. 上看门狗和熔断

看门狗定期巡检 AI 的工具调用，发现受控区外写、改、删，碰密钥配置或主助手档案，改系统服务等越界行为，立即停网关并收回最小集，先斩后奏，事后报告。报告规则也要定好：只报异常，健康巡检、静默重启成功不再单独发消息，只记日志；只报熔断、模型切换或全灭、凭证问题、越界、修复失败这些真正需要人处理的事。

6. 做每日新闻，再做事后审计

每日新闻要先定标准再跑：什么算合规来源、什么格式、发到哪个话题、几点发，都要写进标准文件。光靠提示词拦不住带病照发，要另加发前机器门，或者解决原文提取被拦截的问题。事后审计要只读：通过则静默，不合格则报用户等点头才补发，绝不自行重跑。

坑与排查篇：真实踩过的坑，对号入座

• 群里 @ 了没反应：先查隐私模式是不是关了、是不是移出重加了、是不是只 @ 才回应的规则没生效，不要一上来就怀疑模型坏了。
• 机器人权限过大：进群就给管理员是最常见的错。普通成员就够了，需要的功能靠 @ 和命令触发，不靠管理员权限。
• 工具越界：AI 在受控区外写文件、碰密钥、改系统服务，必须靠看门狗熔断来拦，不能只靠口头约定。
• 凭据写进日志：网关启动日志曾明文写过出口代理密码，引用或外发日志前必须先脱敏，凭据只放环境文件。
• 每日新闻带病照发：原文提取被拦截、搜索达到上限时，不要用失败提示代替新闻正文，也不要只发两条就当成版。标准要写清楚“几条才算成版”，审计要只读、等用户点头再补发。
• 模型突然失联：免费模型会下架、会轮换，不要写死一个模型，要有探活和自动切换顺序，主模型恢复健康后再切回。

长期维护篇：跑通之后才算真正会用

• 备份与恢复：网关是系统服务，本机系统目录不持久，恢复脚本要放在项目文件里，换机后能照着恢复。
• 权限复查：定期复查已授权限和相关日志，发现过度授权、明文凭据或异常访问要及时报告并给出修复办法。
• 看门狗与审计的开关：省资源时可以禁用、不要删除，恢复时重新启用即可，机器人和网关本身可以继续跑。
• 版本与标准：每日新闻标准、工具集、群授权这些决定，都要写进项目档案，改决定同步更新档案，不要只记在聊天里。

绝不公开

这个项目页只讲架构、方法和运维。机器人密钥、模型密钥、群组数字 ID、个人账号信息、环境文件内容，永远不会发到这个公开站上。读者按本文动手时，用的是读者自己的机器人和密钥。

下一步：从这个项目能带走什么

带走的不是一个机器人，而是一套“把 AI 放进真实聊天场景又管得住”的方法：分层架构、最小工具集、受控区、看门狗熔断、只报异常、标准先行、事后只读审计。这套方法换一个聊天平台、换一个模型，也能复用。