Hermes Agent 安装与配置实战

如果你想快速搭建一个可用的 AI Agent，并接入 Telegram 做消息交互，Hermes Agent 是一个很实用的开源方案。

Hermes 由 Nous Research 开源，核心能力包括：

学习循环（可在使用中持续积累能力）
接入 15+ 模型提供商
跨平台消息集成（Telegram / Discord / Slack / WhatsApp）

下面按「自动安装（推荐）→ 配置向导 → 启动验证」一步步操作。

自动安装（推荐）

Mac / Linux 环境

在终端执行：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Windows 环境

在 PowerShell 执行：

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

安装脚本会自动检查并安装 Python、Node.js、Git、ripgrep 等依赖，等待执行完成即可：

安装脚本运行中

配置向导

安装完成后会自动进入向导，先选择 Quick setup（推荐）：

选择 Quick setup

在 Inference Provider 步骤中，输入你的 OpenRouter API Key（没有的话先去申请）：

填写 OpenRouter API Key

随后选择默认模型。免费模型很多，这里可以用 nvidia/nemotron-3-super-120b-a12b:free：

选择默认模型

接下来配置消息平台，选择 Set up messaging now：

配置消息平台

选择 Telegram，粘贴 Bot Token（申请方法见下文）并确认：

填写 Telegram Token

然后设置 Allowed user IDs（建议只填你自己的 Telegram 数字 ID；不填则可能被任何人调用）。

Home Channel ID 可以先留空，后续再补。最后会询问是否安装为系统服务（launchd），选择 Y 可实现开机自启与后台常驻：

完成 Telegram 配置

怎么查自己的 Telegram 数字 ID

在 Telegram 里给 @userinfobot 发任意消息，它会回复你的 ID。

申请 Telegram Bot

在 Telegram 搜索 @BotFather
发送 /newbot，按提示取名（用户名必须以 bot 结尾）
拿到 Bot Token，格式类似 123456789:AAxxxxxxxx

启动成功

配置完成后执行 hermes，看到欢迎页基本就说明安装成功：

Hermes 启动成功

再去 Telegram 给你的 Bot 发一条消息做连通性测试：

Telegram 测试成功

手动安装（适合进阶用户）

克隆项目：

git clone https://github.com/nousresearch/hermes-agent.git
cd hermes-agent

安装依赖：

pip install -r requirements.txt

运行：

python -m hermes

手动安装和自动安装的使用方式一致，适合需要改源码、锁版本或自定义部署流程的场景。

基本使用

hermes                     # 启动交互式对话
hermes model               # 选择模型提供商和模型
hermes tools               # 配置启用哪些工具
hermes config set          # 设置单个配置项
hermes gateway             # 启动消息网关（Telegram、Discord 等）
hermes setup               # 重新运行完整配置向导
hermes claw migrate        # 从 OpenClaw 迁移配置
hermes update              # 更新到最新版本
hermes doctor              # 诊断问题

常见问题 & 排错

Q: 提示 API call failed after 3 retries: HTTP 400: No models provided

原因：配置文件编码问题（Windows 常见）。

解决：检查相关文件读写是否显式指定 UTF-8 编码。例如在 open() 中补充 encoding="utf-8"，再重新运行。

Windows 编码报错修复

Q: Telegram Bot 没有响应

原因：通常是未正确设置 Allowed user IDs，或填写的 ID 不匹配。

解决：回到配置里确认你的 Telegram 数字 ID 是否正确，并重启 Hermes 后再测试。

Subscribe