OpenClaw

适用边界

OpenClaw 是自托管 agent gateway，provider schema 会随版本变化。本文按公开文档中的 OpenAI-compatible provider 思路说明 Ling.AI 接入方式：Base URL 使用 https://api.lingyuncx.com/v1，模型 ID 使用 /v1/models 当前返回值。落地前请对照本机 OpenClaw 版本确认字段名。

准备

• 安装 OpenClaw，并确认当前版本提供自定义模型 provider 配置。
• 在 Ling.AI 控制台创建 API Key，确认余额、套餐和模型授权可用。
• 请求 GET https://api.lingyuncx.com/v1/models，复制一个适合 agent 任务的模型 ID。
• 确认 OpenClaw 的配置文件位置。不同版本可能使用项目配置、用户配置或服务端配置文件。
• 如果用 CC Switch 管理工具 provider，先安装并启动 CC Switch。

直接配置

1. 定位配置文件。 在 OpenClaw 当前版本文档中确认 provider 配置入口，常见位置是项目或服务端的模型配置文件。
2. 新增 provider。 添加 provider id，例如 lingai。
3. 选择协议。 使用 OpenAI-compatible / openai-completions 方向。
4. 填写 Base URL。 设置为 https://api.lingyuncx.com/v1。
5. 绑定 API Key。 优先从环境变量 LING_AI_API_KEY 读取，不把真实 Key 写入仓库。
6. 填写模型。 只写 /v1/models 当前返回的模型 ID。

配置示例

下面是 provider 字段示意。实际字段名请以当前 OpenClaw 版本文档为准。

{
  "models": {
    "providers": {
      "lingai": {
        "api": "openai-completions",
        "baseUrl": "https://api.lingyuncx.com/v1",
        "apiKey": "env:LING_AI_API_KEY",
        "models": [
          "your-model-id-from-v1-models"
        ]
      }
    }
  }
}

CC Switch 配置

CC Switch 支持 OpenClaw app-specific provider。通过 CC Switch 配置时，不需要单独新建 CC Switch 页面，直接在 OpenClaw 工具页新增 Ling.AI provider。

1. 打开 OpenClaw 工具页。 启动 CC Switch，选择 OpenClaw。
2. 新增 provider。 点击加号或 Add Provider。
3. 选择自定义供应商。 使用 Custom Configuration、API Key Provider 或当前版本等价入口。
4. 填写名称。 Provider Name 填 Ling.AI。
5. 填写 Base URL。 输入 https://api.lingyuncx.com/v1。
6. 填写 API Key。 粘贴 Ling.AI API Key，或使用本机密钥引用。
7. 填写模型。 Model ID 填 /v1/models 当前返回值。
8. 保存启用。 Enable / Switch 后重启 OpenClaw，再执行模型列表或短 prompt 验证。

验证

1. 运行 OpenClaw 当前版本提供的模型列表命令，例如 openclaw models list。
2. 确认能看到 Ling.AI provider 下的模型。
3. 发送一个不修改文件的短 prompt。
4. 到 Ling.AI 控制台核对请求状态、模型 ID、usage 和钱包扣费。

排障

参考资料

• OpenClaw Model Providers
• OpenClaw OpenAI Provider
• CC Switch 官方仓库