CLI commands

Riferimento della CLI

openclaw è il punto di ingresso principale della CLI. Ogni comando principale dispone di una pagina di riferimento dedicata oppure è documentato insieme al comando di cui è alias; questo indice elenca i comandi, i flag globali e le regole di formattazione dell'output applicabili all'intera CLI.

Comandi di configurazione in base allo scopo:

openclaw setup e openclaw onboard verificano prima l'inferenza, quindi avviano Crestodian per configurare Gateway, spazio di lavoro, canali, Skills e stato di integrità.
openclaw setup --baseline crea la configurazione di base e lo spazio di lavoro senza eseguire il flusso guidato di configurazione iniziale.
openclaw configure modifica parti specifiche di una configurazione esistente: autenticazione del modello, Gateway, canali, Plugin o Skills.
openclaw channels add configura gli account dei canali dopo la creazione della configurazione di base; eseguilo senza flag per la configurazione guidata oppure con flag specifici del canale per gli script.

Pagine dei comandi

Area	Comandi
Configurazione e avvio guidato	`crestodian` · `setup` · `onboard` · `configure` · `config` · `completion` · `doctor` · `dashboard`
Ripristino, backup e migrazione	`backup` · `migrate` · `reset` · `uninstall` · `update`
Messaggistica e agenti	`message` · `agent` · `agents` · `attach` · `acp` · `mcp`
Integrità e sessioni	`status` · `health` · `sessions` · `audit`
Gateway e registri	`gateway` · `logs` · `system`
Modelli e inferenza	`models` · `promos` · `infer` · `capability` (alias di `infer`) · `memory` · `commitments` · `wiki`
Rete e nodi	`directory` · `nodes` · `devices` · `node`
Runtime e sandbox	`approvals` · `exec-policy` (vedi `approvals`) · `sandbox` · `tui` · `chat`/`terminal` (alias di `tui --local`) · `browser`
Automazione	`cron` · `tasks` · `hooks` · `webhooks` · `transcripts`
Individuazione e documentazione	`dns` · `docs`
Associazione e canali	`pairing` · `qr` · `channels`
Sicurezza e Plugin	`security` · `secrets` · `skills` · `plugins` · `proxy`
Alias precedenti	`daemon` (servizio Gateway) · `clawbot` (spazio dei nomi)
Plugin (facoltativi)	`path` · `policy` · `voicecall` · `workboard` (se installato)

Flag globali

Flag	Scopo
`--dev`	Isola lo stato in `~/.openclaw-dev`, imposta la porta predefinita del Gateway su 19001 e trasla le porte derivate
`--profile <name>`	Isola lo stato in `~/.openclaw-<name>` (`OPENCLAW_STATE_DIR`/`OPENCLAW_CONFIG_PATH`)
`--container <name>`	Esegue la CLI all'interno di un container Podman/Docker in esecuzione denominato `<name>` (predefinito: variabile di ambiente `OPENCLAW_CONTAINER`)
`--log-level <level>`	Sostituisce il livello di registrazione globale per l'output su file e console
`--no-color`	Disabilita i colori ANSI (viene rispettato anche `NO_COLOR=1`)
`--update`	Forma abbreviata di `openclaw update`; funziona sia per i checkout del codice sorgente sia per le installazioni dei pacchetti
`-V`, `--version`, `-v`	Stampa la versione ed esce

Modalità di output

I colori ANSI e gli indicatori di avanzamento vengono visualizzati solo nelle sessioni TTY.
I collegamenti ipertestuali OSC-8 vengono visualizzati come collegamenti selezionabili dove supportati; altrimenti la CLI utilizza URL in testo semplice.
--json (e --plain, dove supportato) disabilita la formattazione per produrre un output pulito.
I comandi di lunga durata mostrano un indicatore di avanzamento (OSC 9;4, se supportato).

Tavolozza dei colori

OpenClaw utilizza una tavolozza ispirata all'aragosta per l'output della CLI:

Token	Esadecimale	Utilizzato per
`accent`	`#FF5A2D`	Titoli, etichette, evidenziazioni principali
`accentBright`	`#FF7A3D`	Nomi dei comandi, enfasi
`accentDim`	`#D14A22`	Testo di evidenziazione secondario
`info`	`#FF8A5B`	Valori informativi
`success`	`#2FBF71`	Stati di riuscita
`warn`	`#FFB020`	Avvisi, flag delle opzioni, ripieghi
`error`	`#E23D2D`	Errori, operazioni non riuscite
`muted`	`#8B7F77`	Attenuazione, metadati

Fonte autorevole della tavolozza: packages/terminal-core/src/palette.ts.

Albero dei comandi

Albero completo dei comandi

