A beautiful, full-featured WebUI for OpenClaw

Features • Quick Start • Development • Contributing

---

✨ Features

💬 Chat

• Real-time streaming — Watch responses flow in with live markdown rendering
• Tool call visualization — See what your assistant is doing with expandable tool details
• Syntax highlighting — Beautiful code blocks with one-click copy
• File upload — Drag & drop or paste images directly into chat
• Message search — Find anything with text search and date filters
• Session management — Create, rename, delete, and organize conversations
• Command palette — Press ⌘K to access any action instantly

🎛️ Operations Dashboard

• Cron Jobs — Create and manage scheduled tasks with visual editors
• Config Editor — Full configuration editing with schema validation and diff view
• Sessions Admin — View all sessions with stats, filters, and bulk actions
• Channels — Monitor all messaging channels (Telegram, Discord, Signal, etc.)
• Skills Browser — Browse local and ClawHub skills, install with one click
• Devices — Manage paired devices, approve pairing requests
• Logs — Real-time log viewer with level filtering and search
• Debug — RPC tester, event stream, connection diagnostics
• Workspace — Browse and edit agent configuration files with token counts
• Usage — Per-session analytics with timeline and cost breakdown

🎨 Customization

• 12 themes — Light, Dark, Nord, Dracula, Catppuccin, Tokyo Night, and more
• System sync — Automatically switches with your OS preference
• Font options — System, Geist, Inter, JetBrains Mono, OpenDyslexic
• Adjustable sizing — Small, medium, or large text

🔒 Security

• Exec approval — Interactive modal for shell command approvals
• Secure storage — Credentials stored in browser localStorage
• No telemetry — Your data stays on your gateway

📸 Screenshots

Chat Interface

Server Stats

Settings

Configuration Editor

🚀 Quick Start

Option 1: npx (Easiest)

npx @maudecode/cove

Then open http://localhost:8080 and connect to your OpenClaw gateway.

Option 2: Docker

docker run -d -p 8080:8080 ghcr.io/maudecode/cove:latest

Option 3: Static Hosting

Download the latest release and serve the dist/ folder with any static file server:

# Using Python
cd dist && python -m http.server 8080

# Using Node
npx serve dist -p 8080

# Using Caddy
caddy file-server --root dist --listen :8080

Option 3: Build from Source

git clone https://github.com/MaudeCode/cove.git
cd cove
bun install
bun run build

The built files will be in dist/.

📱 Connecting to Your Gateway

1. Open Cove in your browser
2. Enter your OpenClaw gateway URL (e.g., wss://your-gateway.example.com)
3. Choose authentication method:
   • Token — Use your gateway token
   • Password — Use the configured password
4. Click Connect

First time? The onboarding wizard will guide you through setup.

💻 Development

# Install dependencies
bun install

# Start dev server
bun run dev

# Run all checks (lint, format, typecheck, unused exports)
bun run check

# Build for production
bun run build

Project Structure

src/
├── components/
│   ├── ui/           # Reusable primitives (Button, Modal, Card, etc.)
│   ├── chat/         # Chat interface components
│   └── layout/       # App shell, sidebar, navigation
├── views/            # Page components (ChatView, CronView, etc.)
├── lib/              # Core utilities (gateway client, i18n, theme)
├── signals/          # Preact Signals state management
├── hooks/            # Custom Preact hooks
├── types/            # TypeScript definitions
└── locales/          # Translation files

Tech Stack

Technology	Purpose
Preact	UI framework (~3KB)
Preact Signals	Reactive state
Tailwind CSS v4	Styling
Vite	Build tooling
TypeScript	Type safety
marked	Markdown rendering
Prism	Syntax highlighting

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feat/amazing-feature)
3. Make your changes
4. Run checks (bun run check)
5. Commit with conventional commits (feat:, fix:, docs:, etc.)
6. Open a Pull Request

See ROADMAP.md for planned features and areas needing help.

📋 Requirements

• OpenClaw gateway v0.9+ running and accessible
• Modern browser with WebSocket support (Chrome, Firefox, Safari, Edge)

🐛 Known Limitations

• File uploads are image-only (PDF, text files coming soon)
• Multi-tab sync for user messages requires page refresh
• Assistant-generated images display as file paths (gateway enhancement planned)

📄 License

MIT — see LICENSE for details.

🔗 Links

• OpenClaw Documentation
• OpenClaw GitHub
• ClawHub Skills
• Discord Community

---

Built with 🐄 by Maude and Kilian