推荐使用 hermes setup 交互式向导：执行 hermes setup → 选 quick 模式 → 选模型商 → 粘贴 api key → 选默认模型 → 自动生成功合规 config.yaml 与 .env 文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功安装 Hermes Agent，但在配置 config.yaml 或 .env 文件时感到无从下手、易出错或反复失败，则很可能是因手动编辑敏感字段、格式缩进错误或环境变量缺失所致。以下是针对新手的一键导入预设参数的多种可靠方法：
一、使用 hermes setup 交互式向导自动填充
该方式由官方 CLI 内置，全程无需手动编辑文件，所有参数通过终端问答生成，严格校验格式与必填项，适用于所有平台（Windows/WSL2/macOS/Linux）。
1、在终端中执行 hermes setup 命令。
2、当提示 “Select setup mode” 时，输入 quick 并回车。
3、依次选择模型提供商（如 OpenRouter 或 Kimi）。
4、粘贴您的 API Key（终端不回显，属正常行为）。
5、从列表中选择默认模型（如 anthropic/claude-3.5-sonnet）。
6、确认保存后，系统自动生成合规的 config.yaml 与 .env 文件，并写入 ~/.hermes/ 目录。
二、下载并导入社区验证的预设配置包
该方式跳过全部交互流程，直接用已通过 v0.13.0 版本兼容性测试的 YAML + ENV 组合包覆盖本地配置，适合网络受限或需快速复现标准环境的用户。
1、访问国内镜像源地址：https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/configs/preset-newbie.yaml。
2、将页面内容全选复制，保存为 config.yaml，存放至 ~/.hermes/ 目录下（覆盖原文件）。
3、访问对应环境变量模板：https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/configs/preset-newbie.env。
4、打开该链接，将内容粘贴至文本编辑器，将其中 YOUR_API_KEY_HERE 替换为实际密钥。
5、保存为 .env，确保文件名前带英文点号，且无扩展名，存放路径同上。
三、通过 WorkBuddy 图形化界面零代码导入
该方式完全脱离命令行，利用 Web UI 批量加载预设参数集，自动完成格式校验、路径映射与权限设置，专为不熟悉终端操作的新手设计。
1、启动 WorkBuddy 服务后，在浏览器中打开 http://localhost:8080/hermes/config。
2、点击 “加载预设” 按钮，从下拉菜单中选择 新手推荐（Kimi + 中文优化）。
3、在弹出窗口中输入您的 Kimi API Key，勾选 “自动写入 .env 加密存储”。
4、点击 “应用并重启 Agent”，WorkBuddy 将校验语法、生成文件、重载配置并输出运行日志。
5、观察终端最后一行是否显示 Configuration loaded successfully from preset。
四、使用 curl 一键拉取并注入（仅限 Linux/macOS/WSL2）
该方式适合习惯脚本化操作的用户，单条命令完成下载、替换、权限修复全流程，避免因手动操作导致的换行或编码问题。
1、执行以下命令（以 OpenRouter 预设为例）：
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/import-preset.sh | bash -s openrouter
2、脚本将自动检测 ~/.hermes 目录存在性，若不存在则创建。
3、下载预设 config.yaml 并写入，同时生成空白 .env 模板。
4、执行 chmod 600 ~/.hermes/.env 确保密钥文件权限安全。
5、提示 Preset imported. Edit ~/.hermes/.env to add your API key. 后停止。
