Hermes Agent完整教程：本地部署+Telegram机器人接入

type

Post

status

Published

date

Apr 12, 2026

slug

hermestelgram

summary

村长硬核教程：国内本地电脑部署 Hermes Agent 避坑指南。手把手教你配置 Python 依赖、解决 Telegram 机器人连接超时，并提供 Windows 专属兼容性补丁下载。

一、安装 Hermes（快速流程）

在开始之前，请确保你的电脑处于科学上网环境，国内原生网络无法完成部署。

1. Windows 一键安装

以管理员身份运行 PowerShell，输入以下命令：

PowerShell

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

配置建议： 出现提示时选择 Quick setup（快速安装）。

模型选择： 村长使用的是 MiniMax 2.7，实测响应速度与逻辑水平非常平衡。有能力者建议gpt最新模型

2. 常用管理命令

如果安装后窗口关闭，或需要重新调整，请记好这几个“后悔药”命令：

重启服务： hermes

全部重新配置： hermes setup

仅修改 AI 模型： hermes setup model

配置 Telegram/微信网关： hermes setup gateway

二、 Telegram 机器人深度接入

1. 基础对接流程

在配置平台时选择：Telegram。

在 Telegram 搜索 @BotFather，创建 Bot 并获取 API Token。

将 Token 粘贴回命令窗口（注意：窗口处于安全保护，不会显示字符，粘贴后直接回车即可）。

2. 权限安全设置（重要）

为了防止别人盗用你的机器人，必须设置只允许自己的账号使用：

在 Telegram 搜索 @userinfobot 获取你的账户 ID。

在 Hermes 配置中填入该 ID。

三、避坑指南：机器人没反应怎么办？

这是村长研究了一下午才搞定的核心环节。如果你的 Telegram 机器人“装死”，请按以下步骤排查。

1. 检查依赖环境

新开一个 PowerShell 窗口，输入 hermes gateway。如果报错 python-telegram-bot not installed，请依次运行以下命令安装依赖：

PowerShell

# 进入 Hermes 核心目录
cd $env:LOCALAPPDATA\hermes\hermes-agent

# 安装并升级环境依赖
.\venv\Scripts\python.exe -m ensurepip
.\venv\Scripts\python.exe -m pip install --upgrade pip
.\venv\Scripts\python.exe -m pip install python-telegram-bot

2. 配置国内网络代理（核心）

如果你在境内，Hermes 默认连不上 Telegram 接口。你需要把梯子的 监听端口 喂给它（以常用端口 7890 为例）：

PowerShell

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
hermes gateway

注：请将 7890 替换为你实际使用的代理端口（如 Clash 或 V2Ray 的设置）。

3. Windows 兼容性终极补丁

如果设置完代理依然报错，可能是 status.py 文件在 Windows 上的兼容性 bug。

文件路径： C:\Users\你的用户名\AppData\Local\hermes\hermes-agent\gateway\status.py

解决方案： 替换该文件。

补丁下载： 点击前往夸克网盘下载替换文件【夸克网盘】

💡 常见问题 (FAQ)

Q: 为什么我输入 API Token 时屏幕没反应？A: 这是为了安全设计的。实际上内容已经粘贴进去了，你直接敲回车键即可。

Q: 每次重启电脑都要重新设置代理端口吗？A: 是的，在当前会话中设置的临时环境变量关闭后会失效。建议将代理命令写成一个 .ps1 脚本，下次一键运行。

🎁 更多实用资源与干货下载

📂 资源全地图： 【点击跳转：村长的资源导航中心】 —— 一站式检索所有工具与教程

💾 高速下载通道：【夸克网盘】

💬 加入技术社区： 如果下载链接失效或有安装疑问，请在【电报群】留言。