ERPClaw Web — Browser Dashboard for ERPClaw

A modern web dashboard for ERPClaw, the AI-native ERP built on OpenClaw. Provides a full browser-based interface for managing all ERP entities — customers, sales orders, invoices, inventory, payments, HR, and more.

Features

• Universal data tables — auto-generated from ERPClaw’s SKILL.md definitions, no per-module configuration
• Live data — real-time entity lists with pagination, filtering, and status indicators
• Detail panels — SAP Fiori-style side panels for viewing and acting on records
• Action execution — submit, cancel, and create derived documents directly from the UI
• AI chat — natural language queries against your ERP data (e.g., “show me overdue invoices”)
• Multi-vertical — supports all 44 ERPClaw modules including Healthcare, Education, Retail, Construction, and more
• Dark/light themes — automatic theme switching with accent color customization
• WebSocket updates — live data refresh when records change
• JWT authentication — secure login with token refresh and role-based access

Architecture

Browser (SvelteKit)     FastAPI Backend        ERPClaw Skills
┌──────────────────┐   ┌─────────────────┐   ┌──────────────────┐
│ SvelteKit 5      │──▶│ /api/action/*   │──▶│ db_query.py      │
│ Tailwind CSS 4   │   │ /api/layout/*   │   │ --action {name}  │
│ TypeScript        │   │ /api/chat       │   │                  │
│ adapter-static   │   │ /ws             │   │ SQLite DB        │
└──────────────────┘   └─────────────────┘   └──────────────────┘
     Static files          Python 3.10+         ~/.openclaw/erpclaw/
     served by nginx       uvicorn               data.sqlite

Frontend: SvelteKit 5 with Svelte 5 runes, compiled to static files via adapter-static, served by nginx.

Backend: FastAPI application that proxies action calls to ERPClaw skill scripts, handles authentication, and provides real-time WebSocket updates.

Data: All data lives in ERPClaw’s single SQLite database. The web dashboard reads and writes through ERPClaw’s action system — it never touches the database directly.

Prerequisites

• ERPClaw installed via OpenClaw (clawhub install erpclaw)
• Node.js 18+ (for building the frontend)
• Python 3.10+ (for the API backend)

Quick Start

1. Clone and install

git clone https://github.com/avansaber/erpclaw-web.git
cd erpclaw-web
npm install
pip install -r api/requirements.txt

2. Run in development

# Terminal 1: Frontend (hot reload)
npm run dev

# Terminal 2: API backend
uvicorn api.main:app --host 0.0.0.0 --port 8100 --reload

The frontend runs on http://localhost:5173 and proxies API calls to the backend on port 8100.

3. First login

On first visit, you’ll be prompted to create an admin account. This sets up JWT authentication for all subsequent access.