About openclaw
OpenClaw CLI is a command-line interface for managing OpenClaw’s messaging gateway, agents, and channels. It supports WhatsApp and Telegram operations, device pairing, and automated messaging workflows.
Key features
- 01Gateway and agent management
- 02WhatsApp and Telegram channel operations
- 03Device pairing
- 04Automated messaging workflows
- 05Isolated development profiles
Use cases
- 01Initialize an OpenClaw workspace
- 02Log in to messaging channels
- 03Send messages through the gateway
- 04Run an agent turn for a recipient
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ paulrberg/ agent-skills --skill openclawAfter installing, type/openclawin Claude Code to confirm it loaded.
Details
From the project READMEOpenClaw 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
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
Comments
Markdown supported