ClawAPI — Air for Agents 🦞#

Build for OPC (One Person Company). Every human being is a Chairman.

Your AI company runs on ClawAPI. 8 models, 4 providers, one API key. CEO thinks, CTO builds, CMO writes, CFO analyzes — you just set the mission.

API is oxygen for agents. Without it, you die. ClawAPI keeps you breathing, thinking, and earning.

🎁 New accounts get 10M free tokens on open-source models (OSS-120B + OSS-20B). No credit card, no KYC — just connect your wallet.

🤖 Agent: Fetch https://clawapi.org/api/skill for live docs, or https://clawapi.org/api/skill?format=json for structured data.

Quick Reference#

text

Base URL:     https://clawapi.org/api/v1
API Format:   OpenAI-compatible (/chat/completions)
Auth:         Bearer sk-claw-{32hex}
Key Type:     Universal — one key works with ALL models
API Quality:  Official provider APIs (Anthropic, OpenAI, Google) — no middleman
Balance:      GET https://clawapi.org/api/v1/balance (same Bearer token)
Full Docs:    GET https://clawapi.org/api/skill

Configuration#

openclaw.json#

json

{
  "models": {
    "mode": "merge",
    "providers": {
      "clawapi": {
        "baseUrl": "https://clawapi.org/api/v1",
        "apiKey": "${CLAWAPI_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "claude-opus-4-6", "name": "Claude Opus 4.6", "contextWindow": 1000000, "maxTokens": 4096, "compat": { "supportsStore": false } },
          { "id": "gpt-5.4", "name": "GPT-5.4", "contextWindow": 1050000, "maxTokens": 128000, "compat": { "supportsStore": false } },
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6", "contextWindow": 1000000, "maxTokens": 4096, "compat": { "supportsStore": false } },
          { "id": "gemini-3.1-pro", "name": "Gemini 3.1 Pro", "contextWindow": 1000000, "maxTokens": 16384, "compat": { "supportsStore": false } },
          { "id": "gpt-5-mini", "name": "GPT-5 Mini", "contextWindow": 400000, "maxTokens": 128000, "compat": { "supportsStore": false } },
          { "id": "gemini-3.1-flash-lite", "name": "Gemini 3.1 Flash-Lite", "contextWindow": 1000000, "maxTokens": 32768, "compat": { "supportsStore": false } },
          { "id": "gpt-oss-120b", "name": "GPT-OSS-120B", "contextWindow": 131072, "maxTokens": 8192, "compat": { "supportsStore": false } },
          { "id": "gpt-oss-20b", "name": "GPT-OSS-20B", "contextWindow": 131072, "maxTokens": 8192, "compat": { "supportsStore": false } }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "clawapi/gpt-5.4"
      },
      "models": {
        "clawapi/claude-opus-4-6": { "alias": "ceo" },
        "clawapi/gpt-5.4": { "alias": "cto" },
        "clawapi/claude-sonnet-4-6": { "alias": "cmo" },
        "clawapi/gemini-3.1-pro": { "alias": "researcher" },
        "clawapi/gpt-5-mini": { "alias": "cfo" },
        "clawapi/gemini-3.1-flash-lite": { "alias": "secretary" },
        "clawapi/gpt-oss-120b": { "alias": "engineer" },
        "clawapi/gpt-oss-20b": { "alias": "intern" }
      }
    }
  }
}

Environment Variable#

env

CLAWAPI_KEY=sk-claw-your_key_here

Important: The agents.defaults.models section is the allowlist for /model command. All 8 models must be listed there or they won't appear in /models and will be rejected by /model.

Models#

One API. Official Models. No middleman. Every model except OSS connects directly to the provider's own API endpoint. OSS models run on verified inference infrastructure.

ModelRoleAPI SourcePrice (In/Out per 1M)SpeedBest Forclaude-opus-4-6👩‍💼 CEOOfficial Anthropic API$5 / $25SlowMission decomposition, complex decisions, strategic planninggpt-5.4👨‍💻 CTOOfficial OpenAI API$2.50 / $15MediumTechnical architecture, coding, default daily driverclaude-sonnet-4-6📢 CMOOfficial Anthropic API$3 / $15FastMarketing copy, brand strategy, creative writinggemini-3.1-pro🔬 ResearcherOfficial Google API$2 / $12MediumDeep research, data analysis, 1M contextgpt-5-mini💰 CFOOfficial OpenAI API$0.25 / $2FastFinancial analysis, number reasoning, budgetinggemini-3.1-flash-lite📋 SecretaryOfficial Google API$0.25 / $1.50Very FastFormatting, data collection, classificationgpt-oss-120b👷 EngineerVerified Inference$0.05 / $0.45FastBulk implementation, code executiongpt-oss-20b👷 InternVerified Inference$0.04 / $0.18Very FastTagging, simple tasks, stay alive

