腾讯云 OpenClaw

在腾讯云轻量应用服务器（Lighthouse）的 OpenClaw / Agent 管理中，通过自定义模型 JSON 接入 QiyuanHub。

适用场景

腾讯云 Lighthouse Agent（OpenClaw / 龙虾）支持在「Agent 管理 → 模型-通道-技能 → 自定义模型」中填写第三方 OpenAI 兼容接口。将 Provider 指向 QiyuanHub 后，对话与 Agent 调用会计入你的平台额度。

已在腾讯云购买并部署 Lighthouse OpenClaw（或等价 Agent 镜像）
已在 QiyuanHub 控制台创建 API Key（sk-opc-...），账户审核通过且余额充足
已知目标模型 slug（deepseek-v4.1），与控制台「模型 & 定价」一致

配置入口

当前配置通常仅作用于选中的 Agent，不会自动同步到其他 Agent；如需多助手共用，请分别添加或导出复用 JSON。

1. 打开 Agent 管理

进入 Lighthouse Agent 控制台侧栏「设置 → Agent 管理」，选中要配置的 Agent（如通用助手）。

2. 进入模型配置

切换到「模型-通道-技能」页签，展开「自定义模型」。

3. 选择 JSON 输入

在「JSON 输入 / 表单输入」中选择「JSON 输入」，粘贴下方示例并替换 API Key 与模型。

自定义模型 JSON

按腾讯云 Lighthouse Agent「自定义模型 → JSON 输入」填写。`api` 必须为 `openai-completions`（填 `openai` 无法连通）；`base_url` 填 QiyuanHub 网关（含 `/v1`）；`api_key` 填平台密钥。

关键：腾讯云 OpenClaw / Lighthouse Agent 的 `api` 字段需写成 `openai-completions`，不要写成 `openai`，否则连通性检测会失败。

JSON 输入示例

{
  "provider": "qiyuan-hub",
  "base_url": "https://api.qiyuanapi.cc/v1",
  "api_key": "sk-opc-your-api-key",
  "api": "openai-completions",
  "model": {
    "id": "deepseek-v4.1",
    "name": "DeepSeek V4.1"
  }
}

字段说明

`provider`：自定义标识，建议 `qiyuan-hub`（与腾讯云侧展示的 custom_qiyuan-hub 前缀对应）
`base_url`：必须为 `https://api.qiyuanapi.cc/v1`（含 /v1）
`api_key`：QiyuanHub 控制台创建的完整密钥，格式 sk-opc-...
`api`：必须填 `openai-completions`（腾讯云 OpenClaw 要求；填 `openai` 无法连接）
`model.id`：必须与 QiyuanHub `/v1/models` 返回的 slug 完全一致
`model.name`：仅用于界面展示，可自定义

验证与排查

1. 连通性检测

在腾讯云控制台点击「连通性检测」，确认通过后再「添加为默认」。

2. 保存后发起对话

在 Agent 对话页发送「你好」，确认能返回内容。

3. 核对 QiyuanHub 使用日志

打开 QiyuanHub 控制台 → 使用日志，确认出现对应模型与扣费记录。

4. 常见失败点

`api` 误填为 `openai`（应改为 `openai-completions`）
Key 被截断或混入空格
账户仍为 pending（未审核）
余额不足
model.id 写成展示名而非 slug
base_url 漏写 /v1 或重复拼接 /v1

可选：openclaw.json 等效配置

若你使用自建 OpenClaw（非腾讯云 UI），也可在 `~/.openclaw/openclaw.json` 中以 providers 方式接入，效果等价：

{
  "models": {
    "mode": "merge",
    "providers": {
      "qiyuan-hub": {
        "baseUrl": "https://api.qiyuanapi.cc/v1",
        "apiKey": "sk-opc-your-api-key",
        "api": "openai-completions",
        "models": [
          { "id": "deepseek-v4.1", "name": "DeepSeek V4.1" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "qiyuan-hub/deepseek-v4.1" },
      "models": { "qiyuan-hub/deepseek-v4.1": {} }
    }
  }
}

{ "provider": "qiyuan-hub", "base_url": "https://api.qiyuanapi.cc/v1", "api_key": "sk-opc-your-api-key", "api": "openai-completions", "model": { "id": "deepseek-v4.1", "name": "DeepSeek V4.1" } }

{ "models": { "mode": "merge", "providers": { "qiyuan-hub": { "baseUrl": "https://api.qiyuanapi.cc/v1", "apiKey": "sk-opc-your-api-key", "api": "openai-completions", "models": [ { "id": "deepseek-v4.1", "name": "DeepSeek V4.1" } ] } } }, "agents": { "defaults": { "model": { "primary": "qiyuan-hub/deepseek-v4.1" }, "models": { "qiyuan-hub/deepseek-v4.1": {} } } } }