HoRain云--Hermes Agent 配置

云夏之末

187人浏览 · 2026-07-15 10:00:00

云夏之末 · 2026-07-15 10:00:00 发布

🎬 HoRain云小助手：个人主页

🔥 个人专栏: 《Linux 系列教程》《c语言教程》

⛺️生活的理想，就是为了理想的生活!

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

专栏介绍

专栏名称	专栏介绍
《C语言》	本专栏主要撰写C干货内容和编程技巧，让大家从底层了解C，把更多的知识由抽象到简单通俗易懂。
《网络协议》	本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘，一起解密网络协议在运行中协议的基本运行机制！
《docker容器精解篇》	全面深入解析 docker 容器，从基础到进阶，涵盖原理、操作、实践案例，助您精通 docker。
《linux系列》	本专栏主要撰写Linux干货内容，从基础到进阶，知识由抽象到简单通俗易懂，帮你从新手小白到扫地僧。
《python 系列》	本专栏着重撰写Python相关的干货内容与编程技巧，助力大家从底层去认识Python，将更多复杂的知识由抽象转化为简单易懂的内容。
《试题库》	本专栏主要是发布一些考试和练习题库（涵盖软考、HCIE、HRCE、CCNA等）

了解如何配置 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: Release CC Switch v3.17.0 · farion1231/cc-switch · GitHub 下载对应平台的安装包。

拉到网页最底部，资源包部分，下载对应平台的安装包：

下载 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/`	持久化记忆存储