Skip to content

README.md

Latest commit

 

History

History
306 lines (211 loc) · 10.1 KB

README.md

File metadata and controls

306 lines (211 loc) · 10.1 KB
ClawSuite

ClawSuite

The full-stack mission control platform for OpenClaw AI agents.

Version License Node PRs Welcome

Not a chat wrapper. A complete command center — orchestrate agents, run missions, track costs, and control everything from one place.

ClawSuite Dashboard

✨ What's New in v4.0

  • 🤖 Mission Control — Full multi-agent orchestration with an isometric office view, live agent status, and mission lifecycle management (spawn → pause → resume → abort)
  • 📊 Cost Analytics — Per-agent spend, daily trends, MTD totals, and projected EOM cost backed by real gateway data
  • 🎨 3-Theme System — Paper Light, Ops Dark, Premium Dark — deep dark mode wiring across 66+ components
  • 🔒 Security Hardened — Auth middleware on all API routes, wildcard CORS removed, exec approval prompts
  • 📱 Mobile-First PWA — Full feature parity on any device, installable as a native app on iOS and Android
  • ⚡ Live SSE Streaming — Real-time agent output streams to Mission Control and chat — no polling
  • 🧠 Memory Browser — Browse, search, and edit agent memory files directly from the UI

📸 Screenshots

Agent Hub — Mission Control Chat — Live Streaming
Agent Hub Chat
Mobile Dashboard Mission Control
Mobile Missions
📸 More Screenshots
Mission Wizard Tasks Board
Mission Wizard Tasks
Skills Marketplace Cron Manager
Skills Cron
Agents Configuration Mobile Agent Hub
Agents Mobile Hub

🚀 Quick Start

Prerequisites

Install & Run

git clone https://github.com/outsourc-e/clawsuite.git
cd clawsuite
npm install
cp .env.example .env

Edit .env with your gateway connection details:

# Required — your OCPlatform gateway WebSocket URL
CLAWDBOT_GATEWAY_URL=ws://127.0.0.1:18789

# Required — your gateway auth token
# Find it in ~/.ocplatform/ocplatform.json under gateway.auth.token
# Or run: ocplatform config get gateway.auth.token
CLAWDBOT_GATEWAY_TOKEN=your_token_here

Then start:

npm run dev                # Starts on http://localhost:3000

First launch: If the gateway isn't configured yet, ControlSuite will show a setup wizard to help you connect.

Verify It Works

  1. Open http://localhost:3000 in your browser
  2. You should see the dashboard (or setup wizard on first run)
  3. If you see a white screen, check that your gateway is running and .env is correct

See SETUP.md for detailed setup instructions, troubleshooting, and agent-friendly setup steps.

📱 Install as App (Recommended)

ClawSuite is a Progressive Web App (PWA) — install it for the full native app experience with no browser chrome, keyboard shortcuts, and offline support.

🖥️ Desktop (macOS / Windows / Linux)

  1. Open ClawSuite in Chrome or Edge at http://localhost:3000
  2. Click the install icon (⊕) in the address bar
  3. Click Install — ClawSuite opens as a standalone desktop app
  4. Pin to Dock / Taskbar for quick access

macOS users: After installing, you can also add it to your Launchpad.

📱 iPhone / iPad (iOS Safari)

  1. Open ClawSuite in Safari on your iPhone
  2. Tap the Share button (□↑)
  3. Scroll down and tap "Add to Home Screen"
  4. Tap Add — the ClawSuite icon appears on your home screen
  5. Launch from home screen for the full native app experience

🤖 Android

  1. Open ClawSuite in Chrome on your Android device
  2. Tap the three-dot menu (⋮) → "Add to Home screen"
  3. Tap Add — ClawSuite is now a native-feeling app on your device

📡 Mobile Access via Tailscale

Access ClawSuite from anywhere on your devices — no port forwarding, no VPN complexity.

Setup

  1. Install Tailscale on your Mac and mobile device:

  2. Sign in to the same Tailscale account on both devices

  3. Find your Mac's Tailscale IP:

    tailscale ip -4
# Example output: 100.x.x.x

  4. Open ClawSuite on your phone:

    http://100.x.x.x:3000

  5. Add to Home Screen using the steps above for the full app experience

