Skip to content

ClawBox plug-and-play AI appliance powered by CheapRouter + Clawland-Fleet. OpenAI-compatible gateway with 38+ models, smart routing, auto-failover, fleet management, and OTA.

License

Notifications You must be signed in to change notification settings

Clawland-AI/OpenclawBox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Coming to Kickstarter

ClawBox

Plug-and-play AI appliance powered by CheapRouter + Clawland-Fleet

CI Docs License Stars


ClawBox Hardware is coming to Kickstarter in June 2026! A purpose-built AI appliance with an RK3588 SoC, 7.9" bar touchscreen, and the full OpenclawBox stack pre-installed. Get notified for early bird pricing β†’


ClawBox turns any machine into a personal AI appliance. One install command gives you an OpenAI-compatible API that intelligently routes across 38+ models, auto-recovers from provider failures, and costs up to 90% less than using a single premium model.

Three Core Values

Value What it means
Cheaper Up to 90% cost reduction* Smart routing sends simple queries to free/cheap models; only complex tasks hit premium
Reliable Auto-failover Provider down? Rate limited? ClawBox switches automatically β€” zero downtime
Governed Fleet-managed Device monitoring, OTA updates, rate limiting, and audit trails built in

*In certain workloads with specific routing policies and model mixes. See Benchmarks for methodology and reproduction steps.


60-Second Quickstart

Step 1 β€” Install (one command):

curl -fsSL https://raw.githubusercontent.com/Clawland-AI/OpenclawBox/main/scripts/install.sh | bash

Step 2 β€” Test the API:

curl http://localhost:4000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model": "blockrun/auto", "messages": [{"role": "user", "content": "Hello ClawBox!"}]}'

Step 3 β€” Check your devices:

curl http://localhost:4100/api/devices

No API keys required β€” demo mode runs out of the box with a built-in mock provider.

Docker alternative: cd deploy && cp env.example .env && docker compose up -d


Architecture

graph TB
    subgraph device [ClawBox Device]
        CR[CheapRouter]
        Engine["ClawRouter Engine<br/>(14-dim scoring, 38+ models)"]
        Agent[Fleet Agent]
    end

    subgraph mgmt [Management]
        FS[Fleet Server]
        FC[Fleet Console]
    end

    subgraph providers [AI Providers]
        P1[OpenAI]
        P2[Anthropic]
        P3[Google]
        P4[DeepSeek]
        P5[xAI]
    end

    Client[Any App] -->|"OpenAI-compatible"| CR
    CR --> Engine
    Engine --> P1
    Engine --> P2
    Engine --> P3
    CR -->|"Metrics"| FS
    Agent -->|"Heartbeat + OTA"| FS
    FC -->|"Dashboard"| FS
Loading

Key Features

Unified API β€” Any model, one endpoint

CheapRouter exposes a standard OpenAI-compatible /v1/chat/completions endpoint. Any tool that works with OpenAI works with ClawBox β€” zero code changes.

from openai import OpenAI
client = OpenAI(base_url="http://localhost:4000/v1", api_key="demo")
response = client.chat.completions.create(
    model="blockrun/auto",
    messages=[{"role": "user", "content": "Hello!"}],
)

Docs: Unified API

Auto Failover β€” Never crash on provider issues

Provider returns 429? 500? Timeout? ClawRouter's fallback chain tries the next model automatically. Your application sees a successful response.

Docs: Auto Failover

Cost Reduction β€” Up to 90% savings

ClawRouter's 14-dimension scorer classifies each request (simple/medium/complex/reasoning) and routes to the cheapest capable model. Simple queries go to free models; only complex reasoning uses premium.

Profile Blended Cost Savings vs Claude Opus
Eco ~$0.10/M tokens 98%
Auto ~$2.05/M tokens 92%
Premium ~$25/M tokens 0%

Based on ClawRouter's published pricing. Run python benchmarks/run_bench.py to reproduce.

Docs: Benchmarks

Fleet Management β€” Monitor, configure, update

Clawland-Fleet gives you a web console to manage all your ClawBox devices:

  • Device list with online/offline status
  • Remote configuration push
  • Over-the-air (OTA) updates
  • Usage metrics and cost breakdown

Docs: Fleet Management


Project Structure

packages/
  cheaprouter/       β†’ CheapRouter (ClawRouter wrapper + fleet integration)
  fleet-server/      β†’ Device management server
  fleet-agent/       β†’ Device-side agent
  fleet-console/     β†’ Web dashboard (React + Vite)
  touchscreen-ui/    β†’ Bar display UI for ClawBox hardware (1280x400)
benchmarks/          β†’ Reproducible cost/latency benchmarks
website/             β†’ Documentation site (Docusaurus)
kickstarter/         β†’ Kickstarter campaign materials & press kit
scripts/             β†’ install.sh, clawboxctl
deploy/              β†’ Docker Compose, env templates

Powered by ClawRouter

CheapRouter's routing engine is ClawRouter by BlockRunAI (MIT license, 3.3k+ stars). ClawRouter provides:

  • 14-dimension weighted scoring for intelligent model selection
  • 38+ models across 7 providers
  • Routing profiles: eco / auto / premium / free
  • Fallback chains with automatic retry
  • Request deduplication and SSE heartbeat

CheapRouter adds fleet integration, device-level rate limiting, audit logging, and demo mode on top.


Non-Affiliation Disclaimer

Clawland Inc and ClawBox are independent open-source projects. ClawBox is not affiliated with, endorsed by, or connected to any third-party hardware or software brand. This repository provides open-source reference implementations and developer tools. The "AI appliance" concept is an open hardware form factor β€” not a reference to any specific commercial product.


Community


Roadmap Highlights

  • v0.2.0: Authentication, real OTA, Prometheus metrics, device grouping
  • v0.3.0: Semantic caching, multi-user, plugin system, ARM64 images
  • v1.0.0: Touchscreen UI, QR pairing, mobile app, enterprise features

See the full roadmap.


License

Apache License 2.0 β€” Copyright 2026 Clawland Inc

About

ClawBox plug-and-play AI appliance powered by CheapRouter + Clawland-Fleet. OpenAI-compatible gateway with 38+ models, smart routing, auto-failover, fleet management, and OTA.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •