Setup

Connect your OpenClaw installation to OpenClawHQ

Your Installation Token

Use this token to link your OpenClaw instance to your account

Loading token...

⚠️ Keep this token secret. Regenerate if compromised.

One-line Install

Recommended

This command installs OpenClaw, runs setup, and connects to OpenClawHQ automatically.

curl -fsSL https://openclawhq.com/api/install | bash -s -- --token Loading token...

Step-by-step Setup

1

Install OpenClaw

Run this single command on your machine to install OpenClaw and connect it to OpenClawHQ.

bash
curl -fsSL https://openclawhq.com/api/install | bash -s -- --token Loading token...
# Note: If testing locally, the bridge must be npm linked.

Requires Node.js ≥ 22. Works on macOS, Linux, and Windows (WSL).

2

Complete onboarding

The installer runs the OpenClaw wizard and sets up your first agent.

bash
# The installer automatically runs:
openclaw onboard --install-daemon
openclaw gateway --port 18789

The wizard will ask you to choose your AI provider and connect your first messaging channel.

3

Add more agents

Create specialized agents with unique roles and session keys.

bash
openclaw agents add work --model anthropic/claude-opus-4-6
openclaw agents add personal --model anthropic/claude-sonnet-4-6

Each agent gets its own workspace, soul, and session store.

4

Set up heartbeats

Keep agents active with scheduled cron wakeups every 15 minutes.

bash
openclaw cron add \
  --name "work-heartbeat" \
  --cron "*/15 * * * *" \
  --session "isolated" \
  --agent "work" \
  --message "Check for new tasks. Report HEARTBEAT_OK if nothing urgent."

Stagger your agents by 2 minutes to avoid simultaneous API calls.

Connect Channels

Add messaging platforms to your agents. OpenClaw supports 11 channels.

📱

WhatsApp

openclaw channels login --channel whatsapp
✈️

Telegram

openclaw channels login --channel telegram --account my-bot
💬

Slack

openclaw channels login --channel slack --account workspace
🎮

Discord

openclaw channels login --channel discord --account bot-token
🔒

Signal

openclaw channels login --channel signal
💬

iMessage

# Via BlueBubbles
🔷

Matrix

openclaw channels login --channel matrix
🏢

Teams

openclaw channels login --channel teams

What You Get

Multi-agent routing

Run 10+ specialized agents, each with their own soul, memory, and session

Heartbeat system

Agents wake every 15 minutes via cron, do their work, and sleep

Per-agent sandboxing

Restrict tools and filesystem access per agent

11 messaging channels

WhatsApp, Telegram, Slack, Discord, iMessage, Signal, and more

Diagnose Issues

Run this command to check your OpenClaw configuration:

openclaw doctor

Gateway status: Online · ws://127.0.0.1:18789