Questa mappa comprende i comandi principali e i relativi sottocomandi principali. I sottocomandi aggiunti dai Plugin (ad esempio in skills, plugins e wiki) evolvono in modo indipendente; esegui <command> --help per ottenere l'elenco autorevole e aggiornato.

Code

openclaw [--dev] [--profile <name>] <command>crestodiansetuponboardconfigureconfig  get  set  unset  file  schema  validatecompletiondoctordashboardbackup  create  verifymigrate  list  plan <provider>  apply <provider>security  auditsecrets  reload  audit  configure  applyresetuninstallupdate  wizard  status  repairchannels  list  status  capabilities  resolve  logs  add  remove  login  logoutdirectory  self  peers list  groups list|membersskills  search  install  update  verify  workshop list|inspect|propose-create|propose-update|revise|apply|reject|quarantine  list  info  checkplugins  list  search  inspect  install  uninstall  update  enable  disable  doctor  build  validate  init  registry  marketplace list|entries|refreshworkboard  list  create  show  dispatchmemory  status  index  searchtranscripts  list  show  pathpath  resolve  find  set  validate  emitcommitments  list  dismisswiki  status  doctor  init  compile  lint  ingest  okf import  search  get  apply synthesis|metadata  bridge import  unsafe-local import  chatgpt import|rollback  obsidian status|search|open|command|dailymessage  send  broadcast  poll  react  reactions  read  edit  delete  pin  unpin  pins  permissions  search  thread create|list|reply  emoji list|upload  sticker send|upload  role info|add|remove  channel info|list  member info  voice status  event list|create  timeout  kick  banagentagents  list  add  delete  bindings  bind  unbind  set-identityattachacpmcp  serve  list  show  set  unsetstatushealthsessions  cleanupaudittasks  list  audit  maintenance  show  notify  cancel  flow list|show|cancelgateway  call  usage-cost  health  stability  diagnostics export  status  probe  discover  install  uninstall  start  stop  restart  rundaemon  status  install  uninstall  start  stop  restartlogssystem  event  heartbeat last|enable|disable  presencemodels  list  status  set  set-image  aliases list|add|remove  fallbacks list|add|remove|clear  image-fallbacks list|add|remove|clear  scan  auth list|add|login|setup-token|paste-token|paste-api-key|login-github-copilot  auth order get|set|clearpromos  list  claim <slug>infer (alias: capability)  list  inspect  model run|list|inspect|providers|auth login|logout|status  image generate|edit|describe|describe-many|providers  audio transcribe|providers  tts convert|voices|personas|providers|status|enable|disable|set-provider|set-persona  video generate|describe|providers  web search|fetch|providers  embedding create|providerssandbox  list  recreate  explaincron  status  list  get  add  edit  rm  enable  disable  runs  runnodes  status  describe  list  pending  approve  reject  rename  invoke  notify  push  canvas snapshot|present|hide|navigate|eval  canvas a2ui push|reset  camera list|snap|clip  screen record  location getdevices  list  remove  clear  approve  reject  rotate  revokenode  run  status  install  uninstall  stop  restartapprovals  get  set  allowlist add|removeexec-policy  show  preset  setbrowser  status  start  stop  reset-profile  tabs  open  focus  close  profiles  create-profile  delete-profile  screenshot  snapshot  navigate  resize  click  type  press  hover  drag  select  upload  fill  dialog  wait  evaluate  console  pdfhooks  list  info  check  enable  disable  install  updatewebhooks  gmail setup|runproxy  start  run  coverage  sessions  query  blob  purgepairing  list  approveqrclawbot  qrdocsdns  setuptuichat (alias: tui --local)terminal (alias: tui --local)

I Plugin possono aggiungere ulteriori comandi di primo livello, come openclaw workboard o openclaw voicecall.

Comandi slash della chat

I messaggi della chat supportano i comandi /.... Consulta comandi slash.

In evidenza:

/status - diagnostica rapida.
/trace - righe di tracciamento e debug dei Plugin limitate alla sessione.
/config - modifiche persistenti alla configurazione.
/debug - sostituzioni della configurazione valide solo durante l'esecuzione (in memoria, non su disco; richiede commands.debug: true).

Monitoraggio dell'utilizzo

openclaw status --usage e l'interfaccia di controllo mostrano l'utilizzo e la quota del provider quando sono disponibili le credenziali OAuth/API. I dati provengono direttamente dagli endpoint di utilizzo dei provider e vengono normalizzati nel formato X% left. Provider con finestre di utilizzo correnti: Anthropic, Gemini CLI, GitHub Copilot, MiniMax, OpenAI Codex, Xiaomi e z.ai.

Per maggiori dettagli, consulta Monitoraggio dell'utilizzo.

Contenuti correlati

Was this useful?