Skip to content

openclaw-kr/clawsuite

 
 

Repository files navigation

ClawSuite

The Full-Stack Command Center for OpenClaw

ClawSuite is an open-source, self-hosted platform for OpenClaw AI agents. Not just a chat wrapper — it's a complete command center with built-in browser automation, skills marketplace, real-time dashboard, multi-agent orchestration, and enterprise-grade security scanning.

ClawSuite Dashboard

The first full-stack OpenClaw platform. Chat, browse, orchestrate, monitor — all in one place.

License Node Version PRs Welcome


✨ Features

💬 Intelligent Chat

  • Real-time conversations with AI agents powered by OpenClaw
  • Multi-session management with session history
  • Inline message editing and regeneration
  • Markdown rendering with syntax highlighting
  • Attachment support (images, files, code snippets)
  • Message search (Cmd+F)

🤖 Agent Hub

  • Browse and manage AI agent instances
  • Launch CLI agents directly from the UI
  • View active sessions and agent status
  • Agent swarm orchestration for multi-agent workflows
  • Real-time agent performance metrics

📊 Dashboard & Monitoring

  • Live usage and cost tracking across all providers
  • Interactive charts showing API consumption
  • Provider-specific breakdowns (OpenAI, Anthropic, Google, etc.)
  • Budget alerts and spending insights
  • Gateway health monitoring

🌐 Built-in Browser

  • Headed Chromium with stealth anti-detection
  • Agent handoff — share pages directly with your AI
  • Persistent sessions (login once, cookies survive restarts)
  • Control panel for web automation tasks

🛒 Skills Marketplace

  • Browse 2,000+ skills from ClawdHub registry
  • One-click install with dependency resolution
  • Security scanning — every skill scanned for suspicious patterns before install
  • Auto-discovery of locally installed skills

🛠️ Developer Tools

  • Terminal: Integrated terminal with cross-platform support
  • File Explorer: Browse workspace files with Monaco code editor
  • Debug Console: Gateway diagnostics with pattern-based troubleshooter
  • Memory Viewer: Inspect and manage agent memory state
  • Cron Manager: Schedule recurring tasks and automation

🔍 Power User Features

  • Global Search (Cmd+K): Quick navigation across all screens
  • Browser Automation: Control panel for web scraping and browser tasks
  • Activity Feed: Real-time event stream from Gateway WebSocket
  • Session Management: Pause, resume, or switch between conversations
  • Keyboard Shortcuts: Press ? to see all shortcuts

🎨 Customization

  • Dynamic accent color system (pick any color)
  • 3-way theme toggle (System / Light / Dark)
  • Settings popup dialog with 6 tabs
  • Provider setup wizard with guided onboarding
  • Model switcher — always accessible, never disabled

🔒 Security-First

  • Server-side API routes (keys never exposed to browser)
  • Rate limiting on all endpoints
  • Zod validation on all inputs
  • Skills security scanning before install
  • No hardcoded secrets in source

🚀 Getting Started

Prerequisites

Before running ClawSuite, ensure you have:

  • Node.js 22+ (Download)
  • OpenClaw Gateway running locally (Setup Guide)
    • Default gateway URL: http://localhost:18789

Installation

# Clone the repository
git clone https://github.com/outsourc-e/clawsuite.git
cd clawsuite

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:3000 in your browser.

Build for Production

# Build optimized production bundle
npm run build

# Preview production build
npm run preview

Optional: Desktop App (Tauri)

ClawSuite can be packaged as a native desktop application using Tauri:

# Install Tauri CLI (if not already installed)
npm install -g @tauri-apps/cli

# Run desktop app
tauri dev

# Build desktop app
tauri build

⚙️ Configuration

Gateway URL

ClawSuite connects to your OpenClaw gateway. Set the gateway URL in:

  1. Environment Variable (recommended):

    # Create .env file
    echo "CLAWDBOT_GATEWAY_URL=ws://127.0.0.1:18789" > .env
  2. In-App Settings:

    • Navigate to Settings → Gateway
    • Enter your gateway URL
    • Click "Test Connection"

Environment Variables

Create a .env file in the project root:

# Gateway configuration
CLAWDBOT_GATEWAY_URL=ws://127.0.0.1:18789

# Optional: Gateway authentication token
CLAWDBOT_GATEWAY_TOKEN=your_token_here

# Optional: Gateway password (alternative to token)
# CLAWDBOT_GATEWAY_PASSWORD=your_password

# Optional: Custom port for dev server
PORT=3000

# Optional: Enable debug logging
DEBUG=true

