文章目录
目录
- 自动挡安装
- 配置向导
- 申请 Telegram Bot
- 启动成功
- 手动挡安装
- 基本使用
- 常见问题 & 排错
- 番外：申请 OpenRouter API Key
Hermes Agent 必定是新一代的 OpenClaw，想想前一段时间多少人在闲鱼吃到 OpenClaw 的红利，接下来你也可以吃到 Hermes 的红利。
Hermes 是 Nous Research 出的开源 AI Agent 框架，支持自建学习循环（会从使用中积累技能）、接入 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，粘贴提前申请好的 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 配置
怎么查自己的 Telegram 数字 ID：在 Telegram 里给
@userinfobot
发任意消息，它会回复你的 ID。
在 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 常见）。让 Claude 帮你修，告诉它报错信息，它会自动定位
cli.py
里的 open() 调用并加上 encoding="utf-8" 参数。
Windows 编码报错修复
Q: Telegram Bot 没有响应
没有设置 UserId，手动设置或者让 Claude 设置下就行。
Hermes 支持多种模型提供商，推荐先配 OpenRouter——有大量免费模型可用，白嫖入门最方便。
打开
openrouter.ai/keys
，点击 Create Key，名字填 hermes，直接点 Create：
创建 OpenRouter API Key
Key 只显示一次，立刻复制保存好：
复制 API Key
Hermes 还有很多玩法没展开：定时任务、自建skills……后续会继续写。
觉得有用就关注一下，不定期分享 AI 工具的实际用法，不讲概念，只讲能上手的。