Hermes 配置
Hermes 是面向终端和开发工作流的 Agent。完成 Hermes 客户端准备后，可以通过 hermes setup 向导配置 yuyuflow 的模型服务。
本页省略安装脚本
请先参考 Hermes 官方安装文档完成安装。本页只说明 setup 向导中的平台配置，不复制安装脚本。
前置条件
- Linux、macOS 或 WSL2 环境。
- 已安装 Git。
- 已在控制台创建专用 API Key。
- 已确认目标模型可用。
Windows 用户可以通过 WSL2 使用 Hermes；请以官方文档支持的平台和版本为准。
使用 setup 向导
在终端运行：
bash
hermes setup选择 Quick Setup，然后按提示填写：
| 配置项 | 填写内容 |
|---|---|
| Provider | yuyuflow 或向导中对应的自定义 provider |
| API Key | 控制台创建的专用 API Key |
| Base URL | https://art-api.yuyuflow.com |
| Model | 控制台显示的完整模型 ID，例如主模型或快速模型 |
参考页面明确展示了 provider、API Key、Base URL 和模型这些 setup 项。未明确的协议名称、endpoint、配置文件路径和 JSON/TOML schema，请以 Hermes 当前版本向导和官方文档为准。
关于 Base URL
示例地址应以当前平台为准，不要硬编码其他服务商域名。如果客户端要求填写带版本号的地址，请使用控制台提供的完整地址，并避免重复添加 /v1。
验证 Hermes
完成 setup 后，在项目目录启动 Hermes 并发送一条简单消息。先确认模型能够正常返回，再尝试代码读取或工具调用。
如果 Hermes 提供 provider 或 model 查看入口，请确认当前值与 setup 中填写的内容一致。
常见问题
`hermes setup` 中找不到 provider
确认 Hermes 版本和官方文档中的支持范围；如果支持自定义 provider，按当前版本向导填写，不要套用 WorkBuddy 的 JSON 配置。
鉴权失败或返回 `401`
检查 API Key 是否有效、是否属于正确工作区，并确认 Base URL 没有多余空格或指向旧地址。
模型返回 `404`
使用控制台中的完整模型 ID，确认账号额度和令牌分组允许访问该模型。
不确定 Base URL 是否包含 `/v1`
优先使用平台控制台显示的接口地址。基础地址已包含 /v1 时，不要在客户端再次拼接；最终请求地址只能包含一个版本路径。
想手动编辑配置文件
参考页面没有公开 Hermes 当前版本的配置文件位置和字段 schema。建议使用 hermes setup，不要自行创建未被官方确认的 JSON 或 TOML 字段。
下一步可阅读 Agent 工具总览、LLM 配置、OpenClaw 配置 或 Reasonix 配置。