openclaw

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
openclaw --log-level <level>  # Override log level (silent|fatal|error|warn|info|debug|trace)
openclaw --no-color           # Disable ANSI colors

Setup and configuration

openclaw setup # Initialize config and workspace openclaw onboard # Interactive setup wizard openclaw configure # Interactive setup wizard for credentials, channels, gateway, and agent 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 Telegram, Discord, etc. openclaw channels # Manage channels

Device and session management

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

Cron jobs

openclaw cron # Manage cron jobs via the Gateway scheduler

## Common Workflows

### Initial Setup

```bash
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