OpenClaw 接入胜算云 API

OpenClaw 是开源 AI Agent 平台，支持 Node.js 22+/24+。通过胜算云统一 OpenAI 兼容接口，一个 Key 可调用数百种模型。

开源 AI Agent 平台支持 Web to Agent 一键写入中文优化版可用

方式 A · 推荐

CC-Switch 一键接入

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

最省事→

方式 B

交互式向导

openclaw onboard 引导式配置，推荐新手。

新手友好→

方式 C

CLI / 配置文件

openclaw config 命令或直接编辑 openclaw.json。

进阶→

前置准备

安装最新版 OpenClaw

npm install -g openclaw@latest
# 或使用中文优化版（推荐国内用户）
npm install -g @qingchencloud/openclaw-zh@latest

验证：openclaw --version

获取胜算云 API Key访问胜算云官网注册/登录 → 控制台生成 API Key。
确认 Node.js 环境
node -v # 需 >= 22.14 或 24+

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

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

OpenClaw 使用 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 · 交互式向导配置（推荐新手）

运行命令：

openclaw onboard

向导步骤：

安全警告输入 Yes 继续。
配置模式推荐选择 QuickStart。
模型提供商选择 Custom Provider → OpenAI Compatible。
Base URLhttps://router.shengsuanyun.com/api/v1
API Key粘贴你的胜算云 Key。
Model ID如 openai/gpt-5.4、anthropic/claude-sonnet-5。

启动验证

            openclaw gateway status
openclaw dashboard     # 打开浏览器访问 http://127.0.0.1:18789
          

交互式配置面板（二次修改）

openclaw config

进入可视化面板，修改 Base URL、API Key、默认模型等，保存后自动校验。

方式 C · CLI 快捷命令

            openclaw config set models.providers.shengsuanyun.baseUrl "https://router.shengsuanyun.com/api/v1"
openclaw config set models.providers.shengsuanyun.apiKey "sk-你的胜算云API Key"
openclaw config set agents.defaults.model.primary "shengsuanyun/你的模型ID"
openclaw config get models.providers.shengsuanyun
          

直接编辑配置文件

            {
  "models": {
    "mode": "merge",
    "providers": {
      "shengsuanyun": {
        "baseUrl": "https://router.shengsuanyun.com/api/v1",
        "apiKey": "sk-你的胜算云API Key",
        "api": "openai-completions",
        "models": [
          { "id": "openai/gpt-5.4", "name": "胜算云-GPT-5.4" },
          { "id": "openai/gpt-5.4-mini", "name": "胜算云-GPT-5.4 Mini" }
        ]
      }
    }
  }
}
          

修改后生效：

            openclaw gateway restart
openclaw config validate
          

配置文件路径：~/.openclaw/openclaw.json（推荐备份后再编辑）。

api 协议与 Base URL 为什么这么配

"api" 决定 OpenClaw 用什么协议调用模型，必须和模型、Base URL 三者匹配：

openai-completions	本例，配 GPT 等模型：Base URL 必须带 `/v1`（`.../api/v1`），OpenClaw 会请求 `/chat/completions`。
anthropic-messages	配 Claude 模型（CC-Switch 胜算云预设用它）：Base URL 不带 /v1（`.../api`），OpenClaw 会请求 `/v1/messages`。换协议时记得把 `baseUrl` 末尾的 `/v1` 去掉。
"mode": "merge"	把胜算云模型合并进模型库，同时保留官方模型。
agents.defaults.model.primary	默认主模型，格式 `供应商名/模型ID`。

测试与常见问题

打开仪表板openclaw dashboard
发送测试消息在已配置渠道发送消息测试。
CLI 测试openclaw tui chat

Base URL 是否带 /v1 取决于协议：openai-completions 带、anthropic-messages 不带
推荐使用 @qingchencloud/openclaw-zh@latest，已内置「胜算云」预设
mode: "merge" 可同时保留官方模型和胜算云
更新：npm update -g openclaw@latest 后重新运行 openclaw onboard