FREE REFERENCEALWAYS UP TO DATE

OpenClaw CLI
Command Reference

Every terminal command you need to run, manage, and debug OpenClaw — organized by category and ready to copy. Bookmark this. You'll use it more than you expect.

OpenClaw is controlled entirely from the terminal. Whether you're checking gateway health, tailing logs, scheduling cron jobs, or pairing a new device — there's a command for it. This reference covers all of them, from the ones you'll run daily to the ones you'll forget exist until you need them most.

⚡ The ones you'll use every day

openclaw statusopenclaw logsopenclaw doctoropenclaw gateway restartsudo openclaw updatecat ~/.openclaw/openclaw.json | grep "token"

🔧Gateway

openclaw gateway startStart the gateway daemon
openclaw gateway stopStop the gateway daemon
openclaw gateway restartRestart the gateway
openclaw gateway statusCheck if the gateway is running
openclaw healthQuick health check from the running gateway

🤖Models

openclaw models listList all configured models
openclaw models set <model-name>Set the default model — e.g. openclaw models set anthropic/claude-3-5-sonnet
openclaw models auth addAdd or update API keys for Anthropic, Google, OpenAI, and other providers — interactive
openclaw models statusShow current model state
openclaw configureReview everything at once — API keys, models, and channel connections — via the full setup wizard

🩺Doctor & Health

openclaw doctorRun health checks and surface quick fixes
openclaw doctor --fixAuto-apply all recommended repairs
openclaw doctor --deepDeep scan — finds extra gateway installs and conflicts
openclaw doctor --non-interactiveRun without prompts (safe for scripts)
openclaw security auditAudit your config for security issues
openclaw security audit --fixAuto-fix detected security issues

📋Status & Logs

openclaw statusChannel health + recent session overview
openclaw logsTail live gateway logs
openclaw channels statusShow channel-specific status
openclaw channels logsShow recent channel activity logs

⚙️Config & Setup

openclaw configureLaunch the interactive setup wizard
openclaw config getView your current config
openclaw config setSet a specific config value
openclaw updateUpdate OpenClaw to the latest release
openclaw update --channel betaSwitch to the beta release channel
openclaw update --dry-runPreview what an update would do without applying it
cat ~/.openclaw/openclaw.json | grep "token"Retrieve your Gateway token from the config file

💬Messaging & Channels

openclaw message send --channel telegram --target @user --message "Hi"Send a message via a specific channel
openclaw channels listList all configured messaging channels
openclaw channels addAdd a new channel interactively
openclaw directoryLook up contact and group IDs

🤖Agent & Sessions

openclaw agent --message "do something"Run a single agent turn from the terminal
openclaw sessionsList all sessions
openclaw sessions --active 120Show sessions active in the last 2 hours
openclaw sessions cleanupClean up old session data
openclaw tuiOpen the terminal UI — live chat in your terminal

🧠Memory & Skills

openclaw memory search "query"Search across memory files
openclaw skills listList all installed skills

🖥️Nodes & Devices

openclaw nodes statusList paired nodes and their connection status
openclaw nodes listList pending and paired nodes
openclaw nodes run --node <id> --raw "uname -a"Run a shell command on a paired node
openclaw nodes notify --node <id>Send a notification to a paired device
openclaw nodes camera snap --node <id>Take a photo from a paired node's camera

🕐Cron

openclaw cron listList all scheduled cron jobs
openclaw cron addAdd a new cron job interactively
openclaw cron run <id>Trigger a cron job immediately
openclaw cron runs <id>View run history for a job

🧩Plugins

openclaw plugins listList installed plugins
openclaw plugins install <pkg>Install a plugin by package name
openclaw plugins updateUpdate all installed plugins
openclaw plugins doctorReport plugin load issues

💾Backup

openclaw backup createBack up config, sessions, and workspaces
openclaw backup verify <file>Validate a backup archive

🔍Other Handy Ones

openclaw dashboardOpen the Control UI in your browser
openclaw docsSearch the live OpenClaw docs
openclaw qrGenerate a QR code for iOS pairing
openclaw resetReset config and state (keeps the CLI installed)

Want OpenClaw set up the right way?

Security hardened, memory optimized, and ready to run — before your first prompt.

Get the Free Installer →