HermesAgent配置指南：新手一键导入预设参数教程

配置 Hermes Agent 时，你是否在 config.yaml 和 .env 文件的细节上耗费了过多精力？手动编辑不仅效率低下，格式缩进错误和环境变量遗漏更是导致初始化失败的常见原因。本文将为你提供几种经过实战检验的一键式配置方案，帮助你绕过繁琐的手动设置，快速构建一个稳定可用的运行环境。

一、利用 hermes setup 交互式向导自动生成配置

这是容错率最高、最适合新手的配置方式。最新版 CLI 工具集成的交互式向导，通过问答形式引导你完成所有必要参数的填写，从根本上杜绝了手动编辑导致的语法和格式问题。

操作流程如下：在终端执行 hermes setup 命令。当提示选择设置模式时，输入 quick 并回车。随后，根据向导提示选择你的模型服务提供商，例如 OpenRouter 或 Kimi。在粘贴 API Key 时，终端出于安全考虑不会回显字符，这属于正常现象。最后，从提供的模型列表中选择一个默认模型并确认保存。向导运行完毕后，系统会自动在 ~/.hermes/ 目录下生成语法完全正确的 config.yaml 和 .env 配置文件。

二、下载并部署社区验证的预设配置文件

如果你希望完全跳过交互过程，或者需要在网络受限的环境中快速部署，直接导入预设配置包是最佳选择。这些预设包已通过 v0.13.0 版本的兼容性测试，能确保环境的标准化和可用性。

首先，从指定的国内镜像源获取预设的 config.yaml 文件内容。将其完整复制，保存为 config.yaml 文件，并放置到 ~/.hermes/ 目录下（覆盖原有文件）。接着，访问对应的环境变量模板链接，将内容粘贴至文本编辑器。找到文件中的 YOUR_API_KEY_HERE 占位符，将其替换为你实际获取的 API 密钥。最后，将此文件保存为 .env（注意文件名以英文点号开头，且无扩展名），同样存入上述目录即可完成配置注入。

三、通过 WorkBuddy 图形化界面实现零代码配置

对于偏好可视化操作、不熟悉命令行的用户，图形界面工具提供了最直观的解决方案。WorkBuddy 的 Web UI 界面允许你像配置普通应用一样完成所有设置，无需接触任何终端命令。

启动 WorkBuddy 服务后，在浏览器中访问其配置管理页面。定位并点击“加载预设”按钮，从下拉菜单中选择为你预置的方案，例如“新手推荐（Kimi + 中文优化）”。在弹出的对话框中填入你的 Kimi API Key，并建议勾选“自动写入 .env 加密存储”选项以提升安全性。点击应用后，WorkBuddy 将在后台自动执行语法校验、文件生成和配置热重载。你只需观察服务运行日志，当出现配置成功加载的提示信息时，即表示配置已生效。

四、使用 curl 命令执行一键拉取与注入（适用于 Linux/macOS/WSL2）

如果你精通脚本化运维，追求部署效率和一致性，这条单行命令是你的理想工具。它专为 Linux、macOS 或 WSL2 环境设计，能通过一条指令完成目录检测、文件下载、内容写入和权限设置，有效规避手动操作可能引入的换行符或编码错误。

在终端中执行以 OpenRouter 预设为例的这条命令。脚本会首先检测 ~/.hermes 目录是否存在，若不存在则自动创建。接着，它会下载预设的 config.yaml 文件并写入目标路径，同时生成一个待填写的 .env 文件模板。脚本还会自动为 .env 文件设置严格的访问权限，以保护密钥安全。当终端输出提示，告知你预设已成功导入，并提醒你编辑 .env 文件填入 API Key 时，整个配置流程即告完成。