Agent Installation

The Clawner agent is a lightweight CLI that runs on each host and connects to your Clawner dashboard.

Requirements

Node.js 18 or later
OpenClaw installed (optional, but required for full functionality)

Installation

npm install -g @clawner/agent

Verify the installation:

clawner --version

Connecting to a Dashboard

Get an Invite Code

From your Clawner dashboard, generate an invite code. Or via API:

curl -X POST https://your-dashboard.com:9000/invite \
  -H "Authorization: Bearer YOUR_TOKEN"

Join the Dashboard

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

Options:

-s, --server <url> — WebSocket URL of your dashboard
-n, --name <name> — Display name for this host (default: hostname)
--no-save — Don't save configuration for reconnect

Reconnecting

If you've joined before, reconnect with:

clawner reconnect

Running as a Service

systemd (Linux)

Create /etc/systemd/system/clawner.service:

[Unit]
Description=Clawner Agent
After=network.target
 
[Service]
Type=simple
User=your-user
ExecStart=/usr/bin/clawner reconnect
Restart=always
RestartSec=10
 
[Install]
WantedBy=multi-user.target

Enable and start:

sudo systemctl enable clawner
sudo systemctl start clawner

launchd (macOS)

Create ~/Library/LaunchAgents/com.clawner.agent.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.clawner.agent</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/clawner</string>
        <string>reconnect</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

Load:

launchctl load ~/Library/LaunchAgents/com.clawner.agent.plist

API Reference Commands