胜算云 胜算云 文档中心 ↗ 精益社区

Hermes Agent 接入胜算云 API

Hermes Agent 是 Nous Research 开发的开源自进化 AI Agent，支持持久记忆、自动生成技能。通过胜算云 OpenAI 兼容接口，一个 Key 可调用数百种模型。

开源自进化 Agent 支持 Web to Agent 一键写入 CLI / YAML 双配置
方式 A · 推荐

CC-Switch 一键接入

GUI 工具自动写入配置，支持多工具统一管理。

最省事→
方式 B

交互式向导

hermes model / hermes setup 逐步引导填写。

官方推荐→
方式 C

CLI / 配置文件

hermes config 命令或直接编辑 config.yaml。

进阶→

前置准备

  1. 安装最新版 Hermes Agent 
    curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
    验证：hermes --version
  2. 获取胜算云 API Key访问 胜算云官网 → 控制台 → 生成 API Key。
  3. 环境要求Node.js / Python / Rust 依赖已由安装脚本处理，推荐服务器运行。

方式 A · 用 CC-Switch 一键接入

  1. 下载并安装 CC-Switch前往 GitHub Releases 下载对应平台安装包。
  2. 打开供应商设置打开 CC-Switch，点击「供应商」。
  3. 选择胜算云在供应商列表中选择「胜算云」，API Key 和 Base URL 会自动填充。
  4. 填入 API Key输入你的胜算云 API Key。
  5. 写入通用配置勾选「写入通用配置」以覆盖已有配置。
  6. 启用并重启点击启用，重启对应工具即可使用。

Hermes Agent 使用 CC-Switch 注意事项：配置时务必勾选「写入通用配置」；选择供应商为「胜算云」后，API Key 和 Base URL 会自动填充。

下载 CC-Switch

macOS支持 brew install 或直接下载 .dmg 安装包
Windows下载 .msi 安装包，双击安装
Linux提供 .deb 和 .rpm 安装包
GitHub Releases

下载 CC-Switch 最新版安装包（全平台）。
CC-Switch 仓库 →

开源项目主页，查看文档与 Issue。

方式 B · 交互式向导配置

hermes model
# 或
hermes setup

向导步骤：

  1. 选择 Inference Provider选择 Custom endpoint。
  2. 填写 API Base URLhttps://router.shengsuanyun.com/api/v1
  3. 填写 API Key粘贴你的胜算云 Key。
  4. 填写默认 Model ID如 openai/gpt-5.5。

启动验证

hermes status
hermes chat          # 进入 TUI 交互测试

方式 C · CLI 快捷命令

hermes config set model.provider shengsuanyun
hermes config set model.default "openai/gpt-5.5"
hermes config set custom_providers.shengsuanyun.base_url "https://router.shengsuanyun.com/api/v1"
hermes config set custom_providers.shengsuanyun.api_key "sk-你的胜算云API Key"
hermes config set custom_providers.shengsuanyun.api_mode "chat_completions"
hermes config get model

直接编辑配置文件

model:
  default: openai/gpt-5.5
  provider: shengsuanyun

custom_providers:
  - name: shengsuanyun
    base_url: https://router.shengsuanyun.com/api/v1
    api_key: sk-你的胜算云API Key
    api_mode: chat_completions
    models:
      - id: openai/gpt-5.5
        name: GPT-5.5

为什么这么写

custom_providersHermes 用累加式供应商管理：把胜算云加进列表，不覆盖你已有的其它供应商，model.provider 指向它即可
api_mode调用协议：GPT 等用 chat_completions（/v1 地址）；Claude 模型改 anthropic_messages（base_url 去掉 /v1）
model.default默认使用的模型 ID
model.provider指向 custom_providers 里的供应商名

修改后生效：

hermes config validate
hermes restart

配置文件位置：macOS/Linux 为 ~/.hermes/config.yaml，Windows 为 %LOCALAPPDATA%\hermes\config.yaml（注意无点前缀）。

测试与常见问题

  1. TUI 测试hermes chat
  2. 查看状态hermes status --deep、hermes doctor
  • Base URL 是否带 /v1 取决于协议：chat_completions 带、anthropic_messages 不带
  • 模型 ID 必须与胜算云控制台模型列表一致
  • custom_providers 可与 OpenRouter 等其它供应商同时共存
  • 更新：hermes self-update 后重新运行 hermes model