需先用hermes config edit（linux/macos）或前往c:\users\用户名\.hermes\config.yaml（windows）定位配置文件，再按规范修改server、llm及language等字段，并通过hermes doctor和hermes config验证后重启服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要修改 Hermes Agent 的 config.yaml 文件来让智能体按预期工作，比如换模型、调端口、连本地 Ollama 或启用中文界面——但改错一个缩进、漏掉一个冒号、写错大小写，服务就起不来，日志里只报“YAML parse error”或“missing required field”。
定位并安全打开配置文件
第一步不是改，是找对地方。config.yaml 默认不在项目目录，而在用户级隐藏路径下，用错路径会导致改了白改。
Linux/macOS 用户执行：hermes config edit，该命令会自动用默认编辑器打开正确路径的文件；Windows 用户需手动前往 C:\Users\用户名\.hermes\config.yaml，注意用户名要替换成你当前登录系统的实际名称。
若文件不存在，【不要手动新建空白 .yaml 后缀文件】，而是运行 hermes setup 初始化一次，它会生成结构完整、缩进合规的默认配置。
务必使用纯文本编辑器（VS Code、Notepad++、vim），禁用 Word、WPS 或记事本（带格式/自动编码转换）。
修改 server 服务监听参数
这一组控制 Hermes 能不能被访问、从哪访问、关机时是否丢任务，改错直接导致启动失败或无法响应请求。
① 打开 config.yaml，找到 server: 区块（注意冒号后必须有空格）。
② 修改 host: 值：本地调试填 "127.0.0.1"；需局域网其他设备访问则填 "0.0.0.0"；填错 IP 格式（如 "localhost" 或缺引号）会导致绑定失败。
③ 修改 port: 值：必须是 1024–65535 之间的整数，且未被占用；改完后执行 lsof -i :新端口号（macOS/Linux）或 netstat -ano | findstr :新端口号（Windows）确认端口空闲。
④ 设置 shutdown_timeout: 不低于 5，否则强制终止正在运行的任务，可能造成数据不一致。
切换为本地 Ollama 模型
想离线跑模型、不交 API 费、保护提示词隐私？必须把 config.yaml 指向本地 Ollama 服务，并满足三个硬性条件：服务在跑、模型已加载、base_url 路径带 /v1。
方法一：直接替换 llm 节点
确保 ollama serve 已在后台运行，且 ollama list 显示目标模型状态为 loaded；然后在 config.yaml 中删掉原有 model: 区块，新增如下内容（严格两个空格缩进）：
llm: model: "qwen2:7b" base_url: "http://localhost:11434/v1" api_key: "ollama" ollama_compatible: true
注意：【base_url 必须以 /v1 结尾】，Ollama 的 OpenAI 兼容接口仅响应此路径，少写或写成 /api/v1 都会返回 404。
方法二：保留原 model 配置，仅覆盖 provider
若已有其他模型配置但想临时切回 Ollama，可在 model: 下添加子字段：provider: ollama，同时确保 default: 值与 ollama list 中显示的模型名完全一致（含版本号，如 llama3:8b）。
启用简体中文界面
v0.9.0 及以上版本原生支持中文化，只需声明语言代码，无需安装额外包或修改源码。
在 config.yaml 文件顶部（任意位置，但推荐紧接 version: 或 core: 下方）添加一行：language: zh-CN。
如果已有 ui: 区块，在其内部添加 locale: zh-CN 即可生效；没有则新建该区块也有效。
改完保存，重启 Hermes Agent，CLI 提示、help 文档、错误消息、技能返回模板将全部变为简体中文。
验证配置是否生效
别急着重启服务，先做两件事：
运行 hermes doctor，它会扫描 config.yaml 语法、检查必填字段、测试 base_url 连通性，并高亮指出具体哪一行出错；
再执行 hermes config，输出当前加载的最终配置快照，确认你修改的字段（如 port、model、language）已出现在输出中且值正确。
只有这两条命令都通过，才能执行 pkill -f hermes && hermes（Linux/macOS）或任务管理器结束进程后重新启动。
