A mutation of NanoClaw with opinionated core changes and a built-in dashboard for operations and end-user workflows.
NanoClaw gives you an AI assistant that runs agents securely in containers. SuperClaw adds a full web UI on top so you can manage chats, agents, tasks, and system configuration from a browser instead of the command line.
| NanoClaw | SuperClaw | |
|---|---|---|
| Interface | CLI / chat only | Web dashboard + chat |
| Config | Edit .env by hand |
Form builder with validation |
| Agent management | Chat commands | Visual registration + editing |
| Task scheduling | Chat commands | Create/pause/cancel from UI |
| Chat history | SQLite queries | Searchable chat viewer |
| System monitoring | Log files | Live health dashboard + log tail |
SuperClaw is a not a fork it a mutation. The core NanoClaw engine (nanoclaw/) runs majorly unchanged currently. The dashboard reads its SQLite database directly and writes IPC files for actions.
superclaw/
nanoclaw/ # Core service (message intake, DB, scheduler, container runner)
dashboard/ # Next.js UI + API surface
indexes/ # Architecture summaries and codebase indexes
cd nanoclaw
npm install
npm run devIf this is a fresh install, run claude then /setup to authenticate WhatsApp, build the container image, and configure services.
cd dashboard
bun install # or npm installSet environment variables before starting:
macOS/Linux:
export DASHBOARD_ADMIN_TOKEN="your-secret-token"
# Optional: defaults to ../nanoclaw
export NANOCLAW_ROOT="/absolute/path/to/nanoclaw"
bun devWindows PowerShell:
$env:DASHBOARD_ADMIN_TOKEN="your-secret-token"
# Optional: defaults to ..\nanoclaw
$env:NANOCLAW_ROOT="C:\path\to\nanoclaw"
bun devNavigate to http://localhost:3000 and log in with your DASHBOARD_ADMIN_TOKEN.
| Page | Purpose |
|---|---|
/chat |
Browse conversations, search messages, send replies |
/agents |
Register/edit/delete group agents with trigger patterns |
/tasks |
Create scheduled tasks (cron/interval/once), pause/resume/cancel |
/system |
Health monitoring, .env config editor (form + raw), mount allowlist, logs |
/login |
Token authentication |
The dashboard does not run its own bot or connect to WhatsApp. It sits alongside NanoClaw and communicates through two mechanisms:
- Reads: Direct SQLite queries against NanoClaw's database (chats, messages, tasks, agents, sessions)
- Writes: Atomic JSON files dropped into NanoClaw's IPC directories (messages, task actions, agent registration)
This means the dashboard is stateless and can be started/stopped independently without affecting the running bot.
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| UI | React 19, Tailwind CSS 4, shadcn/ui, lucide-react |
| Forms | React Hook Form + zod |
| State | Zustand (client), SQLite (server reads) |
| Auth | Token-based with HTTP-only cookies |
| Database | better-sqlite3 (read-only against NanoClaw DB) |
NanoClaw uses a local Docker image: nanoclaw-agent:latest. Rebuild when container code changes:
cd nanoclaw
docker build -t nanoclaw-agent:latest -f container/Dockerfile containerSupported runtimes:
- macOS: Docker Desktop or Apple Container
- Linux: Docker
- Windows: Docker Desktop (Linux containers mode)
| Variable | Required | Description |
|---|---|---|
DASHBOARD_ADMIN_TOKEN |
Yes | Token for dashboard login |
NANOCLAW_ROOT |
No | Path to NanoClaw directory (defaults to ../nanoclaw) |
DASHBOARD_RESTART_COMMAND |
No | Shell command to restart NanoClaw from the dashboard |
NanoClaw's own .env (API keys, container settings, etc.) is managed through the dashboard's System page.
- Upstream: NanoClaw
v1.1.3 - Runtime model: containerized agent execution + SQLite state
- UI model: unified dashboard for chat, agents, tasks, and system controls
Work in progress. Interfaces and behavior can change.
MIT