CLI commands

CLI-Referenz

openclaw ist der zentrale CLI-Einstiegspunkt. Jeder Kernbefehl verfügt über eine eigene Referenzseite oder wird zusammen mit dem Befehl dokumentiert, für den er als Alias dient; dieser Index führt die Befehle, globalen Flags und Regeln für die Ausgabegestaltung auf, die in der gesamten CLI gelten.

Einrichtungsbefehle nach Zweck:

openclaw setup und openclaw onboard prüfen zuerst die Inferenz und starten dann OpenClaw zur Einrichtung von Gateway, Arbeitsbereich, Kanälen, Skills und Systemzustand.
openclaw setup --baseline erstellt die Basiskonfiguration und den Arbeitsbereich, ohne den geführten Onboarding-Ablauf zu durchlaufen.
openclaw configure ändert gezielt Teile einer bestehenden Einrichtung: Modellauthentifizierung, Gateway, Kanäle, Plugins oder Skills.
openclaw channels add konfiguriert Kanalkonten, nachdem die Basiskonfiguration vorhanden ist; bei alleiniger Auswahl eines Kanals wird die geführte Einrichtung verwendet, während Flags für Konto, Anmeldedaten oder Kanalkonfiguration den direkten Pfad für Skripte verwenden.

Befehlsseiten

Bereich	Befehle
Einrichtung und Onboarding	`openclaw` · `setup` · `onboard` · `configure` · `config` · `completion` · `doctor` · `dashboard`
Zurücksetzen, Sicherung und Migration	`backup` · `migrate` · `reset` · `uninstall` · `update`
Nachrichten und Agenten	`message` · `agent` · `agents` · `attach` · `acp` · `mcp`
Systemzustand und Sitzungen	`status` · `health` · `sessions` · `audit`
Gateway und Protokolle	`gateway` · `logs` · `system`
Modelle und Inferenz	`models` · `promos` · `infer` · `capability` (Alias für `infer`) · `memory` · `commitments` · `wiki`
Netzwerk und Nodes	`directory` · `nodes` · `devices` · `node` · `worker`
Laufzeit und Sandbox	`approvals` · `exec-policy` (siehe `approvals`) · `sandbox` · `tui` · `chat`/`terminal` (Aliasse für `tui --local`) · `browser`
Automatisierung	`cron` · `tasks` · `hooks` · `webhooks` · `transcripts`
Erkennung und Dokumentation	`dns` · `docs`
Kopplung und Kanäle	`pairing` · `qr` · `channels`
Sicherheit und Plugins	`security` · `secrets` · `skills` · `plugins` · `proxy`
Veraltete Aliasse	`daemon` (Gateway-Dienst) · `clawbot` (Namensraum)
Plugins (optional)	`path` · `policy` · `voicecall` · `workboard` (falls installiert)

Globale Flags

Flag	Zweck
`--dev`	Zustand unter `~/.openclaw-dev` isolieren, den standardmäßigen Gateway-Port 19001 verwenden und abgeleitete Ports verschieben
`--profile <name>`	Zustand unter `~/.openclaw-<name>` isolieren (`OPENCLAW_STATE_DIR`/`OPENCLAW_CONFIG_PATH`)
`--container <name>`	Die CLI in einem laufenden Podman-/Docker-Container namens `<name>` ausführen (Standard: Umgebungsvariable `OPENCLAW_CONTAINER`)
`--log-level <level>`	Die globale Protokollierungsstufe für Datei- und Konsolenausgabe überschreiben
`--no-color`	ANSI-Farben deaktivieren (`NO_COLOR=1` wird ebenfalls berücksichtigt)
`--update`	Kurzform für `openclaw update`; funktioniert sowohl für Quellcode-Checkouts als auch für Paketinstallationen
`-V`, `--version`, `-v`	Version ausgeben und beenden

Ausgabemodi

ANSI-Farben und Fortschrittsanzeigen werden nur in TTY-Sitzungen dargestellt.
OSC-8-Hyperlinks werden, sofern unterstützt, als anklickbare Links dargestellt; andernfalls greift die CLI auf einfache URLs zurück.
--json (und --plain, sofern unterstützt) deaktiviert die Gestaltung für eine bereinigte Ausgabe.
Lang laufende Befehle zeigen eine Fortschrittsanzeige an (OSC 9;4, sofern unterstützt).

Farbpalette

OpenClaw verwendet für die CLI-Ausgabe eine Hummer-Farbpalette:

Token	Hex	Verwendet für
`accent`	`#FF5A2D`	Überschriften, Beschriftungen, primäre Hervorhebungen
`accentBright`	`#FF7A3D`	Befehlsnamen, Hervorhebung
`accentDim`	`#D14A22`	Sekundär hervorgehobener Text
`info`	`#FF8A5B`	Informationswerte
`success`	`#2FBF71`	Erfolgszustände
`warn`	`#FFB020`	Warnungen, Options-Flags, Rückfalloptionen
`error`	`#E23D2D`	Fehler, Fehlschläge
`muted`	`#8B7F77`	Zurückgenommene Darstellung, Metadaten

Maßgebliche Quelle für die Palette: packages/terminal-core/src/palette.ts.

Befehlsbaum

Vollständiger Befehlsbaum

Diese Übersicht deckt die Kernbefehle und ihre wichtigsten Unterbefehle ab. Durch Plugins hinzugefügte Unterbefehle (zum Beispiel unter skills, plugins und wiki) entwickeln sich unabhängig weiter; führen Sie <command> --help aus, um die maßgebliche aktuelle Liste anzuzeigen.

Code

openclaw [--dev] [--profile <name>] <command>openclawsetuponboardconfigureconfig  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  restartworkerapprovals  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)

Plugins können zusätzliche Befehle auf oberster Ebene hinzufügen, beispielsweise openclaw workboard oder openclaw voicecall.

Chat-Slash-Befehle

Chat-Nachrichten unterstützen /...-Befehle. Siehe Slash-Befehle.

Highlights:

/status – schnelle Diagnose.
/trace – sitzungsbezogene Trace-/Debug-Zeilen des Plugins.
/config – persistierte Konfigurationsänderungen.
/debug – ausschließlich zur Laufzeit geltende Konfigurationsüberschreibungen (im Arbeitsspeicher, nicht auf dem Datenträger; erfordert commands.debug: true).

Nutzungserfassung

openclaw status --usage und die Control UI zeigen die Provider-Nutzung und das Kontingent an, wenn OAuth-/API-Anmeldedaten verfügbar sind. Die Daten stammen direkt von den Nutzungsendpunkten der Provider und werden auf X% left normalisiert. Provider mit aktuellen Nutzungszeiträumen: Anthropic, Gemini CLI, GitHub Copilot, MiniMax, OpenAI Codex, Xiaomi und z.ai.

Weitere Einzelheiten finden Sie unter Nutzungserfassung.

Auf dieser Seite