OpenClaw CLI

Overview

OpenClaw is a multi-channel messaging and agent platform. The CLI provides commands for gateway management, agent orchestration, channel operations (WhatsApp, Telegram), device pairing, and automated messaging workflows.

Quick Reference

# Check CLI version and help
openclaw --version
openclaw --help

# Setup and configuration
openclaw setup          # Initialize config and workspace
openclaw onboard        # Interactive setup wizard
openclaw configure      # Set credentials and defaults
openclaw doctor         # Health checks and diagnostics

# Gateway operations
openclaw gateway        # Start the WebSocket gateway
openclaw gateway --port 18789  # Custom port
openclaw --dev gateway  # Dev mode (isolated state, port 19001)
openclaw health         # Check gateway health
openclaw status         # Channel health and sessions

# Agent operations
openclaw agent --to +15555550123 --message "Hello"
openclaw agents         # Manage agent workspaces

# Messaging
openclaw message send --target +15555550123 --message "Hi"
openclaw message send --channel telegram --target @mychat --message "Hi"

# Channel management
openclaw channels login --verbose  # Link WhatsApp/Telegram
openclaw channels       # Manage channels

# Device and session management
openclaw devices        # Device pairing and tokens
openclaw sessions       # List conversation sessions

Common Workflows

Initial Setup

openclaw setup
openclaw onboard
openclaw channels login --verbose

Start Gateway and Send Message

openclaw gateway &
openclaw message send --target +15555550123 --message "Test"

Run Agent Turn

openclaw agent --to +15555550123 --message "Run summary" --deliver

Profile Isolation

Use --dev or --profile <name> to isolate state:

openclaw --dev gateway           # Uses ~/.openclaw-dev
openclaw --profile test gateway  # Uses ~/.openclaw-test

Documentation

Run openclaw --help for the latest available commands and options.

Full documentation: https://docs.openclaw.ai/cli