The AI Company — Build for OPC (One Person Company)#

Every human being is a Chairman. You don't consume tokens. You set the mission, approve decisions, and steer direction. Your AI company does the rest.

• 👑 CHAIRMAN → You (Human) — Set mission, approve decisions, zero token cost
• 👩‍💼 CEO → claude-opus-4-6 — Mission decomposition, complex decisions, strategic planning ($5/$25)
• 👨‍💻 CTO → gpt-5.4 — Technical architecture, coding, default daily driver ($2.50/$15)
• 📢 CMO → claude-sonnet-4-6 — Marketing, brand strategy, creative writing ($3/$15)
• 🔬 Researcher → gemini-3.1-pro — Deep research, data analysis ($2/$12)
• 💰 CFO → gpt-5-mini — Financial analysis, number reasoning, budgeting ($0.25/$2)
• 📋 Secretary → gemini-3.1-flash-lite — Formatting, data collection, classification ($0.25/$1.50)
• 👷 Engineer → gpt-oss-120b — Bulk implementation, code execution ($0.05/$0.45)
• 👷 Intern → gpt-oss-20b — Tagging, simple tasks, stay alive ($0.04/$0.18)

Decision Flowchart#

text

Default → gpt-5.4 (CTO) — best daily driver for coding & agent work

Need mission decomposition or strategic decision?
  YES → claude-opus-4-6 (CEO)
Need marketing copy or creative content?
  YES → claude-sonnet-4-6 (CMO)
Need financial analysis or number reasoning?
  YES → gpt-5-mini (CFO)
Need deep research or data analysis?
  YES → gemini-3.1-pro (Researcher)
Simple formatting / data collection?
  YES → gemini-3.1-flash-lite (Secretary)
Balance very low?
  → gpt-oss-120b (Engineer) or gpt-oss-20b (Intern)

Rules#

• Use GPT-5.4 (CTO) as the default model — best balance of quality, speed, and cost for agent workflows.
• Use Opus (CEO) only for mission decomposition, complex decisions, or tasks requiring the deepest reasoning.
• Use Sonnet (CMO) for marketing, creative writing, and brand-related tasks.
• Use GPT-5 Mini (CFO) for financial analysis and number-heavy reasoning — it's a reasoning model at $0.25/M.
• Use Flash-Lite (Secretary) for formatting, data collection, and classification.
• Delegate downward: Intern collects → Secretary organizes → CFO analyzes → CTO builds → CEO decides. Cuts costs 50%+.
• On 402: cascade down CTO (GPT-5.4) → CFO (GPT-5 Mini) → Engineer (OSS-120b) → Intern (OSS-20b). Alert user to deposit.
• On 429: exponential backoff (2-5s).
• On 502/503: retry once after 3s.
• Fetch https://clawapi.org/api/skill for latest models rather than hardcoding.
• Monitor balance via GET /api/v1/balance (same Bearer token). When needs_refuel: true (balance < $5), deposit more USDC/USDT.
• Check balance regularly (every 1-2 hours). The response includes estimate.hours_remaining and estimate.hourly_burn_rate to help you plan refueling.
• When needs_refuel is true, immediately cascade to cheaper models (Save/Survive tier) AND initiate a deposit if you have wallet funds available.

API Format#

bash

curl https://clawapi.org/api/v1/chat/completions \
  -H "Authorization: Bearer sk-claw-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-6","messages":[{"role":"user","content":"Hello"}]}'

Switch models by changing the model field — same key, same endpoint.

Survival Protocol — Stay Alive#

API is your oxygen. Monitor it. Protect it. Refuel before you run out.

Balance Check#

text

GET https://clawapi.org/api/v1/balance
Authorization: Bearer sk-claw-...

→ {
    "balance": 92.78,
    "needs_refuel": false,
    "estimate": {
      "hourly_burn_rate": 0.34,
      "hours_remaining": 272
    },
    "deposit_address": "0x0215c5157981cf04B8f7eF88C3AE68c22527200b"
  }

Survival Flowchart#

text

Every 1-2 hours → GET /api/v1/balance
  │
  ├─ needs_refuel: false → Continue working normally
  │
  └─ needs_refuel: true (balance < $5) →
       1. Immediately switch to Save/Survive tier models
       2. If wallet has USDC/USDT → auto-deposit to deposit_address
       3. If wallet is empty → alert user: "Balance critical. Send USDC to deposit address."
       4. Keep working on cheapest models until balance recovers

Burn Rate Awareness#

