Openclaw CLI

OpenClaw CLI

Complete reference for openclaw command-line interface operations.

When to Use

Managing OpenClaw gateway, agents, channels, skills, hooks, and automation.

Core Commands

Setup & Onboarding

Initial setup:

# Quick onboarding with daemon install
openclaw onboard --install-daemon

# Setup workspace and config
openclaw setup --workspace ~/.openclaw/workspace

# Interactive configuration
openclaw configure

Health check:

openclaw doctor

Gateway Management

Run gateway:

# Interactive mode
openclaw gateway

# With specific port
openclaw gateway --port 18789

# With tailscale
openclaw gateway --tailscale serve

Gateway service:

# Install as system service
openclaw gateway install

# Control service
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status

Gateway health:

openclaw status
openclaw status --deep     # Probe channels
openclaw health

Agent Management

List agents:

openclaw agents list
openclaw agents list --bindings    # Show routing

Add agent:

# Interactive wizard
openclaw agents add <name>

# Non-interactive
openclaw agents add dev \
  --workspace ~/.openclaw/workspace-dev \
  --model claude-sonnet-4.5 \
  --non-interactive

Delete agent:

openclaw agents delete <id>

Set identity:

# From IDENTITY.md
openclaw agents set-identity --agent main --from-identity

# Explicit values
openclaw agents set-identity --agent main \
  --name "MyAgent" \
  --emoji "🤖" \
  --avatar avatars/bot.png

Skills Management

List skills:

openclaw skills list
openclaw skills list --eligible    # Only ready skills
openclaw skills list --json        # JSON output

Skill info:

openclaw skills info <skill-name>

Check eligibility:

openclaw skills check

Hooks Management

List hooks:

openclaw hooks list
openclaw hooks list --eligible
openclaw hooks list --verbose      # Show missing requirements

Hook info:

openclaw hooks info <hook-name>

Enable/disable:

openclaw hooks enable session-memory
openclaw hooks disable command-logger

Install hooks:

# From npm
openclaw hooks install @openclaw/my-hooks

# Local directory
openclaw hooks install ./my-hooks

# Link (development)
openclaw hooks install -l ./my-hooks

Update hooks:

openclaw hooks update <id>
openclaw hooks update --all

Channel Management

List channels:

openclaw channels list

Channel status:

openclaw channels status
openclaw channels status --probe

Add channel:

# Interactive
openclaw channels add

# Telegram bot
openclaw channels add --channel telegram \
  --account alerts \
  --name "Alerts Bot" \
  --token $TELEGRAM_BOT_TOKEN

# Discord
openclaw channels add --channel discord \
  --account work \
  --token $DISCORD_BOT_TOKEN

Remove channel:

openclaw channels remove --channel telegram --account alerts
openclaw channels remove --channel discord --account work --delete

WhatsApp login:

openclaw channels login --channel whatsapp

Channel logs:

openclaw channels logs
openclaw channels logs --channel whatsapp --lines 100

Models & Authentication

Status:

openclaw models status
openclaw models status --probe               # Live check
openclaw models status --probe-provider anthropic

List models:

openclaw models list
openclaw models list --all
openclaw models list --provider anthropic

Set default:

openclaw models set claude-sonnet-4.5
openclaw models set-image claude-sonnet-4.5

Auth setup:

# Anthropic (recommended)
claude setup-token
openclaw models auth setup-token --provider anthropic

# Or paste token
openclaw models auth paste-token --provider anthropic

Fallbacks:

openclaw models fallbacks list
openclaw models fallbacks add claude-opus-4.6
openclaw models fallbacks remove claude-haiku-4.5
openclaw models fallbacks clear

Scan for models:

openclaw models scan
openclaw models scan --set-default

Messaging

Send message:

openclaw message send \
  --target +15555550123 \
  --message "Hello from OpenClaw"

# Discord channel
openclaw message send \
  --channel discord \
  --target channel:123456 \
  --message "Deployment complete"

Send poll:

openclaw message poll \
  --channel discord \
  --target channel:123 \
  --poll-question "Lunch?" \
  --poll-option "Pizza" \
  --poll-option "Sushi"

Other message operations:

openclaw message read --target +15555550123
openclaw message react --target <id> --emoji "👍"
openclaw message edit --target <id> --message "Updated"
openclaw message delete --target <id>

Browser Control

Status & control:

openclaw browser status
openclaw browser start
openclaw browser stop
openclaw browser tabs

Navigate:

openclaw browser open https://example.com
openclaw browser navigate https://example.com --target-id <id>

Interact:

openclaw browser click "#submit-button"
openclaw browser type "#email" "user@example.com"
openclaw browser press Enter

Capture:

openclaw browser screenshot
openclaw browser screenshot --full-page
openclaw browser snapshot --format ai

Profiles:

openclaw browser profiles
openclaw browser create-profile --name dev
openclaw browser delete-profile --name old

Nodes & Devices

List nodes:

openclaw nodes list
openclaw nodes status --connected

Node operations:

# Describe node
openclaw nodes describe --node <id>

# Run command on node
openclaw nodes run --node <id> --cwd /path -- ls -la

# Notify (macOS)
openclaw nodes notify --node <id> \
  --title "Build Complete" \
  --body "Success" \
  --sound default

Camera:

openclaw nodes camera list --node <id>
openclaw nodes camera snap --node <id> --facing front
openclaw nodes camera clip --node <id> --duration 10s

Canvas:

openclaw nodes canvas snapshot --node <id>
openclaw nodes canvas present --node <id> --target index.html
openclaw nodes canvas hide --node <id>

Screen recording:

openclaw nodes screen record --node <id> --duration 30s

System Commands

System event:

openclaw system event --text "Deployment complete" --mode now

Heartbeat:

openclaw system heartbeat last
openclaw system heartbeat enable
openclaw system heartbeat disable

Presence:

openclaw system presence

Cron Jobs

List jobs:

openclaw cron list
openclaw cron list --all
openclaw cron status

Add job:

# System event every hour
openclaw cron add \
  --name "hourly-check" \
  --every "1h" \
  --system-event "Hourly check"

# Message at specific time
openclaw cron add \
  --name "morning-reminder" \
  --at "09:00" \
  --message "Good morning!"

Manage jobs:

openclaw cron enable <id>
openclaw cron disable <id>
openclaw cron rm <id>
openclaw cron run <id>

Job runs:

openclaw cron runs --id <id> --limit 10

Configuration

Get/set config:

# Get value
openclaw config get agents.defaults.model.primary

# Set value
openclaw config set agents.defaults.model.primary "claude-sonnet-4.5"

# Unset value
openclaw config unset some.config.path

Memory Operations

Memory status:

openclaw memory status

Index memory:

openclaw memory index

Search memory:

openclaw memory search "GraphQL implementation patterns"

Logs

Tail logs:

openclaw logs
openclaw logs --follow
openclaw logs --limit 200
openclaw logs --json

Sandbox

List sandboxes:

openclaw sandbox list

Recreate sandbox: