CLI Reference

Clawctl CLI

The fastest path from signup to a running secure managed OpenClaw deployment.

npm install -g clawctl-cli

Install

Via npm (recommended)

npm install -g clawctl-cli

Via npx (no install)

npx clawctl-cli login

Quick Start

Install the CLI: npm i -g clawctl-cli
Sign up and authenticate: clawctl login
Check your deployment: clawctl status

Command Reference

Command	Aliases	Description
`login`	`--manual`	Authenticate via browser (device flow)
`logout`	`signout`	Sign out and remove saved credentials
`checkout`	`subscribe`	Open checkout page in browser
`whoami`	—	Show tenant identity and plan
`status`	—	Dashboard: plan, usage, health, approvals
`open`	`dashboard`	Open gateway dashboard in browser
`pause`	`stop`	Stop your agent immediately (kill switch)
`resume`	`start`	Restart your agent after pause
`openclaw`	`oc`	Run OpenClaw CLI commands
`version`	`--version, -v`	Show CLI version
`help`	`--help, -h`	Show help message

Examples

# Sign up and get your API key
clawctl login

# Subscribe to Team plan directly
clawctl checkout team

# Check your deployment status
clawctl status

# Open your gateway in the browser
clawctl open

# Emergency stop
clawctl pause

# Restart after pause
clawctl resume

Configuration

The easiest way to authenticate is the device flow:

clawctl login

This saves your credentials to ~/.clawctl/config.json. You can also set an environment variable instead (takes priority over the config file):

export OPENCLAW_TENANT_KEY="your-api-key-here"

Environment Variables

Variable	Required	Description
`OPENCLAW_TENANT_KEY`	Yes	Your tenant API key (from checkout or dashboard)

Kill Switch (Pause / Resume)

Instantly stop your agent if something goes wrong. The kill switch physically stops the container — no requests are processed while paused.

# Stop your agent immediately
clawctl pause

# Restart your agent
clawctl resume

# Check current status
clawctl status

Safety First

The kill switch is always available, regardless of plan. It works even if your agent is unresponsive. Use it whenever you need to immediately stop all agent activity.

CLI Troubleshooting

"Authentication Required"

Your OPENCLAW_TENANT_KEY is not set. Run clawctl login to authenticate via browser, or set it manually: export OPENCLAW_TENANT_KEY="your-key"

"Cannot connect to API"

The CLI cannot reach the Clawctl API. Check your internet connection and try again.

"Subscription Required"

Your account exists but has no active subscription. Run clawctl checkout to subscribe, or visit your dashboard to update payment info.

"Gateway is still provisioning"

Your gateway hasn't finished deploying yet. First-time provisioning can take up to 60 seconds. Run clawctl status to check progress.