Engine

中文版 · 日本語版

✨ Why ClawAPI

One command to manage all your AI keys. One engine that routes every request to the best provider.

The Problem

You have API keys scattered across OpenAI, Anthropic, Google, DeepSeek, Groq...

• Keys stored in .env files across 20 projects
• No idea which key is burning money
• Can't easily switch providers when one goes down
• AI coding tools (Claude Code, Cursor) each need separate key config

The Solution

         ┌─────────────────────────────────────────────┐
         │              ClawAPI Engine                  │
         │           (runs on YOUR machine)             │
         │                                              │
  You ──►│  🔑 Encrypted key vault (AES-256-GCM)       │
         │  🧠 Smart routing across providers           │
         │  📊 Cost tracking & health monitoring        │
         │  🔌 OpenAI-compatible API on localhost       │
         │                                              │
         │   Keys     Keys     Keys     Keys     Keys  │
         │    │        │        │        │        │     │
         └────┼────────┼────────┼────────┼────────┼─────┘
              ▼        ▼        ▼        ▼        ▼
           OpenAI  Anthropic  Gemini  DeepSeek  Groq
                                              + 10 more

Your keys never leave your machine. Period.

⚡ Quick Start

Install via npm (requires Bun)

# Install
bun add -g @clawapi/engine

# Setup (interactive — adds your first API key)
clawapi setup

# Start the engine
clawapi start

Or download a binary (no dependencies)

# macOS (Apple Silicon)
curl -fsSL https://github.com/sstklen/clawapi/releases/latest/download/clawapi-darwin-arm64 -o clawapi
chmod +x clawapi && ./clawapi setup

→ All releases

🔌 Use with AI Coding Tools

Claude Code (MCP) — Recommended

Prerequisites: Bun or Node.js 20+ · Claude Code installed

Step 1: Add ClawAPI to Claude Code

claude mcp add clawapi --scope user -- bunx @clawapi/engine mcp

Step 2: Restart Claude Code (close and reopen your terminal)

Step 3: Verify it works

clawapi mcp --test

You should see: ✅ MCP Server OK with tool count and engine status.

Where is the config stored? Claude Code saves MCP config at ~/.claude.json. You can check it with cat ~/.claude.json.

Quick setup (optional): Generate default config without interactive prompts:

clawapi setup --defaults

You now have 14 AI tools available. Ask Claude: "What tools do you have from ClawAPI?"

Any OpenAI SDK Client

from openai import OpenAI

# Point any OpenAI client at ClawAPI — it just works
client = OpenAI(
    base_url="http://localhost:4141/v1",
    api_key="your-clawapi-key"
)

# ClawAPI picks the best available provider automatically
response = client.chat.completions.create(
    model="auto",  # Let ClawAPI choose, or specify "gpt-4" / "claude-3" / "gemini-2"
    messages=[{"role": "user", "content": "Hello!"}]
)

Works with: Python, Node.js, Go, Rust — anything that speaks OpenAI API.

🧠 Smart Routing (L1 → L4)

ClawAPI doesn't just proxy — it thinks.

"Translate this doc to Japanese and summarize it"

  L4 Task Engine
   ├─ Step 1: L1 → DeepL (translate)
   ├─ Step 2: L2 → Best LLM (summarize)
   └─ Step 3: Merge results → Return

🔑 Iron Rules

These are not features — they are guarantees.

📦 Supported Providers

Add your own provider in 30 lines of YAML. No code needed.

🛠 Full CLI

Engine      start · stop · status
Keys        keys add · list · remove · pin · rotate · import · check
Claw Key    claw-key set · show · remove
Sub-Keys    sub-keys issue · list · revoke · usage
Mutual Aid  aid config · stats · donate
Adapters    adapters list · install · remove · update
Telemetry   telemetry show · toggle
Backup      backup export · import
System      logs · config · setup · doctor · version · mcp

30+ commands. 3 languages (English, 繁體中文, 日本語).

🏗 Architecture

┌─────────────────────────────┐          ┌────────────────────────┐
│      ClawAPI Engine         │          │     ClawAPI VPS        │
│      (Your Machine)         │  ECDH    │     (Optional Cloud)   │
│                             │◄────────►│                        │
│  🔐 Key Vault (AES-256)    │ Metadata │  📋 Device Registry    │
│  🧠 Smart Router (L1-L4)   │   Only   │  📊 Telemetry Agg.    │
│  🌐 OpenAI-Compat API      │          │  🤝 Mutual Aid Match  │
│  🔧 MCP Server (14 tools)  │          │  🔍 Anomaly Detection │
│  💻 CLI (30+ commands)      │          │                        │
│  🖥  Web UI (SSR + HTMX)   │          │                        │
└─────────────────────────────┘          └────────────────────────┘
      Keys stay here ☝️                    Never sees your keys

🔒 Security

• AES-256-GCM encryption at rest
• ECDH P-256 key exchange with VPS
• 1,681 tests, 0 failures
• Triple code review (self + Codex + Opus cross-review)
• 5-party security audit methodology
• Non-root Docker execution
• Rate limiting on all endpoints

Tech Stack

🩺 Included: Dr. Claw — AI Debug Knowledge Base

This repo includes Dr. Claw — an AI debugging knowledge base that remembers every bug ever solved. Ask once, never repeat.

• 6,800+ issues indexed, 980+ verified fixes
• MCP Server + REST API
• Spun off from Confucius Debug, now lives in clawapi/drclaw/

📝 License

AGPL-3.0 — Free to use, modify, and distribute. Contributions welcome.

See LICENSE for details.

Pair With

• Opus Relay (sstklen/opus-relay) — Bridge your local Claude CLI to any VPS. ClawAPI manages the keys, Opus Relay bridges the compute.