ClawDK 使用文档

快速开始

三分钟接入ClawDK：注册、充值、创建令牌、修改 Base URL，其余代码保持不变。

接入步骤

1. 注册登录：进入控制台注册账号（支持邮箱登录）。立即注册 →
2. 充值：控制台 → 充值，支付宝扫码支付。余额按 ¥1 = $1 价格额度 换算，永久有效。
3. 创建令牌：控制台 → 令牌 → 新建令牌，生成 sk-*** 格式的 API Key（可设置额度与过期时间）。
4. 接入应用：把应用的 Base URL 改为 https://newapi.clawdk.com/v1，填入你的令牌，即可调用。

最小示例

# 安装：pip install openai
# 只改这一行：Base URL 指向ClawDK
client = OpenAI(base_url="https://newapi.clawdk.com/v1", api_key="sk-***")

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

模型与价格

统一接入 Anthropic、OpenAI、Google 等主流模型，¥1 余额 = $1 价格额度，按量计费无月费。

价格表

计费规则

• 统一口径：¥1 = $1 价格额度，模型价格按 USD 标价展示，扣费按相同数值从人民币余额扣除。
• 缓存价格：启用缓存读取的请求按「缓存 / 1M」价格计费，约为输入价的 1/10。
• 按量计费：无月费、无订阅，实际用多少扣多少；余额永久有效。
• 折扣说明：折扣可能随上游成本波动，实时价格以控制台为准。

完整模型列表请在控制台「模型价格」页查看，或通过 模型列表接口 获取。

接入指南

任何兼容 OpenAI 协议的 SDK 均可接入，修改 base_url 即可。

Python

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://newapi.clawdk.com/v1",  # 只改这一行
    api_key="sk-***",
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

TypeScript / Node.js

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://newapi.clawdk.com/v1", // 只改这一行
  apiKey: process.env.API_KEY,
});

const res = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(res.choices[0].message.content);

curl

curl https://newapi.clawdk.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

常用参数

客户端配置

Claude Code、Codex、OpenClaw、CC Switch、Hermes 等客户端均支持接入。

Claude Code

通过环境变量指定上游地址与令牌：

# 只改这两行
export ANTHROPIC_BASE_URL="https://newapi.clawdk.com"
export ANTHROPIC_AUTH_TOKEN="sk-***"

Codex CLI（OpenAI）

# 只改这一行
model_provider = "clawdk"

[model_providers.clawdk]
name = "ClawDK"
base_url = "https://newapi.clawdk.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

OpenClaw

OpenClaw 走 OpenAI 兼容配置，设置环境变量即可：

export OPENAI_BASE_URL="https://newapi.clawdk.com/v1"
export OPENAI_API_KEY="sk-***"

CC Switch

1. 打开 CC Switch，点击「+」新增供应商。
2. 名称填 ClawDK，Base URL 填 https://newapi.clawdk.com/v1。
3. 填入你的令牌，选择模型后一键切换启用。

Hermes / 其他 OpenAI 兼容客户端

任何兼容 OpenAI 协议的客户端（Cursor、Cherry Studio、NextChat、LobeChat 等）接入方式一致：

• Base URL：https://newapi.clawdk.com/v1
• API Key：控制台创建的令牌
• 模型：选择或填写模型名称（如 gpt-5.5）

计费与充值

先充值后消费，余额永久有效；¥1 = $1 价格额度，按量扣费。

充值流程

1. 控制台 → 充值 → 选择金额（最低 ¥20）。
2. 支付宝扫码支付，余额实时到账。
3. 充值后即可调用，按实际用量扣费。

费用明细

• 输入 / 输出 / 缓存：分别按 token 计费，价格以模型价格页为准。
• 用量监控：控制台按模型、项目、时间维度查看 token 消耗趋势，可导出账单。
• 请求日志：完整记录每次请求的 prompt、响应、延迟与错误，支持一键重放调试。

发票

充值消耗满 ¥20 可申请增值税发票（普票/专票），在控制台账单页提交申请即可。

接口总览

所有接口与 OpenAI 官方格式兼容，仅需替换 Base URL 与鉴权令牌。

基本信息

端点清单

模型列表

获取当前开放的全部模型。

请求

curl https://newapi.clawdk.com/v1/models \
  -H "Authorization: Bearer sk-***"

响应

{
  "object": "list",
  "data": [
    { "id": "gpt-5.5", "object": "model", "created": 1786416000, "owned_by": "openai" },
    { "id": "claude-opus-4-8", "object": "model", "created": 1786416000, "owned_by": "anthropic" }
  ]
}

data[].id 即调用时使用的模型名。

对话补全

核心接口，支持普通与流式（SSE）两种模式。

请求

curl https://newapi.clawdk.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "你是一个乐于助人的助手"},
      {"role": "user", "content": "介绍一下ClawDK"}
    ],
    "stream": false
  }'

请求参数

余额查询

查询当前账户余额与用量。

请求

curl "https://newapi.clawdk.com/v1/dashboard/billing/usage" \
  -H "Authorization: Bearer sk-***"

响应

{
  "object": "list",
  "total_usage": 125000,        # 单位：token
  "quota": 100.0,               # 剩余额度（¥）
  "used_quota": 23.5            # 已用额度（¥）
}

更详细的用量趋势请在控制台「用量」页查看（支持按模型、项目、时间维度筛选与导出）。

错误码

常见错误码与处理建议。

常见问题

关于接入、计费、稳定性的高频问题。

接入相关

• 和直接申请官方 API 有什么区别？
  统一接入点，支付宝充值，稳定直连，附带用量统计、日志、团队管理，无需境外信用卡与代理配置。
• 现有代码怎么迁移？
  把 base_url 改为 https://newapi.clawdk.com/v1，填入令牌即可，OpenAI SDK 零改动。
• 支持哪些客户端？
  Claude Code、Codex、OpenClaw、CC Switch、Hermes、Cursor 及任何 OpenAI 兼容客户端，配置见「客户端配置」。

计费相关

• 充值比例怎么换算？
  ¥1 = $1 价格额度，模型价格按 USD 标价展示，扣费按相同数值从人民币余额扣除。
• 支持哪些付款方式？
  支付宝支付，余额实时到账，按实际用量扣费，余额永久有效。
• 可以开发票吗？
  充值消耗满 ¥20 可申请增值税发票（普票/专票），控制台账单页提交。
• 缓存怎么计费？
  缓存读取按「缓存 / 1M」价格计费，约为输入价的 1/10，大幅降低重复请求成本。

稳定性与安全

• 如何保证稳定性和速度？
  多地区转发节点自动选路，与上游保持稳定连接池，正常延迟 < 200ms，提供 99.9% 可用性 SLA。
• 数据安全性如何？
  不存储对话内容，请求转发后即丢弃；令牌加密存储；数据不用于任何模型训练。
• 令牌泄露了怎么办？
  控制台 → 令牌 → 立即禁用并新建令牌；建议为每个项目单独建令牌并设置额度上限。

联系我们

使用问题、企业采购、合作洽谈，随时找到我们。

支持渠道

• 微信交流群：扫描首页页尾二维码加入（公告与故障通知第一时间同步）。
• 邮件：contact@clawdk.com（市场合作 / 商务）
• 需求反馈：控制台内提交，或在邮件中附上请求日志便于排查。

企业服务

支持企业级采购与合作：专属通道、独立额度、定制化接入方案、更完善的配套服务。欢迎邮件沟通。