跳到主要内容

OpenClaw

准备工作​

  1. 已开通云开发环境，获取环境 ID（ENV_ID）
  2. 已购买 Token 资源包
  3. 在控制台 → AI → 生文模型中开启所需模型
  4. 已创建 API Key（控制台 → 环境配置 → API Key）

配置步骤​

  1. 在终端运行 openclaw dashboard，在浏览器中打开 WebUI
  2. 进入左侧菜单 Config → Raw 标签页
  3. 在 openclaw.json 编辑器中，找到或新增 models.providers 字段，填入以下配置：
{
  "models": {
    "mode": "merge",
    "providers": {
      "cloudbase": {
        "baseUrl": "https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase",
        "apiKey": "<YOUR_CLOUDBASE_API_KEY>",
        "models": {
          "hy3-preview": {
            "label": "混元 Hy3",
            "reasoning": false
          }
        }
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "cloudbase/hy3-preview"
      }
    }
  }
}

将 <ENV_ID> 替换为实际的云开发环境 ID，<YOUR_CLOUDBASE_API_KEY> 替换为云开发 API Key。

  1. 点击 Save，再点击 Update 使配置生效

思考模式​

reasoning 字段控制混元 Hy3 模型是否启用扩展思考：

  • false（默认）：no_think 模式，响应更快
  • true：开启深度推理

故障排查​

配置看起来正常，但请求返回 404 或 401 错误时，通常是 OpenClaw 缓存问题。可直接修改本地配置文件后重启网关解决。