OpenClaw

OpenClaw 是一款备受瞩目的开源、自主式人工智能（AI）虚拟助理平台，因其默认的应用程序图标是一只红色小龙虾，被技术社区广泛昵称为"小龙虾"。

准备工作

• 已开通云开发环境，获取环境ID cloudBase环境ID
• 在 AI 控制台中开启所需模型
• 在 AI 控制台中获取 Base URL 和 API Key

Base URLhttps://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase

配置步骤

我们以 OpenClaw-2026.6.5 (5181e4f) 为例

CC Switch 配置

CC Switch 是一款开源的桌面应用，统一管理多个 AI 编程工具的供应商配置。安装方式参考 CC Switch 配置文档。

1. 打开 CC Switch，添加云开发供应商

字段	说明
API Key	在 AI 控制台 中获取
Base URL	https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
API 格式	Chat Completions

2. 切换启用云开发供应商即可使用

DashBoard 面板配置

1. 打开 DashBoard 面板，如果你的 OpenClaw 运行在本地电脑上，可以直接在终端运行以下快捷命令，系统会自动复制链接并尝试在浏览器中打开

openclaw dashboard

2. 点击设置 - AI 与代理 - Models - Model Provides
3. 展开 Model Provides 面板，点击 Add Entry

4. Custom entries 填入如下信息

本示例以最小范围填入信息，您可以根据自己需求自定义填写字段，填入各字段含义如下

填入字段	解释
Provider Name	厂商名称，可以任意填写，截图示例里填写了 cloudbase
Model Provider API Key	调用大模型 API Key，在 AI 控制台中获取
Model Provider Base URL	大模型 Base URL，在 AI 控制台中获取

5. 展开 Custom entries 的子面板 Model Provider Model List 面板，点击 Add 添加模型

填入各字段含义如下（其它字段无需填写，以 Custom entries 配置的信息为准）

填入字段	解释
Id	大模型 ID，在 AI 控制台 模型列表复制已启用的大模型标识填入
Name	大模型名称，可以任意填写，示例里将大模型 Id 和大模型名称保持一致，以免混淆

6. 点击 Save 返回聊天即可测试

手动修改配置文件

1. 打开配置文件

备注

如果通过您文件浏览器找到文件，文件浏览器默认会隐藏掉以"."开头的文件名的文件，您可能需要打开文件浏览器的隐藏文件选项才能看到。

Mac 通过访达快捷键 Command + Shift + . 打开，Windows 可以通过勾选 "文件资源管理器 - 查看 - 显示 - 隐藏项目" 打开。

• Windows 配置路径

C:\Users\<你的用户名>\.openclaw\openclaw.json

• Mac/Linux 配置路径

~/.openclaw/openclaw.json

2. 填入配置

本示例以最小范围填入大模型配置，您可以根据自己需求自定义填写字段。本示例新增了一个自定义大模型提供商 cloudbase， models.providers.cloudbase 填入各字段含义如下

填入字段	解释
baseUrl	大模型 Base URL，在 AI 控制台中获取
apiKey	调用大模型 API Key，在 AI 控制台中获取
models.name	厂商名称，可以任意填写，截图示例里填写了 cloudbase
models.id	大模型 ID，在 AI 控制台 模型列表复制已启用的大模型标识填入

{
  "models": {
    "providers": {
      "cloudbase": {
        "baseUrl": "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase",
        "apiKey": "eyJhbGciOiJSUzI1N...",
        "models": [
          {
            "id": "hy3",
            "name": "hy3"
          }
        ]
      }
    }
  }
}

常见错误排查

报错信息	解决方法
All models are temporarily rate-limited. Please try again in a few minutes	Base URL 填写不正确，请前往 AI 控制台中复制正确的 Base URL。配置了错误的大模型 ID ，大模型未在 AI 控制台 中启用
401 gent failed before reply: 401 status code	API Key 填写错误，或者可能被删除