Introduction

Welcome to Clawner

Clawner is a remote orchestrator for OpenClaw (opens in a new tab) agents. Monitor, control, and manage your entire fleet from a single dashboard.

Quick Start

1. Deploy the Dashboard

docker run -d \
  -p 9000:9000 \
  -p 3002:3002 \
  -e CLAWNER_PASSWORD=your-password \
  ghcr.io/clawner/dashboard

2. Install the Agent

On each machine running OpenClaw:

npm install -g @clawner/agent

3. Connect

Get an invite code from your dashboard, then:

clawner join YOUR-INVITE-CODE -s wss://your-server.com/ws

Features

  • Real-time monitoring β€” CPU, memory, load averages every 30s
  • Remote commands β€” Start/stop gateway, manage agents, view logs
  • Secure by default β€” Invite codes, JWT auth, self-hosted
  • Open source β€” MIT license, fork it, extend it

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Dashboard     β”‚     β”‚     Server      β”‚     β”‚  @clawner/agent β”‚
β”‚   (Next.js)     │────▢│  (WebSocket)    │◀────│  (on each host) β”‚
β”‚   :3002         β”‚     β”‚   :9000         β”‚     β”‚                 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                                        β”‚
                                                        β–Ό
                                                β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                                                β”‚    OpenClaw     β”‚
                                                β”‚    Gateway      β”‚
                                                β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Next Steps