See .env.example for all available options.


🏗️ Architecture

ClawSuite is built with modern web technologies for performance and developer experience:

Tech Stack

How It Works

ClawSuite acts as a client UI for the OpenClaw Gateway:

  1. Frontend (React) renders the UI and handles user interactions
  2. Server Routes (/api/*) proxy requests to the OpenClaw Gateway
  3. WebSocket maintains real-time connection for streaming responses
  4. Gateway processes AI requests and manages agent sessions
┌─────────────┐      HTTP/WebSocket      ┌──────────────┐
│  ClawSuite  │ ◄────────────────────────► │   Gateway    │
│  (Browser)  │                           │  (localhost)  │
└─────────────┘                           └──────────────┘
                                                  │
                                                  ▼
                                          ┌──────────────┐
                                          │  AI Providers │
                                          │ (OpenAI, etc) │
                                          └──────────────┘

See docs/ARCHITECTURE.md for detailed architecture documentation.


📁 Project Structure

clawsuite/
├── src/
│   ├── routes/           # TanStack Router routes + API endpoints
│   │   ├── index.tsx     # Dashboard (home page)
│   │   ├── chat/         # Chat interface
│   │   ├── terminal.tsx  # Integrated terminal
│   │   ├── skills.tsx    # Skills marketplace
│   │   ├── settings/     # Settings screens
│   │   └── api/          # Server-side API routes
│   │       ├── send.ts          # Send chat message
│   │       ├── stream.ts        # SSE streaming
│   │       ├── terminal-*.ts    # Terminal PTY
│   │       └── gateway/         # Gateway RPC proxy
│   ├── screens/          # Feature screen components
│   │   ├── chat/         # Chat UI logic
│   │   ├── dashboard/    # Dashboard widgets
│   │   ├── skills/       # Skills browser
│   │   └── settings/     # Settings panels
│   ├── components/       # Shared UI components
│   │   ├── ui/           # Base UI primitives
│   │   ├── terminal/     # Terminal components
│   │   ├── agent-chat/   # Chat message components
│   │   └── search/       # Global search (Cmd+K)
│   ├── lib/              # Utilities and helpers
│   │   ├── gateway-api.ts       # Gateway API client
│   │   ├── provider-catalog.ts  # AI provider metadata
│   │   └── utils.ts             # Shared utilities
│   ├── server/           # Server-side code
│   │   ├── gateway.ts           # Gateway RPC client
│   │   ├── terminal-sessions.ts # PTY session manager
│   │   └── pty-helper.py        # Python PTY wrapper
│   └── types/            # TypeScript type definitions
├── public/               # Static assets
├── docs/                 # Documentation
├── scripts/              # Build and dev scripts
└── src-tauri/            # Tauri desktop app config

⌨️ Keyboard Shortcuts

Shortcut Action
Cmd+K (Ctrl+K) Open global search
Cmd+F (Ctrl+F) Search messages in chat
**Cmd+** (Ctrl+) Toggle terminal
Cmd+Enter Send message
Cmd+N New chat session
Cmd+/ Toggle chat panel
? Show all shortcuts
Esc Close dialogs/modals

🤝 Contributing

We welcome contributions! Whether it's bug reports, feature requests, or code contributions, we'd love to hear from you.

Quick Start

# Fork and clone the repo
git clone https://github.com/YOUR_USERNAME/clawsuite.git
cd clawsuite

# Create a feature branch
git checkout -b feature/your-feature-name

# Make your changes and commit
git commit -m "Add amazing feature"

# Push and open a PR
git push origin feature/your-feature-name

See CONTRIBUTING.md for detailed guidelines, including:

  • Code style and conventions (TypeScript strict, Tailwind, no portals/ScrollArea)
  • PR checklist and review process
  • Architecture decisions
  • Testing requirements

Development Guidelines

  • No ScrollArea or Portal patterns: Use native overflow and positioning
  • TypeScript strict mode: All code must pass type checking
  • Tailwind-first: Use utility classes; avoid custom CSS
  • Accessibility: All interactive elements must be keyboard-navigable

📜 License

ClawSuite is open-source software licensed under the MIT License.


🔗 Links


🙏 Acknowledgments

ClawSuite is built on top of the incredible OpenClaw project. Special thanks to all contributors and the open-source community.


Built with 🦞 by Eric

About

All-in-one command center for OpenClaw agents

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 95.8%
  • HTML 2.3%
  • CSS 0.7%
  • PowerShell 0.4%
  • Shell 0.3%
  • JavaScript 0.3%
  • Other 0.2%