OpenClaw by CCS | UnifyLLM Docs

接入说明

本页说明如何通过 CC Switch 将 OpenClaw 接入 UnifyLLM。在「统一供应商」中新增 UnifyLLM，预设类型选择 NewAPI，启用 OpenClaw，端点填写带 /v1 的地址，API 格式选择 OpenAI Compatible。

先安装 OpenClaw

先从OpenClaw的官方文档或发行页安装客户端，再回到 CC Switch 配置供应商。下面是常见的 npm/pipx 安装方式；如果当前版本官方命令不同，以官方页面为准。

macOS / Linux：使用 Terminal、iTerm2 或 bash/zsh；安装后重新打开终端，让 PATH 生效。
Windows：推荐使用 Windows Terminal 或 PowerShell；Node.js 工具使用 npm，Python 工具使用 pipx，并避免混用不同 Python 环境。
安装后先执行工具的 --version 或官方启动命令，确认客户端本身可以运行，再配置 API。

1# macOS / Linux / Windows Terminal2npm install -g openclaw3 4# verify the installation5openclaw --version

接入前准备

API Base URL：https://api.unifyllm.top/v1
一个有效的 UnifyLLM API Key
一个当前可用的模型 ID，例如 gpt-5.6-sol。模型、分组和价格可能变化，请以价格页及控制台模型列表为准。

在 CC Switch 中配置

1
安装并打开 CC Switch
打开供应商管理页面，在应用切换器中选择 OpenClaw。
2
进入统一供应商
点击 +，在「统一供应商」中新增 UnifyLLM，不要放到应用专属供应商列表。
3
选择 NewAPI 预设
预设类型选择 NewAPI，供应商名称填写 UnifyLLM。
4
选择格式并填写端点
API 格式选择 OpenAI Compatible；端点填写 https://api.unifyllm.top/v1，再粘贴 API Key。不要把 Key 写入截图、代码仓库或公开日志。
5
添加并选择模型
添加模型 gpt-5.6-sol 或从“获取模型”列表中选择准确的模型 ID；如果模型列表为空，先检查端点、Key 和 /v1 是否重复。
6
启用供应商
点击启用并按 OpenClaw 的要求重启工具。在「统一供应商」中新增 UnifyLLM，预设类型选择 NewAPI，启用 OpenClaw，端点填写带 /v1 的地址，API 格式选择 OpenAI Compatible。

手动配置参考

如果你没有使用 CC Switch，下面是对应工具常见配置格式的参考。不同版本的配置字段可能变化，优先以工具本身文档为准。

1{2  "models": {3    "mode": "merge",4    "providers": {5      "unifyllm": {6        "baseUrl": "https://api.unifyllm.top/v1",7        "apiKey": "<YOUR_API_KEY>",8        "api": "openai-completions",9        "models": [{ "id": "gpt-5.6-sol", "name": "gpt-5.6-sol", "input": ["text"] }]10      }11    }12  }13}

测试与排查

启用供应商后重启 OpenClaw 或重新加载网关，再执行一个简短任务，并在 UnifyLLM 用量日志中确认请求已经记录。

接口参考：Chat Completions、Responses、Messages 和 Generate Content。

先使用一个短请求测试，不要一开始就运行大批量任务。
确认模型 ID 与价格页/控制台完全一致，尤其注意分组前缀。
到控制台用量日志查看请求是否到达、实际模型、Token 用量和错误信息。
如果工具自动追加 /v1，而你又手动填写了 /v1，请删除重复部分。

CC Switch 官方参考

本文参考 CC Switch 官方的软件介绍、添加供应商和编辑供应商。CC Switch 更新后，字段名称和配置路径可能变化，请以其最新版文档和应用界面为准。

安全提醒

API Key 等同于账户调用凭据。请使用专用 Key，限制暴露范围，发现泄露后立即在控制台禁用并重新创建。不要把 Key 放入前端代码、公开仓库、截图或第三方同步服务。

安装并打开 CC Switch

进入统一供应商

选择 NewAPI 预设

选择格式并填写端点

添加并选择模型

启用供应商