Hermes 安装教程

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，粘贴提前申请好的 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，不填则任何人都能用你的 Bot），Home Channel ID 可以留空后续再配。最后问是否安装为系统服务（launchd），选 Y 可以开机自启、后台常驻：

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

申请 Telegram Bot

1. 在 Telegram 搜索 @BotFather
2. 发送 /newbot，按提示取名（用户名必须以 bot 结尾）已经存在的名字不能取
3. 拿到 Bot Token，格式类似 123456789:AAxxxxxxxx

启动成功

配置完成后运行 hermes 启动，欢迎页，说明一切正常：

打开 Telegram，找你的 Bot 发消息测试：

完成配置

手动挡安装

克隆项目：

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 — 诊断问题