Complete reference for all openclaw CLI commands, organized by function.
Installation & Setup
| Command | Description |
|---|
openclaw onboard | Run the interactive setup wizard |
openclaw onboard --install-daemon | Setup wizard + install auto-start daemon |
openclaw onboard --skip-channel | Skip channel configuration step |
openclaw --version | Show current version |
openclaw --help | Show help information |
openclaw update | Update to the latest version |
Gateway Management
The Gateway is the core process that connects all channels and agents.
| Command | Description |
|---|
openclaw gateway start | Start the gateway |
openclaw gateway stop | Stop the gateway |
openclaw gateway restart | Restart the gateway (required after config changes) |
openclaw gateway status | Show gateway running status |
openclaw gateway --port 19000 | Start on a specific port (default: 18789) |
openclaw dashboard | Open the management dashboard in browser |
Model Management
| Command | Description |
|---|
openclaw models list | List currently available models |
openclaw models list --all | List all models across all providers |
openclaw models list --provider aigocode | List models for a specific provider |
openclaw models set aigocode/claude-opus-4-6 | Switch the default model |
openclaw models show | Show current model details |
Channel Management
| Command | Description |
|---|
openclaw channels list | List all configured channels |
openclaw channels status | Show connection status for each channel |
openclaw pairing list telegram | View pending Telegram pairing requests |
openclaw pairing approve telegram <code> | Approve a Telegram pairing request |
openclaw pairing revoke telegram <userId> | Revoke a pairing |
openclaw pairing list discord | View pending Discord pairing requests |
Agent Management
| Command | Description |
|---|
openclaw agents list | List all agents |
openclaw agents show <name> | Show a specific agent's configuration |
openclaw agents reload | Reload agent config without full restart |
openclaw context clear <agentName> | Clear a specific agent's context |
| Command | Description |
|---|
openclaw doctor | Full diagnosis (Node version, config, network, etc.) |
openclaw doctor --fix | Diagnose and attempt auto-repair |
openclaw status | System status (token usage, uptime, etc.) |
openclaw logs | Show recent logs |
openclaw logs --follow | Stream logs in real time (tail -f mode) |
openclaw logs --lines 100 | Show last 100 lines of logs |
openclaw logs --level error | Show error logs only |
Configuration Management
| Command | Description |
|---|
openclaw config show | Display current effective config (including defaults) |
openclaw config edit | Open config file in your default editor |
openclaw config validate | Validate config file syntax |
openclaw config reset | Reset config to factory defaults |
Common Workflows
Post-install verification
openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard
After changing config
openclaw config validate
openclaw gateway restart
openclaw status
Diagnose channel issues
openclaw channels status
openclaw logs --follow
openclaw doctor
Full reset (use with caution)
openclaw gateway stop
openclaw config reset
openclaw onboard
Config File Locations
~/.openclaw/openclaw.json # Main config file
~/.openclaw/agents/ # Agent config directory
~/.openclaw/logs/ # Log directory
Tip: All commands support --help, e.g. openclaw gateway --help.