Hermes Agent 接入

1. 前提条件

已注册并获取本平台 API Key。
已安装 Hermes Agent。

2. 推荐方式：使用 codesw 一键配置

codesw 会直接写入 ~/.hermes/config.yaml 和 ~/.hermes/.env（权限 0600），自动完成 provider、base_url、默认模型与 OpenAI Key 的配置，不做任何代理或中转。

2.1 安装

bash

npm i -g @bumocc/codesw
# 或
yarn global add @bumocc/codesw

2.2 运行交互模式

直接执行：

bash

codesw

按提示用方向键选择、回车确认，三步完成：

要配置哪个客户端：选择 Hermes Agent。
使用哪个供应商：选择 Bumo Router。首次使用时粘贴您在 API Keys 页面获取的 Key（输入时以 * 显示），之后会自动复用。
使用哪个模型：推荐模型排在最前，例如 claude-sonnet-5-5；也可选「手动输入模型 ID…」。

codesw 会在 ~/.hermes/config.yaml 中写入：

model.provider: custom
model.base_url: https://router.bumo.ai/v1
model.default: <您选择的模型>
model_aliases.codesw-<模型>：为每个可选模型生成一个别名，便于在 Hermes 中切换。

同时在 ~/.hermes/.env 中写入 OPENAI_API_KEY=<您的 Key>。

配置完成后正常启动 Hermes Agent 即可。以后想换模型 / 供应商，再次运行 codesw 即可，无需重复输入 Key。

附：手动配置（备选）

编辑 ~/.hermes/config.yaml，合并以下字段：

yaml

model:
  provider: custom
  base_url: https://router.bumo.ai/v1
  default: claude-sonnet-4-6

model_aliases:
  bumo-claude-sonnet-4-6:
    model: claude-sonnet-4-6
    provider: custom
    base_url: https://router.bumo.ai/v1

在 ~/.hermes/.env 中设置 API Key（文件权限建议 0600）：

env

OPENAI_API_KEY=YOUR_API_KEY

请将 YOUR_API_KEY 替换为您的平台 API Key。

Hermes Agent 接入 ​

1. 前提条件 ​

2. 推荐方式：使用 codesw 一键配置 ​

2.1 安装 ​