💡阅读指南

装好 Hermes 之后，少不了要改配置，比如切换模型、改 API Key、调一下安全策略。改配置有好几种方式。 这一节我们讨论怎么用更顺手的方式快速切换配置。 如果你不喜欢命令行控制，直接看本节最后一个小节：让 Hermes 直接改

10.1 四种方式

最推荐方式四

1. 直接编辑配置文件

先看看配置文件在哪，里面有什么内容。可以用命令找到它的位置：

Bash
hermes config path        # 看看 config.yaml 实际在哪
Bash
hermes config edit        # 用默认编辑器打开 config.yaml

通常，hermes的配置文件位置在mac上非常直接：

code
 # ~/.hermes/config.yaml

默认的配置文件中的配置项名称如下：

YAML
# ~/.hermes/config.yaml
model:
  provider: deepseek
  name: deepseek-v4-flash
  api_key: sk-xxxxxxxxxxxxxxxx

terminal:
  backend: local

hermes config edit 打开的是系统默认编辑器，不同系统不一样——Linux 上通常是 Vim，macOS 上可能是 PICO 或 nano。

绝大多数人是不太熟悉这些 命令行编辑器的。

那最简单的办法是从你操作系统的文件管理器里（Windows-资源管理器、Mac-访达）找到 ~/.hermes/config.yaml，用你顺手的编辑器（VS Code、Sublime、甚至记事本）直接打开就行。这就和你正常编辑文件一样。

💡提示

如果你希望以后 hermes config edit 直接用 VS Code 打开，而不是每次都进命令行编辑器，可以让 Hermes 帮你改。在对话里说一句：

code
> 把终端的默认编辑器改成 VS Code

之后 hermes config edit 就会直接打开 VS Code。Qoder、Sublime 等编辑器同理，只需要换个名字。

所有和 Hermes 相关的本地文件都在 ~/.hermes/ 下：

  • ~/.hermes/config.yaml — 主配置文件
  • ~/.hermes/skills/ — 技能文件
  • ~/.hermes/history/ — 会话历史
  • ~/.hermes/memory.db — 跨会话记忆数据库

熟悉文件结构之后，改起来就心里有数了。

2. 交互式向导

如果不习惯手写 YAML，可以让Hermes 提供向导，他是菜单式操作：

Bash
hermes model     # 切模型和换提供商
hermes setup     # 综合向导（模型、终端、网关、工具一条龙）
hermes tools     # 交互式工具开关

hermes setup 会打开第一次安装 Hermes 时出现的向导，相当于重走一遍向导设置。不推荐这种方式，除非你要更改的配置很多。否则单项修改更方便。

3. 命令行直接设置

如果只想修改某个单项配置，可以使用下述命令：

Bash
hermes config set <配置项> <值>

例如：

Bash
hermes config set model.default gpt-4
hermes config set security.redact_secrets true

配置项的多级名字用点号分层，比如 model.default、terminal.backend。当然这种对熟练度要求很高，这参数名其实挺不好记住的。所以不太推荐。

4. 让 Hermes 直接改

这是最推荐的方式。不需要记命令，无论是设置模型、还是网关，都可以通过 Hermes 用自然语言来设置。比如：

将辅助视觉模型设置为 opencode go 里的 qwen3.7-plus

这种方式的缺点是会消耗一定的 token且速度较慢，但可以为你节约不少时间。它非常适合新手，避免手工配置出现各种问题。

10.2 在会话中调整设置

部分常用设置也可以在对话中切换，不用退出会话：

命令 作用
/personality <名称> 切换人格设定（临时，详见第4章 SOUL.md）
/yolo 开关 YOLO 模式（跳过危险命令确认，强烈建议不要开启）
/config 看看当前配置

这些配置改完立刻生效，但只在当前会话有效，并不会写进配置文件。

10.3 ■ 学点英语

中文 English 音标 说明
配置文件 Settings File /ˈsetɪŋz faɪl/ 保存软件行为参数的文件
环境变量 Environment Variable /ɪnˈvaɪrənmənt ˈveriəbl/ 由系统或 shell 提供给程序读取的运行参数
配置管理 Configuration Management /kənˌfɪɡjəˈreɪʃən ˈmænɪdʒmənt/ 维护系统参数、密钥和开关的管理方式
默认值 Default Value /dɪˈfɔːlt ˈvæljuː/ 用户未显式设置时系统采用的初始值