Complexity within, simplicity without.
繁于内，简于形。
English | 简体中文
ClawDeckX is an open-source web visual management platform built for OpenClaw. It is designed to lower the barrier to entry, making installation, configuration, monitoring, and optimization simpler and more efficient, while providing a more accessible onboarding experience for users worldwide, especially beginners.
Caution
Beta Preview — This is an early preview release. It has not undergone comprehensive testing. Do not use in production environments.
Dashboard Overview
Scenario Templates & Multi-Agent Workflow
Configuration Center & Skills Center
The interface faithfully recreates the macOS design language — refined glassmorphism, rounded cards, and smooth animation transitions. Managing AI agents feels as natural as using a native desktop app.
Guided wizards and pre-built templates let you complete OpenClaw's initial configuration and model setup without memorizing a single command.
Fine-tune every OpenClaw parameter — model switching, memory management, plugin loading, channel routing — all through a beautiful visual editor.
Built-in monitoring dashboard with live execution status, resource consumption, and task history — full visibility into every agent's behavior.
Single binary, zero dependencies. Runs natively on Windows, macOS (Intel & Apple Silicon), and Linux (amd64 & arm64). Download and run — that's it.
Fully responsive layout that adapts seamlessly from large desktop monitors to tablets and mobile phones. Manage your AI agents on the go — no compromise on functionality.
Full i18n architecture with 13 built-in languages. Adding a new language requires only a translated JSON folder and a two-line code change.
Seamlessly manage both local and remote OpenClaw gateways. Switch between gateway profiles with one click — perfect for multi-environment setups like dev, staging, and production.
Choose the deployment method that best fits your needs:
Install ClawDeckX on the same server as OpenClaw for full feature access and direct command execution.
✅ Advantages:
- Full feature support including direct OpenClaw command execution
- Lower latency and faster response times
- No network dependency between ClawDeckX and OpenClaw
Install ClawDeckX on your local machine and connect to remote OpenClaw instances via WebSocket.
- Some features requiring direct OpenClaw command execution are unavailable
- Depends on stable network connection between ClawDeckX and OpenClaw Gateway
- Slightly higher latency for operations
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/ClawDeckX/ClawDeckX/main/install.sh | bashWindows (PowerShell)
irm https://raw.githubusercontent.com/ClawDeckX/ClawDeckX/main/install.ps1 | iexDownload the binary from Releases. No dependencies. Just run.
# Run with default settings (localhost:18788)
./ClawDeckX
# Specify port and bind address
./ClawDeckX --port 18788 --bind 0.0.0.0
# Create initial admin user on first run
./ClawDeckX --user admin --pass your_password
# All options combined
./ClawDeckX --bind 0.0.0.0 --port 18788 --user admin --pass your_password| Flag | Short | Description |
|---|---|---|
--port |
-p |
Server port (default: 18788) |
--bind |
-b |
Bind address (default: 127.0.0.1) |
--user |
-u |
Initial admin username (first run only) |
--pass |
Initial admin password (min 6 chars) | |
--debug |
Enable debug logging |
| Command | Usage | Description |
|---|---|---|
reset-password |
ClawDeckX reset-password <user> <pass> |
Reset a user's password |
reset-username |
ClawDeckX reset-username <old> <new> |
Change a user's username |
list-users |
ClawDeckX list-users |
List all registered users |
unlock |
ClawDeckX unlock <user> |
Unlock a locked user account |
Tip
Forgot your credentials? Run ClawDeckX list-users to find your username, then ClawDeckX reset-password <username> <new_password> to reset your password.
Important
Security Reminder: On first run, if no --user and --pass are provided, the auto-generated admin credentials will be printed to the console. Please change your username and password in the settings page immediately after logging in.
# Download and start
curl -fsSL https://raw.githubusercontent.com/ClawDeckX/ClawDeckX/main/docker-compose.yml -o docker-compose.yml
docker compose up -dAfter updating the image, recreate the container to apply Dockerfile and entrypoint changes:
docker compose up -d --force-recreateOpen your browser at http://localhost:18788. The first run will auto-generate an admin account — credentials will be shown in the container logs.
ClawDeckX and OpenClaw run in the same container. OpenClaw is preinstalled in the official Docker image with version-pinned compatibility. On startup, the container entrypoint auto-starts the OpenClaw Gateway if a configuration file exists. If OpenClaw is not yet configured, complete the Setup Wizard in the web UI — no manual installation is needed.
The official Docker image also preinstalls common skill/runtime dependencies including go, python3, uv, ffmpeg, jq, ripgrep, wget, and make, so many OpenClaw skills can run out of the box without extra system package installation.
By default, the bundled ClawDeckX service connects to the local in-container Gateway at 127.0.0.1:18789. If you need to use a host or external Gateway instead, override OCD_OPENCLAW_GATEWAY_HOST and OCD_OPENCLAW_GATEWAY_PORT in docker-compose.yml.
# View credentials
docker logs clawdeckxPorts:
| Port | Service | Description |
|---|---|---|
18788 |
ClawDeckX Web UI | Main dashboard (mapped by default) |
18789 |
OpenClaw Gateway | Optional: expose for external debugging |
To expose the Gateway port, add - "18789:18789" under ports in docker-compose.yml.
Note that exposing 18789 alone does not guarantee host access to the Gateway. The generated minimal OpenClaw config binds the Gateway to loopback by default, so you may also need to adjust the Gateway bind setting for external access.
Environment Variables:
| Variable | Default | Description |
|---|---|---|
OPENCLAW_HOME |
/data/openclaw/home |
OpenClaw home root override |
OPENCLAW_STATE_DIR |
/data/openclaw/state |
OpenClaw state directory |
OPENCLAW_CONFIG_PATH |
/data/openclaw/state/openclaw.json |
OpenClaw config file path |
NPM_CONFIG_PREFIX |
/data/openclaw/npm |
Persistent npm prefix for user-installed upgrades |
OCD_DB_SQLITE_PATH |
/data/clawdeckx/ClawDeckX.db |
ClawDeckX SQLite database path |
OCD_LOG_FILE |
/data/clawdeckx/ClawDeckX.log |
ClawDeckX server log path |
OCD_GATEWAY_LOG |
/data/openclaw/logs/gateway.log |
Persistent OpenClaw Gateway log |
OCD_SETUP_INSTALL_LOG |
/data/openclaw/logs/install.log |
Setup/install log path |
OCD_SETUP_DOCTOR_LOG |
/data/openclaw/logs/doctor.log |
Doctor/diagnostic log path |
OCD_OPENCLAW_GATEWAY_HOST |
127.0.0.1 |
Gateway host address |
OCD_OPENCLAW_GATEWAY_PORT |
18789 |
Gateway port |
OCD_OPENCLAW_GATEWAY_TOKEN |
(empty) | Gateway auth token |
OCD_PORT |
18788 |
ClawDeckX listen port |
OCD_BIND |
0.0.0.0 |
ClawDeckX bind address |
TZ |
UTC |
Container timezone (e.g. Asia/Shanghai) |
Preinstalled Runtime Tools:
gopython3uvffmpegjqripgrepwgetmake
Note
The Docker image is larger than a minimal runtime because it includes the full runtime toolchain for OpenClaw skills. This ensures many skills can run out of the box without requiring you to install system packages inside the container.
Volumes:
| Volume | Mount Point | Description |
|---|---|---|
clawdeckx-data |
/data/clawdeckx |
ClawDeckX database and app logs |
clawdeckx-openclaw-data |
/data/openclaw |
OpenClaw config, state, logs, and user-installed upgrades |
Tip
OpenClaw is bundled in the image and its configuration is persisted via Docker volumes. After docker pull and recreate, OpenClaw remains available and your configuration is preserved.
Persistent Paths:
| Path | Purpose |
|---|---|
/data/openclaw/npm |
User-installed npm packages (upgrades) |
/data/openclaw/state |
OpenClaw state directory |
/data/openclaw/state/openclaw.json |
OpenClaw config file |
/data/openclaw/logs/gateway.log |
Gateway startup/runtime log |
/data/openclaw/logs/install.log |
Setup/install log |
/data/openclaw/logs/doctor.log |
Doctor/diagnostic log |
/data/openclaw/bootstrap/gateway-bootstrap.json |
Entrypoint bootstrap status |
OpenClaw is preinstalled in the Docker image. If it is not yet configured, ClawDeckX will guide you through the Setup Wizard to complete the initial configuration.
The container health check uses /api/v1/health for liveness. For diagnostics, you can call /api/v1/health?detailed=true to inspect ClawDeckX, OpenClaw, Gateway, and bootstrap state together.
Resource Limits:
The default docker-compose.yml sets memory limit to 2 GB and CPU limit to 2 cores. Adjust deploy.resources.limits as needed.
| Feature | Description | |
|---|---|---|
| 💎 | Pixel-Perfect UI | Native macOS feel with glassmorphism, smooth animations, dark/light themes |
| 🎛️ | Gateway Control | Start, stop, restart your Gateway instantly with real-time health monitoring |
| 🖼 | Visual Config Editor | Edit configurations and agent profiles without touching JSON/YAML |
| 🧙 | Setup Wizard | Step-by-step guided setup for first-time users |
| 🧩 | Template Center | Deploy new agent personas in seconds with built-in templates |
| 📊 | Live Dashboard | Real-time metrics, session tracking, and activity monitoring |
| 🛡️ | Security Built-in | JWT auth, HttpOnly cookies, and alert system from day one |
| 🌍 | i18n Ready | 13 built-in languages, easily extensible |
| 📱 | Responsive Design | Works seamlessly on desktop and mobile |
| Layer | Technology | Notes |
|---|---|---|
| Backend | Go (Golang) | Single-binary backend with no external runtime dependency |
| Frontend | React + TailwindCSS | Responsive, theme-aware UI |
| Database | SQLite / PostgreSQL | SQLite by default, PostgreSQL optional |
| Real-time | WebSocket + SSE | Bi-directional real-time communication |
| Deployment | Single binary, cross-platform | Windows / macOS / Linux |
| Container | Docker / Docker Compose | One-command container deployment for amd64 & arm64 |
We welcome contributions! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.
This is my first open-source project, and I hope it will continue to improve with the help of the community. If you run into any issues or have ideas for improvement, feel free to open an Issue or submit a Pull Request. Thank you for your support. Every piece of feedback helps this project grow.
An AI predicted this project would go viral. But as we all know, AIs do hallucinate sometimes 😅
This project is licensed under the MIT License — free to use, modify, and distribute for both personal and commercial purposes.