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

按提示逐步操作：

选择供应商：选 bumo.ai（BUMO API）；若已为其他客户端建过 profile，可直接复用。
Profile 名称 / API Key / 模型 / 小模型：按提示填入，API Key 可在 API Keys 页面获取。
应用到哪个客户端：选择 Hermes Agent。

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

model.provider: custom
model.base_url: https://api.bumo.ai/v1
model.default: <您选择的模型>
model_aliases.codesw-<profile>：指向您选择的模型，便于在 Hermes 中引用。

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

配置完成后正常启动 Hermes Agent 即可。以后想换模型 / 供应商，再次运行 codesw 选择已有 profile 重新应用即可。

附：手动配置（备选）

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

yaml

model:
  provider: custom
  base_url: https://api.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://api.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 安装 ​