跳到主要内容

QClaw

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

准备工作​

codebuddy

配置步骤​

我们以 QClaw-v0.2.25 为例

方式一：QClaw 设置配置​

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

qclaw.png

  1. 点击自定义配置

qclaw1.png

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

qclaw2.png

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

qclaw5.png

方式二：手动修改本地配置文件​

  1. 打开配置文件
备注

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

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

  • Windows 配置路径
C:\Users\<你的用户名>\.qclaw\openclaw.json
  • Mac/Linux 配置路径
~/.qclaw/openclaw.json
  1. 填入配置

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

字段说明
baseUrl大模型 API 的请求地址（Base URL），在 AI 控制台中获取，格式为 https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
apiKey调用大模型的密钥（API Key），在 AI 控制台中获取
apiAPI 协议类型，填写 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"
          }
        ]
      }
    }
  }
}
  1. 重启 QClaw，在模型对话框选择新增的自定义模型

qclaw4.png

常见错误排查​

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