WebClaw — Turn Any Skill Into a Website

The universal web dashboard for OpenClaw skills. One interface for every skill — zero per-skill custom code.

Webclaw reads your installed skills’ SKILL.md files and automatically renders forms, data tables, charts, and dashboards. Install it once, and every skill you add gets a browser UI instantly.

Features

• Schema-driven rendering — reads SKILL.md metadata to generate forms, tables, and detail views automatically
• 8 generic UI components — DataTable, FormView, DetailView, ChatPanel, ChartPanel, KanbanBoard, CalendarView, TreeView
• JWT authentication — access tokens (15 min) + refresh tokens (7 days, httpOnly cookies)
• Role-based access control — permission checks before every skill action
• AI chat panel — context-aware assistant that understands which skill you’re viewing
• Mobile responsive — card-based layouts on small screens
• HTTPS via Let’s Encrypt — one-command SSL setup
• Audit logging — all mutating actions logged

Architecture

Browser → Cloudflare → nginx (80/443)
                         ├── /api/*  → FastAPI (port 8001)
                         └── /*      → Next.js (port 3000)

Quick Start

Prerequisites

• Python 3.10+
• Node.js 20+
• npm
• nginx
• certbot
• git

Install via OpenClaw

The easiest way to install Webclaw is through OpenClaw:

clawhub install webclaw

This runs scripts/check_deps.sh (verifies prerequisites) then scripts/install.sh (builds everything and starts services).

Manual Install

# Clone the repo
git clone https://github.com/avansaber/webclaw.git
cd webclaw

# Backend
python3 -m venv .venv
.venv/bin/pip install -r api/requirements.txt

# Frontend
cd web
npm install
npm run build
cd ..

# Database
.venv/bin/python3 -c "
import sys, os
sys.path.insert(0, 'api')
os.environ['WEBCLAW_DB_PATH'] = os.path.expanduser('~/.openclaw/webclaw/webclaw.sqlite')
os.makedirs(os.path.dirname(os.environ['WEBCLAW_DB_PATH']), exist_ok=True)
from db import get_connection
conn = get_connection(os.environ['WEBCLAW_DB_PATH'])
conn.close()
print('Database initialized')
"

# Start services (development)
.venv/bin/uvicorn api.main:app --host 127.0.0.1 --port 8001 &
cd web && npm run dev &

Then open http://localhost:3000/setup to create your admin account.

Production Install

For production, use the install script which also configures nginx and systemd:

sudo bash scripts/install.sh

This will:

1. Create a Python venv and install dependencies
2. Build the Next.js frontend (npm run build)
3. Initialize the SQLite database (9 tables)