pulse-memory/skills/openclaw-power-ops/references/cli-cheatsheet.md

OpenClaw CLI Cheat Sheet

Created 2026-02-23. Reference: https://docs.openclaw.ai/cli

⚠️ GOLDEN RULE

Do NOT edit openclaw.json directly. Use the CLI commands below. If unsure about a config key, ask Jared.

---

Telegram Bots / Channels

Add a new Telegram bot

openclaw channels add --channel telegram --token <bot-token>

Then add a binding (routes messages to the right agent):

openclaw config set bindings '[...existing, {"agentId":"<agent-id>","match":{"channel":"telegram","accountId":"<account-id>"}}]' --strict-json

List channels

openclaw channels list
openclaw channels status

Remove a channel

openclaw channels remove --channel telegram --delete

Channel config keys to know

• dmPolicy: "open" | "closed"
• groupPolicy: "open" | "disabled"
• groupTrigger: "all" | "mention" (whether bot responds to all group messages or only @mentions)
• streaming: "off" (STRING, not boolean false!)
• allowFrom: ["*"] or list of user IDs

Docs: https://docs.openclaw.ai/cli/channels

---

Agents

List agents

openclaw agents list

Add a new agent

openclaw agents add <agent-id> --workspace <path>

Set agent identity

openclaw agents set-identity --agent <id> --name "Name" --emoji "🏹" --avatar path/to/avatar.png
# Or from IDENTITY.md:
openclaw agents set-identity --workspace <path> --from-identity

Delete an agent

openclaw agents delete <agent-id>

Docs: https://docs.openclaw.ai/cli/agents

---

Models

Check current model status

openclaw models status
openclaw models status --agent <id>  # per-agent
openclaw models status --probe       # live auth check (uses tokens!)

Set default model

openclaw models set <model-or-alias>
# Examples:
openclaw models set anthropic/claude-opus-4-6
openclaw models set minimax/MiniMax-M2.5-Lightning
openclaw models set Minimax  # alias

List available models

openclaw models list

Manage aliases

openclaw models aliases list
openclaw models aliases add <alias> <provider/model>
openclaw models aliases remove <alias>

Manage fallbacks

openclaw models fallbacks list
openclaw models fallbacks add <provider/model>
openclaw models fallbacks remove <provider/model>
openclaw models fallbacks clear

Auth profiles

openclaw models auth add
openclaw models auth login --provider <id>
openclaw models auth setup-token
openclaw models auth paste-token

Scan for available models

openclaw models scan

Docs: https://docs.openclaw.ai/cli/models

---

Config (get/set/unset)

Read a value

openclaw config get agents.defaults.workspace
openclaw config get agents.list[0].id
openclaw config get channels.telegram.accounts

Set a value

openclaw config set <path> <value>
# JSON values need --strict-json:
openclaw config set agents.defaults.heartbeat.every "2h"
openclaw config set gateway.port 19001 --strict-json
openclaw config set channels.whatsapp.groups '["*"]' --strict-json

Unset a value

openclaw config unset tools.web.search.apiKey

Agent-specific config (by list index)

openclaw config get agents.list        # see all agents and their indices
openclaw config set agents.list[1].tools.exec.node "node-id"

Always restart gateway after config edits:

openclaw gateway restart

Docs: https://docs.openclaw.ai/cli/config

---

Gateway

openclaw gateway status
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway health

---

Sessions

openclaw sessions                  # list all
openclaw sessions --active 120     # active in last 120 min
openclaw sessions --json

---

Other Useful Commands

Status & diagnostics

openclaw status
openclaw status --deep
openclaw doctor
openclaw doctor --fix

Security

openclaw security audit
openclaw security audit --deep
openclaw security audit --fix

Logs

openclaw logs
openclaw channels logs --channel all

Skills

openclaw skills list
openclaw skills info <name>
openclaw skills check

Cron

openclaw cron list
openclaw cron status
openclaw cron add
openclaw cron edit <id>
openclaw cron rm <id>

Memory

openclaw memory status
openclaw memory index
openclaw memory search "<query>"

---

Key Config Paths (for config get/set)

Path	What it controls
agents.list	All agent definitions
agents.list[N].id	Agent ID
agents.list[N].model	Agent's model
agents.list[N].workspace	Agent workspace path
agents.list[N].thinking	Reasoning display ("off"/"on"/"stream")
agents.defaults.model.primary	Default model for all agents
agents.defaults.model.fallbacks	Fallback model list
agents.defaults.subagents	Subagent config (maxConcurrent, maxSpawnDepth, etc.)
agents.defaults.heartbeat.every	Heartbeat interval
channels.telegram.accounts	All Telegram bot accounts
bindings	Agent ↔ channel routing rules
tools.sessions.visibility	Cross-agent messaging ("all"/"none")
gateway.port	Gateway port

---

Reminders

• Restart gateway after any config change
• Use CLI for config changes, not direct JSON editing
• Telegram accounts: NO agent field inside account config — use bindings array
• Telegram streaming: must be string "off", not boolean false