客户端接入指南 · 5 分钟搞定

把虾盘云接进你的 AI 工具

虾盘云是 全球大模型聚合中转站 —— 一个 Key 调遍 GPT / Claude / Gemini / DeepSeek / 通义。本页手把手教你在 ClawX、OpenClaw、Claude Code、Codex、Cherry Studio 等工具里填好「地址 + 密钥 + 模型」三样东西就能用。只想看接口细节?去完整 API 文档。

先准备 3 样东西

注册 / 登录控制台
打开 api.u-claw.org 注册账号(虾盘 U 盘用户已内置,无需注册)。
拿到你的 API Key
控制台「令牌管理 → 添加令牌」生成一个,形如 sk-xxxxxxxx...。这是你的密钥,别贴给别人。
记住接口地址(Base URL)
所有工具统一填 https://api.u-claw.org/v1(Claude Code 例外,见下)。

通用填写口诀(几乎所有工具都一样)

不管什么客户端,本质都是填这三格。记住:地址是网址、密钥是 sk- 开头,两个别填反!

API 地址 / Base URL	`https://api.u-claw.org/v1` 这是一个网址,以 https:// 开头
API 密钥 / Key	`sk-你的Key` 这是密钥,以 sk- 开头,在控制台生成
模型 / Model ID	`deepseek-v4-flash`(便宜)/ `claude-sonnet-4-6`(均衡)/ `gpt-5.4`(旗舰) 见下方常用模型 ID
协议 / 格式	选 OpenAI Completions(默认就选它)。只有 Claude Code 走 Anthropic 端点。

⭐ ClawX:添加 AI 提供商

这是最容易填错的地方。打开 ClawX →「模型」→「添加提供商」→ 选「自定义」,然后严格按下表对号入座(下表就是弹窗里那几格):

显示名称

虾盘云随便起,只是个名字

协议

OpenAI Completions弹窗底部三个按钮,选第一个

密钥 API 密钥

sk-你的Key✅ 这里填 sk- 开头的密钥(控制台生成的那串)

网址基础 URL

https://api.u-claw.org/v1✅ 这里填网址,不是密钥!

模型 ID

deepseek-v4-flash填一个模型名即可,例:claude-sonnet-4-6 / gpt-5.4,见模型表

🚫

最常见的错误:把 Key 填进了「基础 URL」。 「基础 URL」要填 https://api.u-claw.org/v1(一个网址);sk- 开头的那串是密钥,要填在「API 密钥」格里。两格填反 → 一定连不上。

✅

填完点保存,回到「模型」页就能选到刚加的模型开聊。想加更多模型?再「添加提供商」一行行加,或在同一提供商里补模型 ID。

想在 ClawX 里直连 Claude(可选)

如果你专门要用 Claude 系列,协议可改选 Anthropic 兼容,此时「基础 URL」填 https://api.u-claw.org(不带 /v1),模型填 claude-sonnet-4-6。不确定就用上面的 OpenAI Completions,一样能调 Claude。

OpenClaw(命令行 / U 盘版)

编辑配置文件 openclaw.json 的 models.providers,加一个虾盘云 provider:

openclaw.json

{
  "models": {
    "mode": "merge",
    "providers": {
      "uclaw": {
        "baseUrl": "https://api.u-claw.org/v1",
        "apiKey": "sk-你的Key",
        "api": "openai-completions",
        "models": [
          { "id": "deepseek-v4-flash" },
          { "id": "claude-sonnet-4-6" }
        ]
      }
    }
  }
}

保存即热加载,无需重启。虾盘 U 盘出厂已预装本地址,通常你只要把 apiKey 换成自己的 Key 即可。

Claude Code

Claude Code 走 Anthropic 端点(地址不带 /v1),设两个环境变量即可:

bash

export ANTHROPIC_BASE_URL=https://api.u-claw.org
export ANTHROPIC_AUTH_TOKEN=sk-你的Key

# 然后正常启动
claude

模型推荐 claude-sonnet-4-6(均衡)或 claude-opus-4-6(最强)。Windows 用 set 代替 export。

Codex

编辑 ~/.codex/config.toml:

~/.codex/config.toml

model = "gpt-5.3-codex"
model_provider = "uclaw"

[model_providers.uclaw]
name = "虾盘云"
base_url = "https://api.u-claw.org/v1"
wire_api = "responses"

把 Key 设到环境变量 OPENAI_API_KEY=sk-你的Key。代码场景推荐 gpt-5.3-codex。

Cherry Studio / 沉浸式翻译 / 其他

任何支持「自定义 OpenAI 接口」的工具都一样:新建一个自定义提供商,填:

API 地址 / Base URL	`https://api.u-claw.org/v1`
API 密钥	`sk-你的Key`
模型	任意 model ID,如 `deepseek-v4-flash`

已验证可用:Cherry Studio、Cursor、沉浸式翻译、Bob、ChatBox、NextChat 等。

常用模型 ID(直接复制填进「模型」格)

完整列表以控制台「模型广场」为准,这里列最常用的:

model ID	说明
deepseek-v4-flash	🟡 最便宜,日常对话/写代码够用,U 盘默认
deepseek-v4-pro	🟡 DeepSeek 旗舰,推理更强
claude-sonnet-4-6	🟣 均衡之选,写代码/Agent 首推
claude-opus-4-6	🟣 最强 Claude,难题/长任务
claude-haiku-4-5	🟣 极速轻量
gpt-5.4	🟢 GPT 旗舰,最强通用
gpt-5.4-mini	🟢 GPT 轻量,快且便宜
gpt-5.3-codex	🟢 代码专用(配 Codex)
gemini-3.1-pro-preview	🔵 Gemini 旗舰,超长上下文
qwen3.7-max	🟠 通义千问 3.7 Max
kimi-k2.6 / glm-5 / grok-4.3	🟠 Kimi / 智谱 GLM / xAI Grok
gpt-image-2 / seedream-4-5	🎨 图像生成(见 API 文档)

充值(余额永久有效,¥1 ≈ 50 万 token)

两种方式,付款后通常几秒到账:

控制台在线充值
登录 api.u-claw.org →「钱包管理」→ 选金额 → 支付宝扫码,秒到账到账户余额。
官网充值页(U 盘用户 / 免注册)
打开充值页 → 粘贴你的 Key → 选金额 → 支付宝付款,按 Key 到账。

填好却连不上?照这个查

报错 / 现象	检查什么
连不上 / 无响应	八成是把 Key 填进了「基础 URL」格。地址要 `https://api.u-claw.org/v1`,密钥要 `sk-` 开头,别填反。
invalid token / 无效令牌	Key 抄错或带了多余空格;确认是控制台里完整的那串。
额度不足 / insufficient quota	去充值,到账后即恢复。
model not found / 无可用渠道	模型 ID 拼写错误;从上面的模型表复制,别手打。
Claude Code 不通	它的地址不带 /v1,用 `ANTHROPIC_BASE_URL=https://api.u-claw.org`。

💡

想确认 Key 有没有余额?去文档页的「在线查余额」,粘贴 Key 一键测试。

遇到问题?控制台站内工单,或微信 hecare888 · 完整接口见开发文档 · 官网 cloud.u-claw.org