OpenClaw（小龙虾）接入

更新于 2026-08-27

OpenClaw（小龙虾）是开源的命令行 AI Agent。它支持自定义模型 Provider——把 Provider 指到本站，就能用一把 sk- Key 驱动全部在架模型，按量计费、余额透明。

调用链路：**OpenClaw → https://api.ai526.com → 多家上游自动调度**。上游故障时本站自动切换线路，OpenClaw 侧无感。

前置准备

注册账号并充值（最低 1 元即可开跑）；
在控制台 → API Key 创建一把 Key（完整 Key 只展示一次，立即复制）；
本机已安装 OpenClaw（安装方式见 docs.openclaw.ai 官方文档）。

基础事实

主配置文件：~/.openclaw/openclaw.json，JSON5 格式（支持注释与尾逗号）；
自定义 Provider 写在 models.providers 键下；
任何字符串值可用 ${VAR_NAME} 引用环境变量（仅大写字母/数字/下划线），env 来源包括当前目录 .env 与全局 ~/.openclaw/.env；
模型引用格式固定为 <provider-id>/<model-id>，必须带 provider 前缀。

三分钟接入（OpenAI 协议，推荐）

第 1 步：把 Key 写进 ~/.openclaw/.env（避免明文进配置文件）：

echo 'AI526_API_KEY=sk-你的Key' >> ~/.openclaw/.env

第 2 步：编辑 ~/.openclaw/openclaw.json，粘贴以下配置（本模板按你当前在架模型实时生成，与控制台概览页「一键复制配置」同源）：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "ai526/claude-opus-5"
      },
      "models": {
        "ai526/claude-opus-5": {
          "alias": "claude-opus-5"
        },
        "ai526/claude-opus-4-8": {
          "alias": "claude-opus-4-8"
        },
        "ai526/gpt-5.5": {
          "alias": "gpt-5.5"
        },
        "ai526/gpt-5.6-terra": {
          "alias": "gpt-5.6-terra"
        },
        "ai526/gpt-5.4": {
          "alias": "gpt-5.4"
        },
        "ai526/gpt-5.4-mini": {
          "alias": "gpt-5.4-mini"
        }
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "ai526": {
        "baseUrl": "https://api.ai526.com/v1",
        "apiKey": "${AI526_API_KEY}",
        "api": "openai-completions",
        "timeoutSeconds": 600,
        "models": [
          {
            "id": "claude-opus-5",
            "name": "claude-opus-5 (ai526)",
            "input": [
              "text"
            ]
          },
          {
            "id": "claude-opus-4-8",
            "name": "claude-opus-4-8 (ai526)",
            "input": [
              "text"
            ]
          },
          {
            "id": "gpt-5.5",
            "name": "gpt-5.5 (ai526)",
            "input": [
              "text"
            ]
          },
          {
            "id": "gpt-5.6-terra",
            "name": "gpt-5.6-terra (ai526)",
            "input": [
              "text"
            ]
          },
          {
            "id": "gpt-5.4",
            "name": "gpt-5.4 (ai526)",
            "input": [
              "text"
            ]
          },
          {
            "id": "gpt-5.4-mini",
            "name": "gpt-5.4-mini (ai526)",
            "input": [
              "text"
            ]
          }
        ]
      }
    }
  }
}

要点：

OpenAI 兼容端点的 baseUrl **必须带 /v1 后缀**：https://api.ai526.com/v1；
models[].id 必须与本站 GET /v1/models 返回的模型 ID 完全一致；
官方文档称 modelPolicy.allow 是「可选显式 allowlist」，而第三方教程称不配 agents.defaults.models 模型会被拒——两处说法有出入，是否硬性必需未确认，稳妥起见模板两处都配了。

第 3 步：重启 gateway 使 Provider 生效（配置虽有热加载，但官方建议 models.providers 改动后重启）：

openclaw gateway restart

配置写坏时可用 openclaw doctor --fix 校验修复。

第 4 步：验证——让 agent 说句话；或直接 curl 本站确认 Key 可用：

curl https://api.ai526.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"模型ID","messages":[{"role":"user","content":"ping"}]}'

进阶：Anthropic 协议接入

想让 OpenClaw 走 Anthropic Messages 协议时，另起一个自定义 Provider（不要改官方 anthropic Provider），注意 baseUrl 不带 /v1：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "ai526an/claude-opus-5"
      },
      "models": {
        "ai526an/claude-opus-5": {
          "alias": "claude-opus-5"
        }
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "ai526an": {
        "baseUrl": "https://api.ai526.com",
        "apiKey": "${AI526_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-5",
            "name": "claude-opus-5 (ai526)"
          }
        ]
      }
    }
  }
}

其他进阶用法：

fallbacks：agents.defaults.model.fallbacks 配主模型不可用时的回退列表（同样必须 provider/model 全名）；
别名：agents.defaults.models 里的 alias 让你在会话中用短名切换模型；
openai-responses：若模型文档页标注支持 /v1/responses，Provider 的 api 可改为 "openai-responses"；默认推荐 openai-completions。

常见错误排查表

症状	原因	处置
模型被拒 / 报模型名不合法	引用没带 provider 前缀（只写了 `claude-opus-5`）	一律写 `ai526/claude-opus-5` 全名
配了 Provider 仍提示模型不可用	只配了 `models.providers` 没配 `agents.defaults.models`（是否硬性必需未确认）	两处都配（模板已含）
404 Not Found	OpenAI 方式 baseUrl 漏了 `/v1`，或 Anthropic 方式多写了 `/v1`	模板 A 带 `/v1`、模板 B 不带
401	Key 错误 / 被禁用；或 `.env` 未被加载（变量名不是全大写）	核对 Key；变量名须匹配大写字母/数字/下划线
402	本站余额不足	前往控制台充值
请求打到了官方端点而不是本站	旧版本 OpenClaw 的已知问题：自定义 Provider 的 baseUrl / apiKey 未传播到模型对象（新版是否已修复未确认）	升级 OpenClaw；确认 provider id 无拼写错误
改了配置不生效	`models.providers` 改动需要重启 gateway	`openclaw gateway restart`
模型名对不上	`models[].id` 与本站 `GET /v1/models` 返回不一致	以本站返回的 id 为准逐字符核对
setup-token 认证异常	OpenClaw 历史问题（与本站无关）	接本站只用 API Key 方式，不涉及 setup-token

未确认事项声明

本教程依据 docs.openclaw.ai 现行文档与社区实践整理，以下条目在官方文档中表述不一或未明确，已在正文标注「未确认」：

agents.defaults.models / modelPolicy.allow 是否为硬性必需；
旧版路径 ~/.clawdbot/clawdbot.json 的符号链接兼容行为；
旧版本「自定义 Provider baseUrl 未传播」问题在新版的修复状态。

遇到与本文不符的行为，请以 docs.openclaw.ai 现行文档为准，也欢迎发邮件到 [email protected] 帮我们更新教程。