Hermes Agent

先确认 hermes --version能运行。准备使用的模型应支持 OpenAI 兼容接口。

还没有 Wegoo 账号

打开 注册页，填写用户名、密码、确认密码和电子邮件。点击 发送验证码并填回验证码，勾选用户协议，点击 创建账户。成功后用用户名或电子邮件登录。

未收到验证码时，检查邮箱拼写和垃圾邮件，并使用最新收到的验证码。已有账号可直接 登录。

一键脚本手动配置

一键脚本

准备好 Wegoo API 密钥，在 macOS、Linux 或 WSL 终端运行：

curl -fsSL https://docs.wegoo.site/install/hermes.sh | bash

按提示选择 Claude / Anthropic 或 Codex / Responses，输入密钥并选择对应模型。

脚本需要 Python 3 和 PyYAML，只配置已安装的 Hermes。保存配置后重新启动 Hermes。

已有配置会先备份，再合并 Wegoo 设置。查看脚本

手动配置

1. 准备密钥和模型

已有可用密钥时，确认它所属的分组和目标模型后继续。

创建密钥并选择模型

1. 登录 模型广场，搜索目标模型，记下完整模型 ID、支持的分组和接口。
2. 打开 API 密钥，点击 创建 API 密钥。填写 名称，在 分组中选择刚确认的分组；数量保持 1。
3. 设置 过期时间。需要限制消耗时，关闭 无限配额并填写额度；0 表示没有可用额度。点击 保存更改。
4. 新密钥出现在列表后，打开行末菜单，点击 复制密钥。

图中名称和分组为演示数据。

无限配额只是不单独限制这把密钥的额度，使用仍消耗账户余额。完整密钥不要放进截图或公开代码。

示例中用到 MODEL_ID 时，替换为该分组可用的完整模型名称；用到 YOUR_API_KEY 时，替换为完整密钥。

2. 添加 Wegoo

退出当前 Hermes 会话，在终端运行：

hermes model

选择 Custom endpoint，依次填写：

内容	填写值
API base URL	https://ai.wegoo.site/v1
API key	Wegoo 完整密钥
Model name	该密钥可用的模型 ID

完成向导后，重新启动 Hermes 即可使用。

直接编辑配置文件

也可以编辑用户目录中的 .hermes/config.yaml：

model:
  provider: custom
  default: MODEL_ID
  base_url: https://ai.wegoo.site/v1
  api_key: YOUR_API_KEY

替换模型和密钥，保留文件中的其他设置。此文件含完整密钥，勿公开分享。

3. 切换与检查

会话中的 /model用于切换已配置的提供商和模型。新增地址或密钥时，退出会话后重新运行 hermes model。

运行 hermes doctor查看配置问题。401 时重新复制密钥，检查是否停用或过期；模型不存在时，检查完整模型 ID 是否属于该密钥的分组。

字段和向导依据 Hermes 官方提供商文档。