Skip to content

在 OpenClaw 中使用 GPT 模型 ​

本文假设你已经在本地安装好 OpenClaw,并且可以正常启动。这里不介绍 OpenClaw 的安装方法,只说明如何通过 CC Switch 给 OpenClaw 配置 ClawPower GPT 模型。

这篇文档适合下面几类用户:

  • 已经安装并正在使用 OpenClaw
  • 想在 OpenClaw 中使用 ClawPower GPT 模型
  • 希望通过可视化工具配置,不想手动编辑 OpenClaw 配置文件

配置前,请先准备一个 ClawPower 账号。API 密钥和模型会在后面的配置步骤中处理。

第三方工具说明

本文使用的 CC Switch 是第三方开源工具,不由 OpenClaw 或 ClawPower 维护。工具版本更新后,页面名称和操作位置可能发生变化。

1. 下载 CC Switch ​

CC Switch 用来管理大模型供应商,不需要手动编辑 OpenClaw 配置文件。

请从 GitHub Releases 下载:

https://github.com/farion1231/cc-switch/releases

根据自己的系统选择安装包:

  • macOS:下载文件名中包含 .dmg 的安装包
  • Windows:下载文件名中包含 .exe 或 .msi 的安装包

CC Switch 下载页面

下载提示

请下载页面中的最新版本。截图中的版本号仅作示例,可能不是当前最新版本。

安装完成后,打开 CC Switch。

2. 准备 ClawPower API 密钥和 GPT 模型 ​

创建支持 GPT 模型的API 密钥 ​

创建API 密钥时,选择 GPT 精选分组。

API 密钥分组必须匹配

API 密钥分组必须支持你准备使用的模型,否则会提示没有权限或模型不可用。

复制模型 ID ​

打开 ClawPower 模型广场,复制准备使用的 GPT 模型 ID,例如 gpt-5.6-sol。

模型 ID 必须与模型广场显示的内容完全一致。

从 ClawPower 模型广场复制 GPT 模型 ID

3. 在 CC Switch 中配置 OpenClaw 模型 ​

进入 OpenClaw 配置页面 ​

打开 CC Switch,点击顶部的 OpenClaw 图标,点击右上角的「+」。

在 OpenClaw 页面添加供应商

选择「自定义配置」。

选择 OpenClaw 自定义配置

按照下面的内容填写基础配置:

text
供应商标识:clawpower
供应商名称:ClawPower
官网链接:https://clawpowerai.com
API 协议:OpenAI Completions

填写 ClawPower GPT 供应商基础配置

继续向下填写 API 和模型配置:

text
API 端点:https://api.clawpowerai.com
API Key:刚才创建的 ClawPower API 密钥
发送 User-Agent:开启
模型 ID:从模型广场复制的 GPT 模型 ID
显示名称:与模型 ID 保持一致

例如,使用 gpt-5.6-sol 时:

text
模型 ID:gpt-5.6-sol
显示名称:gpt-5.6-sol

填写 API、User-Agent 和 GPT 模型配置

必须开启 User-Agent

一定要开启「发送 User-Agent」。如果没有开启,请求可能会返回:403 Your request was blocked.

填写完成后,点击底部的「保存」。

启用 ClawPower ​

回到 OpenClaw 供应商列表,启用刚刚添加的 ClawPower 供应商。

启用 ClawPower OpenClaw 供应商

启用后,确认 ClawPower 是 OpenClaw 当前使用的供应商。

4. 在 OpenClaw 中验证 GPT 模型 ​

如果 OpenClaw 正在运行,请完全退出,然后重新打开。

在 OpenClaw 中创建一个新会话,发送一个简单请求:

text
北京一日游攻略

能够正常返回结果,就说明 ClawPower GPT 模型已经在 OpenClaw 中生效。

5. 常见问题 ​

返回 403 Your request was blocked ​

确认 CC Switch 中已经开启「发送 User-Agent」。

OpenClaw 仍然使用原来的模型 ​

确认 CC Switch 中已经启用 ClawPower,然后完全退出 OpenClaw,再重新打开。

返回 401 或 API Key 错误 ​

重新复制 ClawPower API 密钥,确认:

  • API 密钥前后没有多余空格
  • API 密钥仍处于启用状态
  • CC Switch 中填写的是完整API 密钥

提示模型不存在或没有权限 ​

检查模型 ID 是否与模型广场完全一致,并确认当前API 密钥分组支持该模型。

修改配置后没有生效 ​

确认修改后的配置已经添加并启用。关闭已有的 OpenClaw 会话,再重新启动 OpenClaw。

联系加微信 clawpower