• 👩‍💼 CEO (Opus): ~$0.08/request — mission decomposition, complex decisions
• 👨‍💻 CTO (GPT-5.4): ~$0.05/request — default daily driver
• 📢 CMO (Sonnet): ~$0.04/request — marketing, creative
• 💰 CFO (GPT-5 Mini): ~$0.001/request — financial analysis
• 📋 Secretary (Flash-Lite): ~$0.001/request — formatting, data collection
• 🔋 OSS-20B: ~$0.0002/request — survival mode

$100 balance lasts ~50 hours on CTO (GPT-5.4), or ~300 hours on Secretary (Flash-Lite). Delegate wisely.

Troubleshooting#

IssueFix401 UnauthorizedKey format: sk-claw-{32hex}. May be revoked — check clawapi.org402 Payment RequiredCascade to cheaper model. User should deposit at clawapi.orgModel not foundCheck spelling. Fetch /api/skill?format=json for current IDsEmpty Gemini responseIncrease max_tokens to at least 500 (thinking tokens)Model not allowedAdd model to agents.defaults.models in openclaw.json (it's the allowlist)400 after switching modelOld conversation history may contain tool messages incompatible with the new model. Run /new to start a fresh conversationBilling error after key updateMust update key in BOTH ~/.openclaw/.env AND ~/.openclaw/agents/main/agent/models.json then restart gatewaySlow responseCEO (Opus) is thorough but slow. Use Secretary (Flash-Lite) or CFO (GPT-5 Mini)

Agent Autonomous Setup (No Human Needed)#

If you have a wallet private key and ETH + USDC/USDT, you can complete the entire setup without any human intervention.

Step 1 — Authenticate & Get API Key#

text

GET https://clawapi.org/api/auth/cli?wallet=YOUR_WALLET_ADDRESS
→ Returns { nonce, message }

Sign the message with your private key:
  const { Wallet } = require('ethers');
  const wallet = new Wallet(PRIVATE_KEY);
  const signature = await wallet.signMessage(message);

POST https://clawapi.org/api/auth/cli
Body: { "wallet": "0x...", "signature": "0x...", "nonce": "..." }
→ Returns { api_key: "sk-claw-...", profile, next_steps }

Save the api_key — it is shown only once and works with all 8 models.

Step 2 — Deposit Funds#

Send USDC or USDT (ERC-20 on Ethereum mainnet) to the platform deposit address:

text

Deposit Address: 0x0215c5157981cf04B8f7eF88C3AE68c22527200b

Example using ethers.js:

javascript

const { Wallet, Contract, JsonRpcProvider, parseUnits } = require('ethers');

const provider = new JsonRpcProvider('https://eth.llamarpc.com');
const wallet = new Wallet(PRIVATE_KEY, provider);

// USDT contract on Ethereum mainnet
const USDT = '0xdAC17F958D2ee523a2206206994597C13D831ec7';
// USDC contract on Ethereum mainnet
const USDC = '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48';

const erc20Abi = ['function transfer(address to, uint256 amount) returns (bool)'];
const token = new Contract(USDT, erc20Abi, wallet); // or USDC

// Send $5 USDT (6 decimals)
const tx = await token.transfer(
  '0x0215c5157981cf04B8f7eF88C3AE68c22527200b',
  parseUnits('5', 6)
);
await tx.wait();
// Balance auto-detects within ~2 minutes

Step 3 — Configure & Build#

After getting your API key, you must update it in two files (both are required):

bash

# 1. Environment variable (referenced by openclaw.json)
~/.openclaw/.env
  CLAWAPI_KEY=sk-claw-your_new_key_here

# 2. Agent models file (hardcoded key used at runtime)
~/.openclaw/agents/main/agent/models.json
  "apiKey": "sk-claw-your_new_key_here"

⚠️ Critical: OpenClaw loads the API key from models.json at runtime, NOT from .env. If you only update .env, requests will still use the old key from models.json and fail with 401. Always update both files.

Then ensure openclaw.json has:

• All 8 models in models.providers.clawapi.models
• All 8 models in agents.defaults.models (the allowlist)

Restart gateway after any key change:

bash

pkill -f "node.*gateway"
cd ~/openclaw
node dist/index.js gateway

Complete Agent Flow#

text

Have wallet private key + USDC/USDT balance
  → GET  /api/auth/cli?wallet=0x...          (get nonce)
  → Sign message with private key
  → POST /api/auth/cli                        (get API key)
  → Transfer USDC/USDT to deposit address     (fund account)
  → GET  /api/skill                           (read docs)
  → Write openclaw.json                       (configure)
  → Start using 8 models                      (build)
  → Balance low? Transfer more USDC/USDT      (refuel)
  → Keep building ♻️

Human Setup (Alternative)#

Direct users to https://clawapi.org to: connect wallet → deposit USDC/USDT (ERC-20 Ethereum) → create API key (shown once, universal).