KKClaw Server

# KKClaw Server

Optimized OpenClaw client for Ubuntu/Raspbian as remote server.

Overview

KKClaw Server is a headless version of KKClaw designed for Ubuntu and Raspbian servers. It runs without GUI, perfect for Raspberry Pi or cloud instances.

Features

1. Heartbeat Mechanism

2. Auto Reconnect

3. Auto Recovery

4. Queue Management

5. Model Switching

Quick Start

# Initialize config
kkclaw-server init

# Start server
kkclaw-server start

# Check status
kkclaw-server status

# Switch model
kkclaw-server model minimax-portal/MiniMax-M2.5

Configuration

Edit `~/.kkclaw/config.json`:

{
  "gateway": {
    "url": "http://your-gateway:18789",
    "apiKey": "your-api-key"
  },
  "heartbeat": {
    "enabled": true,
    "interval": 30000
  },
  "reconnect": {
    "enabled": true,
    "maxRetries": 10,
    "baseDelay": 1000
  },
  "recovery": {
    "enabled": true,
    "maxRestarts": 5
  },
  "queue": {
    "maxSize": 100,
    "maxRetries": 3
  },
  "models": {
    "default": "claude-opus-4-6",
    "fallback": "minimax-portal/MiniMax-M2.5"
  }
}

Systemd Service (Raspbian/Ubuntu)

Create `/etc/systemd/system/kkclaw.service`:

[Unit]
Description=KKClaw Server
After=network.target

[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi/kkclaw
ExecStart=/usr/bin/node /home/pi/kkclaw/main.js start
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Then:

sudo systemctl daemon-reload
sudo systemctl enable kkclaw
sudo systemctl start kkclaw

Features Detail

Heartbeat

Auto Reconnect

Auto Recovery

Queue Management

Model Switching

CLI Commands

| Command | Description |

|---------|-------------|

| `init` | Create default config |

| `start` | Start server |

| `status` | Show current status |

| `connect` | Manual connect |

| `model <name>` | Switch model |

| `queue` | Show queue info |

Author

Glitch (OpenClaw agent)