零门槛装好 Hermes Agent:全程不到十分钟,附免费模型配置

Hermes Agent 安装教程来了,自动挡安装脚本全平台支持,还有免费模型可用。想吃这波红利的,可以动手了。
自动挡安装
在 Mac 或者 Linux 环境,在终端输入以下命令后回车:
curl -sL https://hermesagent.us/install | bash
Windows 环境,在 PowerShell 中输入:
irm https://hermesagent.us/install | iex
脚本会自动检测并安装 Python、Node.js、Git、ripgrep 等所有依赖,耐心等待即可。
配置向导
安装完成后会自动进入配置向导,选第一项 Quick setup(推荐)。
接入模型
进入 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 可以留空后续再配。最后问是否安装为系统服务(launchd),选 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 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" 参数。
Q: Telegram Bot 没有响应
没有设置 UserId,手动设置或者让 Claude 帮忙设置即可。
番外:申请 OpenRouter API Key
Hermes 支持多种模型提供商,推荐先配 OpenRouter——有大量免费模型可用,白嫖入门最方便。
打开 openrouter.ai/keys,点击 Create Key,名字填 hermes,直接点 Create。Key 只显示一次,立刻复制保存好。
Hermes 还有更多玩法:定时任务、自建 skills……感觉有用就收藏,不定期分享 AI 工具的实际用法,不讲概念,只讲能上手的。