clawbox

<p align="center">
  <img src="public/clawbox-logo.png" alt="ClawBox" width="180" />
</p>

<h3 align="center">OpenClaw OS</h3>

<p align="center">
  <strong>Your private AI assistant that runs 24/7 on your desk.</strong><br/>
  Plug in. Scan QR. Done. No cloud required.
</p>

<p align="center">
  <a href="https://clawbox.tech"><img alt="Website" src="https://img.shields.io/badge/🌐_Website-clawbox.tech-orange?style=flat-square" /></a>
  <a href="https://discord.gg/FbKmnxYnpq"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join_Community-5865F2?style=flat-square&logo=discord&logoColor=white" /></a>
  <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Source_Available-blue?style=flat-square" /></a>
  <img alt="Platform" src="https://img.shields.io/badge/platform-NVIDIA_Jetson-76b900?style=flat-square&logo=nvidia" />
</p>

<p align="center">
  <img alt="Next.js" src="https://img.shields.io/badge/Next.js_16-black?style=flat-square&logo=next.js" />
  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-3178c6?style=flat-square&logo=typescript&logoColor=white" />
  <img alt="Bun" src="https://img.shields.io/badge/Bun-fbf0df?style=flat-square&logo=bun&logoColor=black" />
</p>

---

## What is ClawBox?

ClawBox is **OpenClaw OS** — the operating system for [OpenClaw Hardware](https://clawbox.tech/), a private AI assistant running on NVIDIA Jetson (Tegra/ARM). Unlike cloud AI, your data never leaves your device. It manages the full device lifecycle: broadcasts a WiFi access point for first-boot setup from any phone/laptop, transitions to the home network, then serves a Chrome OS-style desktop environment with built-in apps.

The OpenClaw AI agent controls the entire device through MCP (Model Context Protocol) tools — making ClawBox an OS the AI can operate, not just a UI the user clicks through.

### Key Features

| Feature | Description |
|---------|-------------|
| 🧙 **5-minute setup** | Guided wizard: WiFi → updates → AI provider → messaging → done |
| 🖥️ **Desktop environment** | Chrome OS-style desktop with windowed apps, taskbar, and system tray |
| 🤖 **AI-controlled OS** | 40+ MCP tools let the AI agent operate the entire device |
| 🔒 **Privacy-first** | Everything runs locally. No telemetry. No data collection. |
| 🧠 **Hybrid AI** | Local models (Llama, Gemma, Mistral) + cloud (Claude, GPT, Gemini) |
| 🌐 **Browser automation** | AI controls a real browser — fills forms, scrapes data, posts content |
| 💬 **Multi-platform** | Telegram, web panel, desktop chat |
| 💻 **Built-in apps** | Terminal, file manager, VS Code, VNC, app store, AI chat |
| 🛠️ **Code assistant** | AI builds and deploys desktop webapps through iterative coding |
| ⚡ **Always-on** | 7-15W power. Runs 24/7 for ~€39/year in electricity |

### 🖥️ Hardware

| Component | Spec |
|-----------|------|
| **Processor** | NVIDIA Jetson Orin Nano 8GB (Super) |
| **AI Performance** | 67 TOPS |
| **Storage** | 512GB NVMe SSD |
| **Power** | 7-15W typical, USB-C |
| **Size** | 100 × 79 × 31mm |
| **Case** | Carbon fiber |

---

## 🚀 Quick Start

### Requirements

| | Supported |
|---|---|
| **Device** | NVIDIA Jetson Orin Nano 8GB (Super) |
| **OS image** | **JetPack 6.2** (Ubuntu 22.04 / L4T R36.x) — [download](https://developer.nvidia.com/embedded/jetpack-sdk-62) |

> ⚠️ **JetPack 7.x (Ubuntu 24.04) is not supported yet.** NVIDIA's newest images
> default to JetPack 7 — flash **JetPack 6.2** instead. On 24.04 the installer
> fails on Python's externally-managed-environment policy (PEP 668), among
> other differences. JetPack 6.2 is the platform every shipped ClawBox runs.

### Install

The installer expects to run from `/home/clawbox/clawbox` as the `clawbox`
user's checkout (the same layout shipped devices use):

```bash
id -u clawbox >/dev/null 2>&1 || sudo useradd -m -s /bin/bash clawbox
sudo git clone https://github.com/ID-Robots/clawbox.git /home/clawbox/clawbox
sudo chown -R clawbox:clawbox /home/clawbox/clawbox
cd /home/clawbox/clawbox
sudo bash install.sh
```

The install provisions everything from scratch (20–40 min on a fresh image).
When it finishes, connect to the **ClawBox-Setup** WiFi network (open, no
password) and navigate to:
- `http://clawbox.local/`
- `http://10.42.0.1/`

## How It Works

### Layer 1 — System Bootstrap

The installer (`install.sh`) provisions the Jetson from scratch:
- Installs system packages, Node.js 22, Bun runtime
- Sets hostname to `clawbox`, enables mDNS discovery
- Builds the web OS, installs the OpenClaw gateway
- Configures systemd services and captive-portal DNS
- Creates the WiFi access point for first-boot setup

Two systemd services run the OS:

| Service | Role |
|---|---|
| `clawbox-ap` | WiFi access point (SSID: ClawBox-Setup, IP: 10.42.0.1) |
| `clawbox-setup` | Web server on port 80 (Next.js + WebSocket proxy) |

### Layer 2 — Setup Wizard

On first boot (or after factory reset), the OS presents a 7-step wizard:

1. 🌐 **Welcome** — L

... (truncated)