了解如何配置 Hermes Agent,包括配置文件、LLM 提供商设置、工具配置和所有可用的配置选项。
选择模型提供商
Hermes 支持 300+ 个模型和十余个提供商。
Nous Portal 是 Nous Research 自己的订阅网关,一次 OAuth 登录,涵盖模型调用 + 工具网关(网页搜索、图像生成、TTS、浏览器自动化):
hermes setup --portal
以上条命令会打开浏览器完成 OAuth 授权,设置 Nous 作为推理提供商,并同时开启所有工具网关。
完整设置向导(自带 API Key):
hermes setup
向导提供三种模式:
| 模式 | 说明 | 适合谁 |
|---|---|---|
| Quick Setup (Nous Portal) | OAuth 一键登录,无需 API Key | 想最快跑起来的新用户 |
| Full Setup | 逐步配置每个提供商和工具 | 想自定义一切的用户 |
| Blank Slate | 仅启用最小核心(文件操作 + 终端),其余全部关闭 | 需要精确控制的高级用户 |
手动选择提供商
使用以下命令,查看可以选择的提供商:
hermes model
上下按键选择,回车选中配置:
常用提供商配置方式:
| 提供商 | 配置方式 |
|---|---|
| Nous Portal | hermes setup --portal(OAuth) |
| Anthropic(Claude) | OAuth 登录(需要 Max 套餐 + 额外用量额度),或设置ANTHROPIC_API_KEY |
| OpenRouter | 设置OPENROUTER_API_KEY |
| OpenAI | 设置OPENAI_API_KEY |
| Google AI Studio | 设置GOOGLE_API_KEY |
| xAI(Grok OAuth) | hermes model→ xAI Grok OAuth |
| 本地模型(LM Studio) | 设置LM_API_KEY和LM_BASE_URL |
原则:先让基础对话跑通,再逐步开启网关、定时任务、语音等高级功能。
使用 CC Switch 一键配置
接下来我们使用 CC Switch,让 Hermes 用上 Qwen、GlM、Kimi、DeepSeek 等大模型,CC Switch 是一款开源跨平台桌面工具,统一管理 Claude Code、Codex、Gemini CLI 等 AI 编程助手,支持一键切换 API 提供商、模型与配置。
可以去官网下载:CC Switch 官方网站 - AI 编程 CLI 统一管理工具。
也可以前往 GitHub Releases: https://github.com/farion1231/cc-switch/releases/latest 下载对应平台的安装包。
拉到网页最底部,资源包部分,下载对应平台的安装包:
下载 CC Switch 安装后,我们选择 Hermes,然后点击右上角「创建」按钮。
再配置中选择自定义:
我们可以使用 Coding Plan,这种还是最划算的,毕竟包月:
字节跳动官方 Coding Plan
模型:Doubao、GLM、DeepSeek、Kimi、MiniMax 等
讯飞星辰 MaaS
有免费的模型调用,一站式AI大模型体验、调用、部署、精调平台
阿里云 Token Plan
模型 Qwen3.5-Plus、 MiniMax M2.5、GLM-5、Kimi-k2.5 等
这里选择了字节的方舟,输入 API Key 和请求地址,OpenAI 兼容请求地址:https://ark.cn-beijing.volces.com/api/coding/v3,设置你的 API key,并设置想要的模型,这边选的是 deepseek-v4-pro:
配置完后,点击右下角的保存按钮,回到主界面我们就能看到配置好的信息,可以测试下是否设置成功,然后启用:
启用后,我们到命令行界面使用 hermes 命令启动 Hermes:
hermes
可以看到,模型已经设置成功,并可以使用了。
CC Switch 详细内容参考:CC Switch 一键切换 API | 菜鸟教程
配置文件位置
Hermes Agent 使用以下配置文件:
| 文件 | 说明 |
|---|---|
~/.hermes/config.yaml | 主配置文件 |
~/.hermes/.env | 环境变量(API 密钥等) |
~/.hermes/state.db | SQLite 会话数据库 |
~/.hermes/skills/ | 安装的技能目录 |
~/.hermes/sessions/ | 会话存储目录 |
~/.hermes/memories/ | 持久化记忆存储 |