Telegram 是最轻量即时的 Hermes Agent 手机接入方式，需创建 Bot 获取 Token、配置网关、启动服务、可选 Docker 部署，并优化置顶与通知设置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在手机端快速调用 Hermes Agent 的 AI 能力，Telegram 是最轻量、最即时的接入方式。以下是完成 Telegram 机器人搭建并实现手机端随时交互的完整操作流程：
一、创建 Telegram Bot 并获取 Token
此步骤用于在 Telegram 官方平台注册一个专属 Bot 实例，获得唯一通信凭证（Bot Token），这是 Hermes Agent 与 Telegram 服务端建立连接的基础身份标识。
1、在手机或电脑端打开 Telegram 应用，搜索并关注官方机器人 @BotFather。
2、向 @BotFather 发送指令 /newbot。
3、按提示依次设置 Bot 的显示名称（如 Hermes AI 助手）和用户名（必须以 _bot 结尾，例如 hermes_ai_bot）。
4、成功后，@BotFather 将返回一段形如 123456789:AAHabcdefghIJKLMNOpqrstuvWxyz 的 Bot Token，请立即复制并安全保存——该 Token 后续不可再次查看。
二、配置 Hermes Agent 接入 Telegram 网关
此步骤将 Bot Token 注入 Hermes Agent 的配置系统，启用 Telegram 消息网关模块，使本地或远程运行的 Hermes 实例能接收并响应 Telegram 消息。
1、确保已安装 Hermes Agent 并处于可运行状态（若未安装，请先执行 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash）。
2、在终端中执行命令：hermes gateway setup。
3、在交互式菜单中选择 Telegram 作为目标网关。
4、粘贴上一步保存的 Bot Token，并确认提交。
5、如需限制仅本人可用，可在配置中添加 allowed_users 字段，值为您的 Telegram 用户 ID（可通过 @userinfobot 获取）。
三、启动 Hermes Agent 并验证连接
此步骤激活已配置的 Telegram 网关，使 Hermes Agent 开始监听 Telegram 消息队列，并建立双向通信链路。
1、在终端中执行：hermes restart，强制重新加载全部网关配置。
2、观察终端输出，确认日志中出现类似 [telegram] Gateway started, polling enabled 的提示信息。
3、回到手机 Telegram 应用，搜索您设定的 Bot 用户名（如 hermes_ai_bot）。
4、点击进入聊天界面，发送任意消息（例如 你好），等待 Hermes Agent 返回响应。
四、手机端免配置直连方案（备用）
若无法在服务器端直接运行 Hermes Agent，可采用 Docker 容器化部署方式，将 Hermes 运行环境封装为可移植服务，通过公网地址反向代理接入 Telegram。
1、在支持 Docker 的云服务器或本地设备上执行：docker pull nousresearch/hermes-agent:latest。
2、运行容器并挂载配置目录：docker run -d --name hermes-tg -v ~/.hermes:/opt/data -p 3000:3000 nousresearch/hermes-agent:latest。
3、确保服务器防火墙放行端口 3000，并在 Telegram BotFather 中使用 /setwebhook 指令（非必需，仅当启用 webhook 模式时使用）。
4、手机端仍通过搜索 Bot 用户名发起对话，所有消息经 Telegram 服务器转发至容器内 Hermes 实例处理。
五、手机端快捷访问优化设置
此步骤提升日常使用效率，将 Hermes Bot 固定于 Telegram 主界面顶部，并启用通知免打扰策略，兼顾即时性与静默体验。
1、在 Telegram 聊天列表中长按已创建的 Bot 名称，选择 置顶。
2、进入该 Bot 聊天窗口 → 点击右上角「…」→ 「通知」→ 关闭 声音，开启 显示预览 和 桌面通知（如需）。
3、发送首条消息前，可先输入 /start 触发初始化问候，确认上下文记忆与技能加载正常。
