Markdown rendered as page contentHermes Agent

Hermes Agent 配置

BitCloud API 兼容 OpenAI 协议，支持 Hermes Agent，可参考本文进行配置与使用。

前置工作

获取凭证

项目	值
BASE_URL（OpenAI 兼容协议）	`https://web.bitcloud.com.cn/v1`
API Key	格式：`sk-xxxxx`
获取方式	前往控制台 → 令牌管理页面创建

安装 Hermes Agent

Hermes Agent 支持 Linux、macOS、WSL2（Windows）等系统，如需了解更多内容，可参考 Hermes Agent 官方文档。

Linux / macOS 系统不需额外操作，默认环境即可。
Windows 系统需要参考 Windows 系统安装 WSL 安装 WSL2，然后在 WSL2 中执行下方命令。

安装命令：

bashcurl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后，重新加载终端环境：

bashsource ~/.bashrc   # or source ~/.zshrc

验证安装（如有版本号输出，则表示安装成功）：

bashhermes --version

配置自定义供应商

配置基本信息

下面配置中的 BASE_URL 和 API_KEY 需替换为实际获取的值。

方式一：在终端输入以下命令快速配置

这里的 model.provider 只能设置为 custom，自定义其他名称将不合法。

bashhermes config set model.provider custom
hermes config set model.base_url BASE_URL
hermes config set model.api_key API_KEY
hermes config set model.default gpt-4o

配置完毕后，可在 ~/.hermes/config.yaml 中查看配置信息。

方式二：手动编辑配置文件

手动编辑 ~/.hermes/config.yaml 进行配置：

yamlmodel:
  provider: custom
  base_url: "https://web.bitcloud.com.cn/v1"
  api_key: YOUR_API_KEY
  default: gpt-4o

验证配置

配置完成后，使用以下命令验证：

bashhermes doctor

使用 Hermes Agent

配置完成后，执行以下命令启动：

bashhermes            # 经典 CLI 模式
hermes --tui      # 现代 TUI 模式

常见问题

如何切换模型？

修改配置文件中的 model.default 字段为其他模型 ID 即可。可用模型请在模型广场查看。

BitCloud API Documentation