CLI commands
CLI-Referenz
openclaw ist der zentrale CLI-Einstiegspunkt. Jeder Kernbefehl hat entweder eine
eigene Referenzseite oder ist zusammen mit dem Befehl dokumentiert, dessen Alias
er ist; dieser Index listet die Befehle, die globalen Flags und die Regeln für
die Ausgabestile auf, die CLI-weit gelten.
Verwenden Sie die Einrichtungsbefehle je nach Ziel:
openclaw setupundopenclaw onboardführen den vollständigen geführten Erstdurchlauf für Gateway, Modellauthentifizierung, Arbeitsbereich, Kanäle, Skills und Zustand aus.openclaw setup --baselineerstellt die Basiskonfiguration und den Arbeitsbereich, ohne den geführten Onboarding-Ablauf zu durchlaufen.openclaw configureändert gezielte Teile einer bestehenden Einrichtung, etwa Modellauthentifizierung, Gateway, Kanäle, Plugins oder Skills.openclaw channels addkonfiguriert Kanalkonten, nachdem die Basis vorhanden ist; führen Sie es ohne Flags für die geführte Kanaleinrichtung oder mit kanalspezifischen Flags für Skripte aus.
Befehlsseiten
| Bereich | Befehle |
|---|---|
| Einrichtung und Onboarding | crestodian · setup · onboard · configure · config · completion · doctor · dashboard |
| Zurücksetzen und Deinstallation | backup · reset · uninstall · update |
| Nachrichten und Agenten | message · agent · agents · attach · acp · mcp |
| Zustand und Sitzungen | status · health · sessions |
| Gateway und Protokolle | gateway · logs · system |
| Modelle und Inferenz | models · infer · capability (Alias für infer) · memory · commitments · wiki |
| Netzwerk und Knoten | directory · nodes · devices · node |
| Runtime und Sandbox | approvals · exec-policy (siehe approvals) · sandbox · tui · chat/terminal (Aliase für tui --local) · browser |
| Automatisierung | cron · tasks · hooks · webhooks · transcripts |
| Discovery und Dokumentation | dns · docs |
| Pairing und Kanäle | pairing · qr · channels |
| Sicherheit und Plugins | security · secrets · skills · plugins · proxy |
| Legacy-Aliase | daemon (Gateway-Dienst) · clawbot (Namespace) |
| Plugins (optional) | path · policy · voicecall · workboard (falls installiert) |
Globale Flags
| Flag | Zweck |
|---|---|
--dev |
Isoliert den Zustand unter ~/.openclaw-dev und verschiebt Standardports |
--profile <name> |
Isoliert den Zustand unter ~/.openclaw-<name> |
--container <name> |
Richtet die Ausführung auf einen benannten Container aus |
--no-color |
Deaktiviert ANSI-Farben (NO_COLOR=1 wird ebenfalls beachtet) |
--update |
Kurzform für openclaw update (nur Quellinstallationen) |
-V, --version, -v |
Gibt die Version aus und beendet |
Ausgabemodi
- ANSI-Farben und Fortschrittsanzeigen werden nur in TTY-Sitzungen dargestellt.
- OSC-8-Hyperlinks werden, wo unterstützt, als anklickbare Links dargestellt; andernfalls fällt die CLI auf einfache URLs zurück.
--json(und--plain, wo unterstützt) deaktiviert Styling für saubere Ausgabe.- Lang laufende Befehle zeigen eine Fortschrittsanzeige (OSC 9;4, sofern unterstützt).
Maßgebliche Quelle für die Palette: src/terminal/palette.ts.
Befehlsbaum
Vollständiger Befehlsbaum
openclaw [--dev] [--profile <name>] <command>crestodiansetuponboardconfigureconfig get set unset file schema validatecompletiondoctordashboardbackup create verifysecurity auditsecrets reload audit configure applyresetuninstallupdate wizard statuschannels list status capabilities resolve logs add remove login logoutdirectory self peers list groups list|membersskills search install update list info checkplugins list inspect install uninstall update enable disable doctor marketplace listworkboard list create show dispatchmemory status index searchtranscripts list show pathpath resolve find set validate emitcommitments list dismisswiki status doctor init ingest compile lint search get apply bridge import unsafe-local import 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 cleanuptasks list audit maintenance show notify cancel flow list|show|cancelgateway call usage-cost health 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 scaninfer (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|providers|status|enable|disable|set-provider video generate|describe|providers web search|fetch|providers embedding create|providers auth add|login|login-github-copilot|setup-token|paste-token auth order get|set|clearsandbox 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)Plugins können zusätzliche Befehle auf oberster Ebene hinzufügen, etwa
openclaw workboard oder openclaw voicecall.
Chat-Slash-Befehle
Chatnachrichten unterstützen /...-Befehle. Siehe Slash-Befehle.
Highlights:
/status— schnelle Diagnose./trace— sitzungsbezogene Plugin-Trace-/Debug-Zeilen./config— persistierte Konfigurationsänderungen./debug— reine Runtime-Konfigurationsüberschreibungen (Speicher, nicht Datenträger; erfordertcommands.debug: true).
Nutzungsverfolgung
openclaw status --usage und die Control UI zeigen Provider-Nutzung/-Kontingent an, wenn
OAuth-/API-Anmeldedaten verfügbar sind. Die Daten stammen direkt von Provider-Nutzungsendpunkten
und werden zu X% left normalisiert. Provider mit aktuellen Nutzungsfenstern:
Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax,
Xiaomi und z.ai.
Weitere Details finden Sie unter Nutzungsverfolgung.