QClaw

QClaw 是腾讯电脑管家基于 OpenClaw 开源生态打造的本地化 AI Agent 助手。

准备工作

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

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

配置步骤

我们以 QClaw-v0.2.25 为例

QClaw 设置配置

1. 打开 QClaw 面板，在对话框中单击模型选择按钮，点击自定义大模型

2. 点击自定义配置

3. 在弹出的添加自定义大模型对话框中，填入如下表单信息：

字段	说明	示例值
接口地址	大模型 API 的请求地址（Base URL），在 AI 控制台中获取，格式为 https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase	https://your-env-id.api.tcloudbasegateway.com/v1/ai/cloudbase
API 协议类型	接口协议类型，选择 OpenAI兼容协议 即可	OpenAI兼容协议
API Key	调用大模型的密钥，在 AI 控制台中获取	eyJhbGciOiJSUzI1N...
模型名称	要使用的大模型标识，在 AI 控制台 模型列表中复制已启用的模型 ID 填入	hy3-preview

4. 填写完成后，点击确定保存配置即可开始使用

手动修改配置文件

1. 打开配置文件

备注

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

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

• Windows 配置路径

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

• Mac/Linux 配置路径

~/.qclaw/openclaw.json

2. 填入配置

打开 openclaw.json 文件，在 models.providers 字段下新增一个自定义大模型提供商（如 cloudbase），各字段含义如下：

字段	说明
baseUrl	大模型 API 的请求地址（Base URL），在 AI 控制台中获取，格式为 https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
apiKey	调用大模型的密钥（API Key），在 AI 控制台中获取
api	API 协议类型，填写 openai-completions 表示使用 OpenAI 兼容协议
models.id	大模型标识，在 AI 控制台 模型列表中复制已启用的模型 ID 填入
models.name	模型显示名称，可自定义填写，一般与 models.id 保持一致即可

配置示例：

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

3. 重启 QClaw，在模型对话框选择新增的自定义模型

常见错误排查

报错信息	解决方法
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 填写错误，或者可能被删除