💡 Tailscale works over any network — home wifi, mobile data, even across countries. Your traffic stays end-to-end encrypted.

🖥️ Native Desktop App

Status: In Development — A native Electron-based desktop app is in active development.

The desktop app will offer:

  • Native window management and tray icon
  • System notifications for agent events and mission completions
  • Auto-launch on startup
  • Deep OS integration (macOS menu bar, Windows taskbar)

In the meantime: Install ClawSuite as a PWA (see above) for a near-native desktop experience — it works great.

☁️ Cloud & Hosted Setup

Status: Coming Soon

A fully managed cloud version of ClawSuite is in development:

  • One-click deploy — No self-hosting required
  • Multi-device sync — Access your agents from any device
  • Team collaboration — Shared mission control for your whole team
  • Automatic updates — Always on the latest version

Features pending cloud infrastructure:

  • Cross-device session sync
  • Team shared memory and workspaces
  • Cloud-hosted gateway with managed uptime
  • Webhook integrations and external triggers

✨ Features

🤖 Mission Control & Agent Hub

  • Full multi-agent orchestration — spawn, pause, resume, abort
  • Isometric office view — see your agents working in real time
  • Live SSE output streaming per agent
  • Mission reports with success rate, token count, and artifacts
  • Exec approval prompts — approve/deny sensitive commands in-UI

💬 Chat

  • Real-time token streaming (no waiting for full response)
  • Multi-session management with full history
  • File and image attachments
  • Markdown + syntax highlighting
  • Message search (Cmd+F)

📊 Dashboard & Cost Analytics

  • Per-agent spend breakdown with daily trend charts
  • MTD totals and projected EOM cost
  • Provider-specific breakdowns (OpenAI, Anthropic, Google, etc.)
  • Gateway health, uptime, and system metrics footer

🌐 Built-in Browser

  • Headed Chromium with stealth anti-detection
  • Agent handoff — share live pages with your AI
  • Persistent sessions (cookies survive restarts)

🛒 Skills Marketplace

  • 2,000+ skills from ClawdHub registry
  • Security scanning before install — every skill audited
  • One-click install with dependency resolution

🛠️ Developer Tools

  • Terminal — Full PTY with cross-platform support
  • File Browser — Navigate workspace, preview and edit files (Monaco editor)
  • Memory Browser — Browse and edit agent memory files
  • Cron Manager — Schedule recurring tasks and automations
  • Debug Console — Gateway diagnostics and pattern-based troubleshooter

🎨 Themes

  • Paper Light, Ops Dark, Premium Dark
  • Theme persists across sessions
  • Full mobile dark mode support

🔒 Security

  • Auth middleware on all API routes
  • Wildcard CORS locked to localhost
  • Path traversal prevention on file/memory routes
  • Rate limiting on all endpoints
  • Skills security scanning before install
  • Exec approval workflow for sensitive commands

🗺️ Roadmap

Feature Status
Mission Control + Agent Hub ✅ Shipped (v3.0)
Live SSE Streaming ✅ Shipped (v3.0)
Cost Analytics ✅ Shipped (v3.0)
Mobile PWA + Tailscale ✅ Shipped (v3.0)
Native Desktop App (Electron) 🔨 In Development
Cloud / Hosted Version 🔜 Coming Soon
Team Collaboration 🔜 Coming Soon
Multi-device Session Sync 🔜 Coming Soon
Provider Approval Workflow 🔨 In Development
Board Groups / Project Hierarchy 📋 Planned

⭐ Star History

Star History Chart

💛 Support the Project

ClawSuite is free and open source. If it's saving you time and powering your workflow, consider supporting development:

ETH: 0xB332D4C60f6FBd94913e3Fd40d77e3FE901FAe22

GitHub Sponsors

Every contribution helps keep this project moving. Thank you 🙏

🤝 Contributing

PRs are welcome! See CONTRIBUTING.md for guidelines.

  • Bug fixes → open a PR directly
  • New features → open an issue first to discuss
  • Security issues → see SECURITY.md for responsible disclosure

📄 License

MIT — see LICENSE for details.

Built with ⚡ by @outsourc-e and the ClawSuite community