需完成Telegram Bot Token注册、Webhook或轮询模式配置及Agent端通道绑定；依次创建Bot获取Token、通过hermes onboard注入Token并选通信模式、验证双向连通、配置systemd守护服务、可选设置Bot隐私权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署Hermes Agent并希望其通过Telegram持续接收指令、执行任务且保持全天候在线，则需完成Telegram Bot Token注册、Webhook或轮询模式配置、以及Agent端通道绑定。以下是实现该目标的具体操作路径：
一、创建Telegram Bot并获取Token
Telegram Bot由BotFather统一管理，所有Bot必须经其创建并获得唯一认证凭证。该Token是Hermes Agent与Telegram服务器建立通信的密钥，不可泄露或重复使用。
1、在Telegram中搜索并打开@BotFather账号。
2、发送消息 /newbot 启动创建流程。
3、按提示输入Bot名称（显示名）和用户名（以_bot结尾，如hermes_demo_bot），BotFather将返回包含token的一段完整文本。
4、复制其中形如 1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef 的字符串，此为后续配置必需项。
二、配置Hermes Agent的Telegram通道
Hermes Agent支持原生Telegram后端集成，无需额外代理服务。配置过程通过环境变量或交互式onboard流程注入Bot Token，并启用Telegram监听模块。
1、进入Hermes Agent运行目录，执行 hermes onboard 命令启动向导。
2、当提示选择消息通道时，输入数字对应选项，确认选择 Telegram。
3、系统将要求输入Bot Token，粘贴上一步获取的完整字符串。
4、确认是否启用 webhook 模式（推荐用于公网可访问服务器）或 polling 模式（适用于内网或NAT穿透受限环境）。
5、若选webhook，需确保服务器具备HTTPS公网地址，并允许Telegram IP段（149.154.160.0/20）发起POST请求。
三、验证Telegram与Agent双向连通性
完成配置后，Hermes Agent将启动Telegram监听线程，并注册自身为Bot的可用服务端点。此步骤用于确认消息可被正确接收、解析并触发响应，排除网络策略或权限阻断。
1、在Telegram中搜索并私聊刚创建的Bot用户名（如@hermes_demo_bot）。
2、发送任意文本，例如 /ping 或 hello。
3、观察Hermes Agent终端是否输出类似 [TG] Received message from @user_id: hello 的日志行。
4、检查Telegram聊天窗口是否收到回复，如 Hello! Hermes Agent is online.。
5、若无响应，执行 hermes logs --tail 50 查看最近错误日志，重点关注 telegram 和 webhook 相关条目。
四、启用7×24小时守护与自动恢复
Hermes Agent默认不自带进程守护机制，需配合系统级服务管理器确保崩溃后重启、开机自启及资源隔离，从而保障Telegram通道长期稳定在线。
1、在Linux服务器上创建systemd服务文件：/etc/systemd/system/hermes-telegram.service。
2、写入内容包含 ExecStart=/usr/local/bin/hermes --backend telegram 及 Restart=always 等关键指令。
3、执行 sudo systemctl daemon-reload 刷新配置。
4、执行 sudo systemctl enable hermes-telegram.service 设置开机自启。
5、执行 sudo systemctl start hermes-telegram.service 启动服务，并用 systemctl status hermes-telegram 验证运行状态。
五、限制Telegram Bot访问范围（可选安全加固）
为防止未授权用户滥用Bot接口，可通过Telegram BotFather设置隐私模式与群组权限，缩小攻击面，同时不影响Hermes Agent对指定用户或群组的响应能力。
1、再次打开 @BotFather，发送 /setprivacy。
2、选择对应Bot，设置为 Enable，使Bot仅接收其所在群组中的@提及或私聊消息。
3、如需在特定群组中启用，先将Bot添加进群，再发送 /setjoingroups 并禁用群组添加权限，仅保留目标群组。
4、对高敏感场景，可进一步使用 /setcommands 定义白名单命令集，如 start - 启动助手、status - 查看运行状态。
