十分钟装好 Hermes Agent：自动挡 + 免费模型，手把手完整版
Hermes Agent 安装教程，无需基础，十来分钟跑起来，支持 Telegram、Discord，自动挡安装脚本全平台通用。
AI Agent 这个方向最近很火，但很多人装了没多久就放弃了——不是不想用，是装完不会用，配置劝退。今天说一个相对低门槛的开源方案，从安装到跑起来，十来分钟能搞定。
Hermes Agent 是什么
Hermes 是 Nous Research 出品的开源 AI Agent 框架，主打两个特点：
- 自建学习循环：会从使用中积累技能，不是每次都从零开始
- 接入模型多：支持 15+ 模型提供商，不绑死某一家
支持的消息平台也覆盖了常见的 Telegram、Discord、Slack、WhatsApp，做自动化聊天的门槛不高。
自动挡安装（Mac / Linux）
在终端输入：
Windows 用户在 PowerShell 里输入：
脚本会自动检测并安装 Python、Node.js、Git、ripgrep 等依赖项，等着就行。
配置向导
装完之后会自动弹出配置向导，选第一项 Quick setup，新手推荐这个。
接下来是模型接入。提示输入 OpenRouter API Key，粘贴进去回车。没有的话去 openrouter.ai/keys 申请一个，新用户有免费额度。
选择默认模型，推荐 nvidia/nemotron-3-super-120b-a12b:free，免费，效果够用。
然后配置消息平台，选 Telegram，把 Bot Token 填进去。申请方式下一节有说。
把 Bot Token 粘贴进去：
最后设置 Allowed User IDs，填你自己的 Telegram 数字 ID。不填的话任何人都能用你的 Bot，有安全顾虑的建议填一下。问是否安装为系统服务，选 Y 可以开机自启、后台常驻。
查自己 Telegram ID：在 Telegram 给 @userinfobot 发任意消息，它会回复你的数字 ID。
申请 Telegram Bot
- Telegram 里搜索 @BotFather
- 发送
/newbot，按提示给 Bot 取个名字（用户名必须以 bot 结尾） - 拿到一串 Token，长这样：
123456789:AAxxxxxxxx
启动
配置完成后运行：
hermes
看到欢迎页就说明跑起来了。去 Telegram 找到你的 Bot 发条消息测试一下。
手动挡安装
不想用自动挡，可以手动装：
git clone https://github.com/NousResearch/Hermes-Agent
cd Hermes-Agent
pip install -e .
hermes setup
手动挡和自动挡用法完全一样，适合想改源码或者锁定版本的人。
常用命令
| 命令 | 作用 |
|---|---|
hermes | 启动交互式对话 |
hermes model | 切换模型 |
hermes tools | 配置工具 |
hermes gateway | 启动消息网关 |
hermes update | 更新版本 |
hermes doctor | 诊断问题 |
常见问题
装了之后报 HTTP 400: No models provided
大概率是配置文件编码问题，尤其是 Windows 系统，让 Claude 根据报错信息帮你修一下就行，它会自动在 cli.py 的 open() 调用里加上 encoding="utf-8"。
Telegram Bot 没有响应
检查一下 Allowed User IDs 有没有填成自己的 Telegram 数字 ID。也可以让 Claude 帮你检查配置。
OpenRouter 免费模型
不想一开始就付费的话，先用 OpenRouter 的免费模型够用了。打开 openrouter.ai/keys 创建一个 Key。
免费模型够跑通基本功能，后续再按需切换。
上手门槛不高，适合想自己搭一套 AI Agent 但不想折腾一堆配置的人。感兴趣可以试试，有问题可以留言。