Hermes Agent 简介
Hermes Agent 是 Nous Research 推出的开源 AI Agent 框架,被视为新一代的 OpenClaw。它支持建立自学习循环(通过使用不断积累技能)、接入超过 15 家模型提供商,并实现跨平台消息集成(Telegram、Discord、Slack、WhatsApp)。
苏米注:回想一下,不久前有多少人在闲鱼上享受了 OpenClaw 的红利,现在你也可以通过 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(推荐):

配置 Inference Provider
接下来进入 Inference Provider 配置,系统会提示输入 OpenRouter API Key。请粘贴提前申请好的 Key 后回车:

然后选择默认模型。列表中有很多免费模型,这里选择 nvidia/nemotron-3-super-120b-a12b:free,这个模型完全免费且效果不错:

配置消息平台
接下来配置消息平台,选择 Set up messaging now:

选择 Telegram,粘贴 Bot Token,然后回车确认:

然后设置 Allowed user IDs(填写你自己的 Telegram 数字 ID,不填则任何人都可以使用你的 Bot),Home Channel ID 可以留空后续再配置。
最后,系统会询问是否将 Hermes 安装为系统服务(launchd),选择 Y 可以实现开机自启、后台常驻:

获取 Telegram Bot Token
- 在 Telegram 中搜索 @BotFather
- 发送
/newbot命令,并按提示为你的 Bot 取名(用户名必须以 bot 结尾) - 获取 Bot Token,格式类似于
123456789:AAxxxxxxxx
查询自己的 Telegram 数字 ID:在 Telegram 中给 @userinfobot 发任意消息,它会回复你的 ID。
启动测试
配置完成后,运行 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 |
诊断问题 |
常见问题
Q: 提示 API call failed after 3 retries: HTTP 400: No models provided
这是配置文件编码问题(Windows 上常见)。让 Claude 帮你修复,告诉他报错信息,它会自动定位到配置文件中的 open() 调用并加上 encoding="utf-8" 参数。

Q: Telegram Bot 没有响应
没有设置 UserId,手动设置或者让 Claude 设置一下即可。
配置 OpenRouter(推荐)
Hermes 支持多种模型提供商,推荐先配置 OpenRouter——它提供大量免费模型,白嫖入门最方便。
- 打开 OpenRouter,点击 Create Key,名称填 hermes,然后直接点击 Create
- Key 只显示一次,立即复制并保存好
总结
Hermes 还有许多玩法尚未展开:定时任务、自建 Slack……后续会继续探索。