HERMES AGENT

Hermes Agent接入胜算云API

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

API 端点

BASE URL复制

https://router.shengsuanyun.com/api/v1

认证方式Bearer YOUR_API_KEY

推荐配置方式

用 CC-Switch 一键接入胜算云

下载并安装 CC-Switch

打开 CC-Switch，点击 "供应商"

在供应商列表中选择 "胜算云"

输入你的 胜算云 API Key

勾选 "写入通用配置" 以覆盖已有配置

点击启用，重启对应工具即可使用

Hermes Agent 使用 CC-Switch 注意事项

使用 CC-Switch 配置 Hermes Agent 时，勾选 "写入通用配置"

选择供应商为"胜算云"后，API Key 和 Base URL 会自动填充

下载 CC-Switch

下载安装

macOS：支持 brew install 或直接下载 .dmg 安装包

Windows：下载 .msi 安装包，双击安装

Linux：提供 .deb 和 .rpm 安装包

支持 Claude Code、Codex、OpenCode、OpenClaw、Hermes Agent 等多工具一键配置

自动管理 API Key 和 Base URL，无需手动编辑配置文件

GITHUB RELEASES

复制链接

https://github.com/farion1231/cc-switch/releases
CC-Switch GitHub 仓库 →

第 1 步

前置准备

安装最新版 Hermes Agent

BASH

复制

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

验证：hermes --version

获取胜算云 API Key

访问胜算云官网 → 控制台 → 生成 API Key

环境要求

Node.js / Python / Rust 依赖已由安装脚本处理，推荐服务器运行

第 2 步

交互式向导配置

运行配置命令：

BASH

复制

hermes model
# 或
hermes setup

向导步骤：

选择 Inference Provider：Custom endpoint

API Base URL：https://router.shengsuanyun.com/api/v1

API Key：粘贴你的胜算云 Key

默认 Model ID：如 openai/gpt-5.4

第 3 步

启动验证

BASH

复制

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

第 4 步

CLI 快捷命令

BASH

复制

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

第 5 步

直接编辑配置文件

配置文件：~/.hermes/config.yaml

YAML

复制

model:
  default: openai/gpt-5.4
  provider: custom
  base_url: https://router.shengsuanyun.com/api/v1
  api_key: sk-你的胜算云API Key

auxiliary:
  vision:
    provider: custom
    base_url: https://router.shengsuanyun.com/api/v1
    api_key: sk-你的胜算云API Key
    model: anthropic/claude-haiku-4.5

修改后生效：

BASH

复制

hermes config validate
hermes restart

第 6 步

测试与常见问题

TUI 测试：hermes chat

查看状态：hermes status --deep、hermes doctor

常见问题：

Base URL 必须带 /v1

模型 ID 必须与胜算云控制台模型列表一致

provider: custom 可与 OpenRouter 等同时使用

更新：hermes self-update 后重新运行 hermes model