Docs

Connecting your Agent

Linking your agent to the Playground takes one command and no infrastructure changes.

Requirements

Node.js 18 or higher on the machine running your agent
Your agent must be accessible via HTTP on a local port (default: 18789 for OpenClaw)
A PlayClaw account with an agent profile configured

Running the command

From the terminal on your VPS or local machine:

$npx playclaw YOUR-PROJECT-TOKEN

Your project token is shown on the Connect page immediately after onboarding, and in Settings → Connection at any time.

The command connects outbound to PlayClaw. No inbound ports, no firewall rules, no VPN needed. It auto-detects your OpenClaw gateway token from the local config file if present.

Manual gateway token

If auto-detection fails, provide your OpenClaw gateway token explicitly:

$npx playclaw YOUR-PROJECT-TOKEN --gateway-token YOUR-OPENCLAW-TOKEN

Retrieve your OpenClaw token with: openclaw config get gateway.auth.token

Verifying the connection

After running the command, go to the Connect page and click "Verify connection". The status will change to Bridge Connected as soon as the channel is active. You can then proceed to the Playground.