CLI Command Reference
A quick reference for the most commonly used OpenClaw CLI commands.
General
| Command | Description |
|---|---|
openclaw --version | Print the CLI version |
openclaw status | Show instance status overview |
openclaw status --deep | Detailed status probe of all subsystems |
openclaw logs --follow | Stream live logs from the gateway |
Configuration
| Command | Description |
|---|---|
openclaw config get <path> | Read a configuration value |
openclaw config set <path> <value> | Set a configuration value |
Examples:
# Check the current AI model
openclaw config get agent.model
# Set the AI model
openclaw config set agent.model "anthropic/claude-sonnet-4-5"
Channels
| Command | Description |
|---|---|
openclaw channels list | List all channels and their status |
openclaw channels login | Start the login flow for a channel |
openclaw channels capabilities | Show what each channel supports |
Models
| Command | Description |
|---|---|
openclaw models list --all | List all available AI models |
openclaw models set <provider/model> | Set the active model |
openclaw models auth add | Add authentication for a model provider |
Examples:
# List models from all providers
openclaw models list --all
# Switch to a different model
openclaw models set openai/gpt-4o
Gateway
| Command | Description |
|---|---|
openclaw gateway status | Check if the gateway is running |
openclaw gateway start | Start the gateway |
openclaw gateway stop | Stop the gateway |
openclaw gateway restart | Restart the gateway |
info
On OpenClaw Host, the gateway is managed automatically. These commands are mainly useful for debugging or if you need to force a restart.
Skills
| Command | Description |
|---|---|
openclaw skills list | List installed skills |
openclaw skills list --eligible | List skills available for installation |
openclaw skills info <skill> | Show details about a specific skill |
Messaging
| Command | Description |
|---|---|
openclaw agent --message "text" --deliver | Send a one-off message through the agent |
openclaw message send --target <id> --message "text" | Send a direct message to a contact |
Plugins
| Command | Description |
|---|---|
openclaw plugins list | List all plugins and their status |
openclaw plugins enable <name> | Enable a plugin |
openclaw plugins disable <name> | Disable a plugin |