快速开始

UseClaw 提供兼容 Claude 和 OpenAI 的 API 代理服务。只需几步即可开始使用。

注册账号

访问 app.useclaw.club 注册账号。

创建 API Key

在控制台的 API Keys 页面创建你的第一个 API Key。

充值余额

在充值页面充值余额，最低充值 50 元。

调用 API

使用你的 API Key 调用 API，开始构建 AI 应用。

API 端点

Base URL：https://api.useclaw.club

POST/v1/messagesClaude 格式 - 创建消息

POST/v1/chat/completionsOpenAI 格式 - 聊天补全

GET/v1/models获取可用模型列表

Claude API

兼容 Anthropic 官方 API 格式，只需修改 base_url 即可使用。

Python 示例

Python

from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.useclaw.club"
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude!"}
    ]
)
print(message.content[0].text)

cURL 示例

cURL

curl https://api.useclaw.club/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

OpenAI API

兼容 OpenAI API 格式，只需修改 base_url 即可使用。

Python 示例

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.useclaw.club/v1"
)

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

Node.js 示例

Node.js

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.useclaw.club/v1'
})

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello, GPT!' }]
})
console.log(response.choices[0].message.content)

认证方式

UseClaw 支持两种认证方式，根据你使用的 API 格式选择对应的认证方式。

Claude APIx-api-key Headerx-api-key: sk-uc-xxx

OpenAI APIAuthorization HeaderAuthorization: Bearer sk-uc-xxx

错误处理

API 调用失败时，会返回对应的 HTTP 状态码和错误信息。

4012000未授权，API Key 无效或缺失

4004000账户余额不足，请充值

4046000模型不存在或未启用

4295000请求频率超过限制

5001000服务器内部错误

限流说明

为保证服务稳定性，UseClaw 对 API 调用频率有一定限制。

Claude API (/v1/messages)100 次每分钟

OpenAI API (/v1/chat/completions)100 次每分钟

发送短信验证码5 次每分钟

超过限制时，API 将返回 429 Too Many Requests 错误。请合理控制调用频率。

UseClaw CLI

UseClaw 官方命令行工具，帮助你快速配置 OpenClaw 接入 UseClaw，并管理账户余额和使用情况。

安装

需要 Node.js 18+。

Shell

npm install -g @useclaw/cli

# 验证安装
useclaw --version

命令一览

useclaw setup openclaw配置 OpenClaw 使用 UseClaw 模型

useclaw test验证当前配置是否正常

useclaw balance查看账户余额

useclaw usage [--days n]查看使用情况（默认最近 7 天）

useclaw models列出可用模型

setup openclaw — 配置 OpenClaw 接入

交互式将 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 写入 shell 配置文件，让 OpenClaw 的模型请求路由到 UseClaw。

Shell

# 交互式配置（推荐）
useclaw setup openclaw

# 非交互式（适合脚本/CI）
useclaw setup openclaw --api-key uc-your-key-here

test — 验证配置

检查服务连通性和 API Key 有效性，配置完成后建议先运行一次。

Shell

useclaw test

# 输出示例：
# ✔ 服务正常 (https://api.useclaw.club)
# ✔ API Key 有效
# ✅ 配置正常，OpenClaw 可以正常使用 UseClaw 代理！

balance / usage / models

Shell

# 查看余额
useclaw balance

# 查看最近 7 天使用情况
useclaw usage

# 查看最近 30 天
useclaw usage --days 30

# 列出可用模型
useclaw models

API Key：登录 app.useclaw.club → API Keys → 创建新 Key。余额不足可在充值页面充值。

OpenClaw 小龙虾接入 UseClaw

UseClaw 提供 OpenClaw 小龙虾原生插件 @useclaw/openclaw-model-provider，通过 OpenClaw 的 Plugin 接口（onInit / onRequest / onResponse / onError 钩子）接管模型请求，将请求路由到 UseClaw API，实现统一计费和管理。

工作原理：插件在 onRequest 钩子中自动注入认证头并重定向请求 URL，对 OpenClaw 完全透明，无需修改任何业务代码。

获取 API Key

安装插件

Shell

# 全局安装 OpenClaw 小龙虾插件
npm install -g @useclaw/openclaw-model-provider

# 在 OpenClaw 项目目录中链接插件
cd openclaw
npm link @useclaw/openclaw-model-provider

配置 OpenClaw

在 OpenClaw 配置文件中注册插件，并设置 USECLAW_API_KEY 环境变量。

openclaw.config.json

{
  "plugins": [
    {
      "name": "useclaw-model-provider",
      "env": {
        "USECLAW_API_KEY": "uc-your-api-key-here"
      }
    }
  ]
}

启动 OpenClaw

Shell

# 设置环境变量（或写入配置文件）
export USECLAW_API_KEY=uc-your-api-key-here

# 启动 OpenClaw
openclaw

# 插件初始化输出示例：
# [UseClaw] 模型提供商已初始化，API 地址: https://api.useclaw.club
# [UseClaw] 当前余额: ¥128.50

插件初始化后会自动打印余额，余额低于 ¥10 时显示告警。

插件功能

🔀

请求代理

通过 onRequest 钩子自动注入认证头，将模型请求路由到 UseClaw

⚠️

余额预警

启动时自动检查余额，低于阈值（默认 ¥10）打印醒目告警

📋

请求日志

记录每次请求耗时和状态码，便于排查问题

🛡️

错误提示

余额不足、认证失败等错误给出明确的中文提示和操作指引

环境变量

USECLAW_API_KEY✅ 必填UseClaw API Key，以 uc- 开头

USECLAW_BASE_URL选填UseClaw API 地址，默认 https://api.useclaw.club

USECLAW_LOW_BALANCE_WARN选填低余额告警阈值（元），默认 10

验证连通性

cURL

# 健康检查
curl https://api.useclaw.club/v1/health

# 发送测试请求
curl https://api.useclaw.club/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: uc-your-api-key-here" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"claude-haiku-4-5-20251001","messages":[{"role":"user","content":"Say hi"}],"max_tokens":16}'

联系我们

如需商务合作、技术支持或发票申请，请发送邮件至 contact@withflows.ai。