CLI-Referenz

Alle OpenClaw CLI-Befehle, Slash-Commands und Code-Snippets auf einen Blick. Dazu die haeufigsten Probleme mit Loesungen. Basierend auf v2026.3.23.
50+
CLI-Befehle
20
Slash-Commands
34
Code-Snippets
10
Troubleshooting
Gateway 6
openclaw statusZeigt Gateway-Status, aktives Modell, Laufzeit
openclaw startGateway starten (Hintergrund)
openclaw stopGateway stoppen
openclaw restartGateway neu starten (Config neu laden)
openclaw dashboardWeb-Dashboard im Browser oeffnen
openclaw tuiTerminal-UI (interaktiver Chat im Terminal)
Channels 7
channels listAlle konfigurierten Kanaele anzeigen
channels status --probeKanaele aktiv pruefen (Verbindungstest)
channels loginKanal-Authentifizierung (WhatsApp QR etc.)
channels addNeuen Kanal hinzufuegen
channels logsKanal-spezifische Logs anzeigen
channels remove --deleteKanal entfernen (mit Config loeschen)
channels statusKanal-Status ohne aktiven Probe
Agents 7
agents listAlle registrierten Agenten anzeigen
agents list --bindingsAgenten + Kanal-Zuordnungen
agents addNeuen Agenten registrieren
agents deleteAgent entfernen
agents bindingsKanal-Zuordnungen verwalten
agents bind / unbindAgent an Kanal binden / loesen
agents set-identityIDENTITY.md eines Agenten setzen
Logs & Diagnose 7
logs --followLive-Logs (wie tail -f)
logs --json --limit NLetzte N Eintraege als JSON
status --all --deepKompletter System-Check (alle Komponenten)
status --usageToken-Verbrauch der aktiven Session
doctorAutomatischer Gesundheits-Check
doctor --deep --yesDeep-Check mit Auto-Fix
health --jsonHealth-Status als JSON (fuer Monitoring)
Plugins & Skills 12
plugins listInstallierte Plugins anzeigen
plugins info <name>Plugin-Details (Version, Abhaengigkeiten)
plugins enable / disablePlugin aktivieren / deaktivieren
plugins install <name>Plugin installieren
doctor pluginsPlugin-Gesundheits-Check
skills listVerfuegbare Skills anzeigen
skills info <name>Skill-Details
skills checkSkills auf Kompatibilitaet pruefen
skills install / updateSkill installieren / aktualisieren
clawhub search <query>ClawHub nach Skills durchsuchen
clawhub install <name>Skill von ClawHub installieren
clawhub update --allAlle ClawHub-Skills aktualisieren
Sessions & Update 9
sessions cleanupAlte Sessions aufraeumen (Speicher freigeben)
memory search <q>Im Langzeitgedaechtnis suchen
cron listAlle geplanten Aufgaben anzeigen
cron add / rmCron-Jobs erstellen / loeschen
cron enable / disableCron-Jobs aktivieren / deaktivieren
cron run <id>Cron-Job manuell ausfuehren
update --dry-runVerfuegbare Updates anzeigen (ohne installieren)
update --channel stableAuf Stable-Channel aktualisieren
update --channel beta|devAuf Beta/Dev-Channel wechseln
Backup 4
backup createKomplettes Backup erstellen
backup --only-configNur Config sichern (schnell)
backup --no-include-workspaceBackup ohne Workspace-Dateien
backup verifyBackup-Integritaet pruefen
/statusModel, Context, Queue, Runtime, Provider Usage
/new [model]Frische Session starten (Alias: /reset). Spart Kontext-Kosten!
/compact [instr]Kontext zusammenfassen, Tokens freigeben
/stopAktuelle Verarbeitung abbrechen + Queue leeren
/think [level]Denk-Tiefe: off, minimal, low, medium, high, xhigh, adaptive
/model [id]Modell wechseln. Ohne Argument: Liste + aktuelles Modell
/usage [mode]Token-Verbrauch: off, tokens, full, cost
/fastFast Mode Toggle (Anthropic/OpenAI) v2026.3.12
/tts [mode]Text-to-Speech: on, off, always, inbound
/send [mode]Zustellung uebersteuern: on, off, inherit (Owner-only)
/reasoning [mode]Separates Reasoning: on, off, stream
/elevated [mode]Exec-Genehmigungslevel: on, off, ask, full
/whoamiAbsender-Identitaet anzeigen (Alias: /id)
/contextToken-Verbrauch pro Datei (list, detail, json)
/subagentsSub-Agenten verwalten: spawn, list, kill, steer
/export-sessionAktuelle Session als HTML exportieren
/approveAllow-once oder deny fuer Exec-Prompts
/check-updatesUpdate-Zusammenfassung anzeigen
Stop Phrases (NEU in v2026.3.23)
Natuerlichsprachiger Abbruch in 10 Sprachen. Beispiele: "stop openclaw", "please stop", "STOP!", "do not do that", "Hoer auf".
Port-Konflikt (18789 belegt)
Ein anderer Prozess belegt den Gateway-Port.
lsof -i :18789 # Prozess beenden: kill -9 <PID>
Context voll (Token-Limit erreicht)
Kontext zusammenfassen oder neue Session starten.
/compact # Oder komplett neu: /new
Channel down (Kanal offline)
Kanal-Status pruefen und neu verbinden.
openclaw channels status --probe # Telegram neu verbinden: openclaw channels login telegram
WhatsApp-Verbindung reisst ab
QR-Code neu scannen. WhatsApp Web muss auf dem Handy aktiv bleiben.
openclaw channels login whatsapp # QR-Code im Terminal scannen
Config invalid (JSON-Syntaxfehler)
Config-Datei validieren. JSON5 erlaubt Kommentare + Trailing Commas.
openclaw config validate
Auth/Pairing schlaegt fehl
Ab v2026.3.7+: Wenn sowohl Token als auch Passwort gesetzt sind, MUSS gateway.auth.mode explizit auf 'token' oder 'password' stehen.
// In openclaw.json: "gateway": { "auth": { "mode": "token", // EXPLIZIT setzen! "token": "dein-token" } }
Restart-Loop (Gateway startet endlos neu)
Oft ein Config-Problem. Update auf mindestens v2026.2.22+.
docker logs openclaw --tail 50 openclaw config validate openclaw update --channel stable
Disk full (Speicherplatz voll)
Alte Sessions und Docker-Artefakte aufraeumen.
openclaw sessions cleanup docker system prune -f df -h
Container laeuft nicht
Logs pruefen und Container neu starten.
docker logs openclaw --tail 100 docker restart openclaw # Oder komplett: docker compose down && docker compose up -d
Tailscale verbindet nicht
Tailscale-Daemon neu starten und Status pruefen.
sudo tailscale status sudo systemctl restart tailscaled sudo tailscale up