OpenClaw noch nicht installiert? Klicken Sie hier fuer die Ein-Klick-Installationsanleitung
curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Bedenken wegen Auswirkungen auf Ihren Computer? ClawTank laeuft in der Cloud ohne Installation -- kein Risiko versehentlicher Loeschungen
Key Findings
  • Die OpenClaw-CLI verwendet eine konsistente Namensstruktur nach dem Muster openclaw <noun> [subcommand] -- Substantive stehen grundsaetzlich im Plural (models, channels, skills, hooks, agents), und alle Operationen lassen sich ueber das Terminal ausfuehren
  • openclaw doctor ist der wichtigste taegliche Wartungsbefehl -- er erkennt automatisch den Status von Gateway, Channels, Skills, Plugins und Memory; mit --fix werden Probleme automatisch behoben, mit --deep werden Systemdienste gescannt
  • Das Gateway startet standardmaessig unter ws://127.0.0.1:18789 -- verwaltet ueber openclaw gateway (Vordergrund) oder openclaw gateway install (Dienst-Registrierung); alle Channels und Skills kommunizieren ueber diesen WebSocket-Endpunkt
  • Die Modellverwaltung nutzt OAuth / Auth Profiles -- ueber openclaw models auth login wird die OAuth-Autorisierung durchgefuehrt, mit Unterstuetzung fuer kostenlose Modelle wie Qwen und GitHub Copilot sowie automatischer Token-Aktualisierung
  • Die Konfigurationsdatei liegt im JSON-Format vor (~/.openclaw/openclaw.json) -- aenderbar ueber openclaw config get/set/unset mit Dot-Path-Syntax oder ueber openclaw configure im interaktiven Konfigurationsassistenten. Fuer Docker-Deployment siehe den vollstaendigen Docker-Deployment-Leitfaden

Seit der offiziellen Open-Source-Veroeffentlichung Anfang 2026 hat sich OpenClaw rasch zu einem der meistbeachteten AI-Agent-Frameworks entwickelt.[3] Im Gegensatz zu anderen vergleichbaren Tools, die auf Weboberflaechen oder Desktop-Anwendungen setzen, wurde OpenClaw von Anfang an mit der Kommandozeile (CLI) als primaerer Bedienschnittstelle konzipiert -- das macht es von Natur aus geeignet fuer die Integration mit bestehenden DevOps-Toolchains, Shell-Skripten und automatisierten Zeitplaenen.

Dennoch stehen viele Nutzer, die zum ersten Mal mit OpenClaw arbeiten, vor demselben Problem: Die offizielle Dokumentation ist zwar umfassend, aber die Anzahl der Befehle ist enorm (ueber 40 Top-Level-Befehle), und die Flags unterscheiden sich teilweise zwischen den Versionen.[1] Dieser Artikel basiert auf praktischen Tests mit OpenClaw 2026.2.25 und stellt systematisch alle gaengigen Befehle zusammen -- von der Installation bis zur Diagnose, von der Modellverwaltung bis zu Agents -- als verifizierte, vollstaendige Referenz.

1. Uebersicht ueber die Kommandozeile

1.1 Die Designphilosophie der OpenClaw-CLI

Die OpenClaw-CLI basiert auf Node.js (nicht Go) und folgt dem Format openclaw <noun> [subcommand] [flags].[4] Wichtige Namenskonvention: Top-Level-Substantive stehen grundsaetzlich im Plural -- models, channels, skills, hooks, agents, plugins, sessions. Einige Kernbefehle verwenden den Singular (gateway, doctor, config).

1.2 Globale Hilfe und Versionsinformationen

Durch Anfuegen des Flags --help oder -h an einen beliebigen Unterbefehl erhalten Sie die entsprechende Hilfebeschreibung:

# Alle verfuegbaren Top-Level-Befehle mit Kurzbeschreibung anzeigen
openclaw --help

# Hilfe fuer einen bestimmten Unterbefehl anzeigen
openclaw gateway --help
openclaw models --help
openclaw channels add --help

Nach Ausfuehrung von openclaw --help sieht die tatsaechliche Ausgabestruktur wie folgt aus (2026.2.25):

Usage: openclaw [options] [command]

Options:
  --dev                Dev profile: isolate state under ~/.openclaw-dev
  -h, --help           Display help for command
  --log-level <level>  Global log level override (silent|fatal|error|warn|info|debug|trace)
  --no-color           Disable ANSI colors
  --profile <name>     Use a named profile (isolates state/config)
  -V, --version        output the version number

Core Commands:
  gateway *      Run, inspect, and query the WebSocket Gateway
  models *       Discover, scan, and configure models
  channels *     Manage connected chat channels (Telegram, Discord, etc.)
  skills *       List and inspect available skills
  hooks *        Manage internal agent hooks
  plugins *      Manage OpenClaw plugins and extensions
  agents *       Manage isolated agents (workspaces, auth, routing)
  doctor         Health checks + quick fixes
  config *       Non-interactive config helpers (get/set/unset)
  configure      Interactive setup wizard

Utility Commands:
  update *       Update OpenClaw and inspect update channel status
  logs           Tail gateway file logs via RPC
  sessions *     List stored conversation sessions
  browser *      Manage OpenClaw's dedicated browser (Chrome/Chromium)
  cron *         Manage cron jobs via the Gateway scheduler
  security *     Security tools and local config audits
  memory *       Search, inspect, and reindex memory files
  tui            Open a terminal UI connected to the Gateway
  dashboard      Open the Control UI with your current token
  onboard        Interactive onboarding wizard
  status         Show channel health and recent session recipients
  uninstall      Uninstall the gateway service + local data (CLI remains)
  reset          Reset local config/state (keeps the CLI installed)

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

Versionsinformationen abfragen:

# Versionsnummer anzeigen
openclaw --version
# Ausgabe: 2026.2.25

Hinweis: Der Befehl openclaw version existiert nicht. Die Versionsinformationen werden ueber das Flag --version oder -V abgerufen.

1.3 Beschreibung der globalen Flags

Die folgenden Flags koennen auf die Haupt-CLI angewendet werden:

--log-level <level>  Log-Level (silent|fatal|error|warn|info|debug|trace)
--no-color           ANSI-Farbausgabe deaktivieren (geeignet fuer Pipe-Ausgabe und CI-Umgebungen)
--dev                Entwicklungsprofil verwenden, Status wird unter ~/.openclaw-dev isoliert
--profile <name>     Benanntes Profil verwenden, Status wird unter ~/.openclaw-<name> isoliert
-V, --version        Versionsnummer ausgeben
-h, --help           Hilfe anzeigen

2. Installation und Umgebungsverwaltung

2.1 Erstinstallation

OpenClaw bietet drei Installationsmethoden an, die alle intern ueber npm install -g openclaw@latest eine globale Installation durchfuehren:[2]

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

# Windows CMD (umgeht ExecutionPolicy-Einschraenkungen)
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Fuehren Sie nach der Installation Doctor aus, um die Umgebungsbereitschaft zu ueberpruefen:

openclaw doctor

Doctor prueft den Status von Gateway, Skills, Plugins, Channels, Memory Search und meldet eventuelle Probleme.

2.2 Aktualisierung

# Auf die neueste stabile Version aktualisieren
openclaw update

# Update-Kanal wechseln (stable/beta/dev)
openclaw update --channel beta

# Einmalig auf eine bestimmte Version oder einen Dist-Tag aktualisieren
openclaw update --tag 2026.2.20

# Update-Inhalt vorab anzeigen (ohne Ausfuehrung)
openclaw update --dry-run

# Nach dem Update den Gateway-Dienst nicht automatisch neu starten
openclaw update --no-restart

# Nicht-interaktiver Modus (geeignet fuer CI-Umgebungen)
openclaw update --yes --json

# Aktuellen Update-Kanal und Versionsstatus anzeigen
openclaw update status

# Interaktiver Update-Assistent
openclaw update wizard

2.3 Deinstallation und Zuruecksetzen

# Gateway-Dienst und lokale Daten deinstallieren (CLI bleibt erhalten)
openclaw uninstall

# Deinstallation mit Bereinigung aller Einstellungen, Zustaende und Workspaces
openclaw uninstall --all --yes

# Deinstallationsaktionen vorab anzeigen
openclaw uninstall --dry-run

# Nur Dienst/Status/Workspace entfernen
openclaw uninstall --service
openclaw uninstall --state
openclaw uninstall --workspace

# Lokale Konfiguration zuruecksetzen (CLI bleibt erhalten)
openclaw reset
openclaw reset --scope config          # Nur Konfiguration zuruecksetzen
openclaw reset --scope full --yes      # Vollstaendiges Zuruecksetzen (nicht-interaktiv)

2.4 Globale Konfigurationsverwaltung

Die Konfigurationsdatei befindet sich unter ~/.openclaw/openclaw.json (JSON-Format, nicht YAML):

# Bestimmten Konfigurationswert abrufen (Dot-Path-Syntax)
openclaw config get gateway.port
# Ausgabe: 18789

openclaw config get gateway.mode
# Ausgabe: local

# Bestimmten Wert setzen
openclaw config set gateway.port 18790
openclaw config set gateway.bind loopback

# Konfigurationswert entfernen
openclaw config unset gateway.tailscale

# Interaktiven Konfigurationsassistenten starten
openclaw configure

# Konfigurationsassistent fuer bestimmte Abschnitte
openclaw configure --section model
openclaw configure --section web

3. Gateway-Verwaltungsbefehle

3.1 Gateway-Konzept

Das Gateway ist der zentrale WebSocket-Server von OpenClaw. Es empfaengt Nachrichten von Channels unter ws://127.0.0.1:18789, verwaltet Agent-Sessions und koordiniert die Ausfuehrung von Skills.[7] Saemtliche Channel-, Dashboard- und Browser-Steuerung erfolgt ueber das Gateway.

3.2 Starten und Ausfuehren

# Vordergrund-Modus (Stoppen mit Strg+C)
openclaw gateway

# Gleichbedeutend mit
openclaw gateway run

# Port und Bindungsmodus angeben
openclaw gateway --port 18790
openclaw gateway --bind lan        # loopback|lan|tailnet|auto|custom

# Erzwungener Start (beendet den Prozess, der den Port belegt)
openclaw gateway --force

# Gateway-Authentifizierungsmodus
openclaw gateway --auth token --token "your-secret-token"
openclaw gateway --auth password --password "your-password"

# Tailscale-Freigabemodus
openclaw gateway --tailscale serve   # off|serve|funnel

# Ausfuehrlicher Log-Modus
openclaw gateway --verbose
openclaw gateway --compact           # Kompakte WebSocket-Logs

# Entwicklungsmodus (isolierter Status)
openclaw gateway --dev

3.3 Gateway-Dienstverwaltung (Persistierung)

# Als Systemdienst installieren (launchd/systemd/schtasks)
openclaw gateway install

# Installierten Dienst starten
openclaw gateway start

# Dienst stoppen
openclaw gateway stop

# Dienst neu starten
openclaw gateway restart

# Dienst deinstallieren
openclaw gateway uninstall

# Dienststatus anzeigen und Gateway ueberpruefen
openclaw gateway status

Hinweis fuer Windows: openclaw gateway install basiert intern auf schtasks und erfordert Administratorrechte. In Nicht-Administrator-Umgebungen empfiehlt sich der Vordergrund-Modus openclaw gateway.

3.4 Gateway-Statusabfrage

# Vollstaendigen Status anzeigen (Dienst + Sondierung)
openclaw gateway status

# Beispielausgabe (2026.2.25):
# Service: Scheduled Task (missing)
# Config (cli): ~\.openclaw\openclaw.json
# Gateway: bind=loopback (127.0.0.1), port=18789
# Probe target: ws://127.0.0.1:18789
# Dashboard: http://127.0.0.1:18789/
# Listening: 127.0.0.1:18789

# Gateway-Gesundheitsstatus abrufen
openclaw gateway health
# Ausgabe: Gateway Health OK (1693ms)
# Telegram: ok (@your_bot) (1693ms)

# Gateway-Erreichbarkeit sondieren
openclaw gateway probe

# Gateway im lokalen und weiten Netzwerk entdecken
openclaw gateway discover

# Gateway-RPC-Methode direkt aufrufen
openclaw gateway call health

# Nutzungskosten-Zusammenfassung anzeigen
openclaw gateway usage-cost

3.5 Log-Anzeige

# Gateway-Logs anzeigen (ueber RPC)
openclaw logs

# Logs in Echtzeit verfolgen
openclaw logs --follow

# Zeilenanzahl begrenzen
openclaw logs --limit 100

# JSON-Format-Ausgabe
openclaw logs --json

# Lokalzeit-Anzeige
openclaw logs --local-time

# Klartext-Ausgabe (ohne ANSI-Formatierung)
openclaw logs --plain

4. Modellkonfigurationsbefehle

4.1 Modelle auflisten und anzeigen

# Konfigurierte Modelle auflisten
openclaw models list

# Beispielausgabe:
# Model                       Input      Ctx    Local Auth  Tags
# qwen-portal/coder-model     text       125k   no    yes   default,configured
# qwen-portal/vision-model    text+image 125k   no    yes   configured

# Modellstatus-Zusammenfassung anzeigen
openclaw models status

# Beispielausgabe:
# Config        : ~\.openclaw\openclaw.json
# Default       : qwen-portal/coder-model
# Aliases (1)   : qwen -> qwen-portal/coder-model
# Configured models (2): qwen-portal/coder-model, qwen-portal/vision-model

# JSON-Ausgabe
openclaw models --status-json

# Klartext-Ausgabe
openclaw models --status-plain

4.2 Standardmodell festlegen

# Standardmodell festlegen (mit Modell-ID oder Alias)
openclaw models set qwen-portal/coder-model
openclaw models set qwen

# Bildmodell festlegen
openclaw models set-image qwen-portal/vision-model

4.3 Modell-Authentifizierungsverwaltung

# Interaktiv Auth hinzufuegen (Token konfigurieren oder einfuegen)
openclaw models auth add

# OAuth-Autorisierungsablauf durchfuehren
openclaw models auth login

# Bei GitHub Copilot anmelden (Device Code Flow)
openclaw models auth login-github-copilot

# Token manuell einfuegen
openclaw models auth paste-token

# Token ueber Anbieter-CLI einrichten
openclaw models auth setup-token

# Auth-Reihenfolge verwalten
openclaw models auth order

4.4 Modell-Aliase und Fallback

# Modell-Aliase verwalten
openclaw models aliases

# Modell-Fallback-Liste verwalten
openclaw models fallbacks

# Bildmodell-Fallback-Liste verwalten
openclaw models image-fallbacks

# Kostenlose Modelle auf OpenRouter scannen
openclaw models scan

5. Channel-Verwaltungsbefehle

5.1 Unterstuetzte Channels

OpenClaw 2026.2.25 unterstuetzt ueber 20 Kommunikationskanaele: Telegram, WhatsApp, Discord, Slack, Signal, iMessage, IRC, Google Chat, LINE, Zalo, Matrix, Nostr, Microsoft Teams, Mattermost, Nextcloud Talk, BlueBubbles, Synology Chat, Tlon, Feishu und weitere.

5.2 Channel hinzufuegen

# Telegram-Bot hinzufuegen (nicht-interaktiv)
openclaw channels add --channel telegram --token "123456:ABC..."

# Discord-Bot hinzufuegen
openclaw channels add --channel discord --token "MTIz..."

# Slack-App hinzufuegen
openclaw channels add --channel slack --bot-token "xoxb-..." --app-token "xapp-..."

# WhatsApp hinzufuegen (erfordert interaktive QR-Anmeldung)
openclaw channels login --channel whatsapp

# Matrix hinzufuegen
openclaw channels add --channel matrix --homeserver "https://matrix.org" --user-id "@user:matrix.org" --access-token "..."

# Signal hinzufuegen
openclaw channels add --channel signal --signal-number "+49..."

# Mehrere Konten hinzufuegen (mit Account-ID)
openclaw channels add --channel telegram --account work --token "..."

5.3 Channels auflisten und verwalten

# Alle konfigurierten Channels auflisten
openclaw channels list

# Beispielausgabe:
# Chat channels:
# - Telegram default: configured, token=config, enabled
#
# Auth providers (OAuth + API keys):
# - qwen-portal:default (oauth)

# Channel-Status anzeigen (mit Gateway-Sondierung)
openclaw channels status
openclaw channels status --probe     # Aktive Sondierung

# Channel-Logs anzeigen
openclaw channels logs

# Anbieter-Faehigkeiten anzeigen (unterstuetzte Funktionen)
openclaw channels capabilities

# Channel entfernen
openclaw channels remove --channel telegram

# Channel-Session abmelden
openclaw channels logout --channel whatsapp

# Channel-/Benutzernamen in ID aufloesen
openclaw channels resolve

5.4 DM-Pairing-Kopplung

# Ausstehende Kopplungsanfragen anzeigen
openclaw pairing

# Telegram-Kopplung genehmigen
openclaw pairing approve telegram WR8XRQQA

# Pairing-Verwaltung
openclaw pairing --help

6. Skills-Verwaltungsbefehle

6.1 Skills-Konzept

Skills sind der Funktionserweiterungsmechanismus von OpenClaw -- jeder Skill definiert eine bestimmte Faehigkeit, die der AI-Agent ausfuehren kann. Skills sind entweder bundled (integriert) oder ueber Plugins installiert.[5]

6.2 Skills auflisten und ueberpruefen

# Alle verfuegbaren Skills auflisten
openclaw skills list

# Beispielausgabe (Auszug):
# Skills (13/52 ready)
# ┌───────────┬──────────────────┬─────────────────────────────────┬────────────────┐
# │ Status    │ Skill            │ Description                     │ Source         │
# ├───────────┼──────────────────┼─────────────────────────────────┼────────────────┤
# │ ✓ ready   │ 🧩 coding-agent   │ ...                             │ openclaw-bundled│
# │ ✗ missing │ 🔐 1password      │ ...                             │ openclaw-bundled│

# Bereitschaftsstatus der Skills pruefen
openclaw skills check

# Beispielausgabe:
# Skills Status Check
# Total: 52
# ✓ Eligible: 13
# ✗ Missing requirements: 39
#
# Ready to use:
#   🧩 coding-agent
#   ♊️ gemini
#   📦 gh-issues
#   🐙 github
#   ...
#
# Missing requirements:
#   🔐 1password (bins: op)
#   📝 apple-notes (bins: memo; os: darwin)
#   ...

# Detaillierte Informationen zu einem bestimmten Skill anzeigen
openclaw skills info coding-agent

7. Hooks-Befehle

7.1 Hooks-Konzept

Hooks sind der ereignisgesteuerte Automatisierungsmechanismus von OpenClaw -- bei bestimmten Ereignissen werden vordefinierte Aktionen automatisch ausgefuehrt.[6] Beispielsweise speichert session-memory bei /new oder /reset automatisch den Session-Kontext.

7.2 Hooks auflisten und verwalten

# Alle Hooks auflisten
openclaw hooks list

# Beispielausgabe:
# Hooks (4/4 ready)
# ┌──────────┬──────────────────────┬──────────────────────────────────────────┬─────────────┐
# │ Status   │ Hook                 │ Description                              │ Source       │
# ├──────────┼──────────────────────┼──────────────────────────────────────────┼─────────────┤
# │ ✓ ready  │ 🚀 boot-md            │ Run BOOT.md on gateway startup           │ openclaw-bundled│
# │ ✓ ready  │ 📎 bootstrap-extra-files│ Inject additional workspace bootstrap files│ openclaw-bundled│
# │ ✓ ready  │ 📝 command-logger     │ Log all command events to audit file     │ openclaw-bundled│
# │ ✓ ready  │ 💾 session-memory     │ Save session context on /new or /reset   │ openclaw-bundled│

# Detaillierte Informationen zu einem bestimmten Hook anzeigen
openclaw hooks info session-memory

# Hooks-Bereitschaftsstatus pruefen
openclaw hooks check

# Hook aktivieren
openclaw hooks enable session-memory

# Hook deaktivieren
openclaw hooks disable command-logger

# Hook-Pack installieren (Pfad, Archiv oder npm-Paket)
openclaw hooks install ./my-hook-pack
openclaw hooks install some-npm-hook-package

# Installierte Hooks aktualisieren (nur npm-Installation)
openclaw hooks update

8. Plugins-Verwaltungsbefehle

8.1 Plugins auflisten und verwalten

# Alle erkannten Plugins auflisten
openclaw plugins list

# Plugin-Details anzeigen
openclaw plugins info some-plugin

# Plugin installieren (Pfad, Archiv oder npm-Paket)
openclaw plugins install ./my-plugin
openclaw plugins install some-npm-plugin

# Plugin aktivieren/deaktivieren
openclaw plugins enable some-plugin
openclaw plugins disable some-plugin

# Plugin deinstallieren
openclaw plugins uninstall some-plugin

# Installierte Plugins aktualisieren (nur npm-Installation)
openclaw plugins update

# Plugin-Ladeprobleme diagnostizieren
openclaw plugins doctor

9. Agents-Verwaltungsbefehle

9.1 Agents-Konzept

Agents sind die isolierten Ausfuehrungseinheiten von OpenClaw -- jeder Agent verfuegt ueber einen eigenen Workspace, eigene Auth-Einstellungen und eigene Routing-Regeln. Standardmaessig gibt es einen main-Agent.

9.2 Agents verwalten

# Konfigurierte Agents auflisten
openclaw agents list

# Isolierten Agent hinzufuegen
openclaw agents add work

# Agent-Identitaet festlegen (Name/Thema/Emoji/Avatar)
openclaw agents set-identity work --name "Work Bot"

# Agent loeschen und Workspace bereinigen
openclaw agents delete work

10. Diagnose- und Debugging-Befehle

10.1 openclaw doctor

openclaw doctor ist das wichtigste Diagnosetool -- es prueft den Status von Gateway, Channels, Skills, Plugins und Memory Search:

# Umgebungsdiagnose durchfuehren
openclaw doctor

# Automatische Reparatur versuchen
openclaw doctor --fix

# Tiefenscan (einschliesslich Systemdienste)
openclaw doctor --deep

# Gateway-Token generieren und konfigurieren
openclaw doctor --generate-gateway-token

# Nicht-interaktiver Modus (nur sichere Reparaturen)
openclaw doctor --non-interactive

# Bestaetigungsabfragen ueberspringen
openclaw doctor --yes

10.2 Sicherheitsaudit

# Lokales Sicherheitsaudit
openclaw security audit

# Tiefenaudit (einschliesslich Gateway-Sondierung)
openclaw security audit --deep

# Sicherheitsprobleme automatisch beheben
openclaw security audit --fix

# JSON-Ausgabe
openclaw security audit --json

10.3 Weitere nuetzliche Befehle

# Channel-Gesundheitsstatus und letzte Sessions anzeigen
openclaw status

# Dashboard oeffnen (Browser)
openclaw dashboard

# Terminal-TUI oeffnen
openclaw tui

# Memory-Indexstatus anzeigen
openclaw memory status

# Memory-Dateien neu indizieren
openclaw memory index --force

# Memory durchsuchen
openclaw memory search --query "deployment notes"

# Cron-Zeitplanung verwalten
openclaw cron list
openclaw cron add
openclaw cron status

# Sessions anzeigen
openclaw sessions
openclaw sessions --active 120    # In den letzten 2 Stunden aktiv
openclaw sessions --all-agents    # Agent-uebergreifende Aggregation
openclaw sessions --json          # JSON-Ausgabe

# Browser-Steuerung
openclaw browser status
openclaw browser tabs
openclaw browser open https://example.com
openclaw browser screenshot
openclaw browser snapshot

11. Haeufige Probleme und Fehlerbehebung

11.1 Haeufige Fehler bei Befehlsnamen

Problem: Die Ausfuehrung von openclaw version, openclaw model, openclaw channel usw. fuehrt zu unknown command.

# Falsch:
openclaw version        # ✗ unknown command
openclaw model list     # ✗ unknown command (Did you mean models?)
openclaw channel list   # ✗ unknown command (Did you mean channels?)
openclaw skill list     # ✗ unknown command (Did you mean skills?)
openclaw hook list      # ✗ unknown command (Did you mean hooks?)

# Richtig:
openclaw --version      # ✓ Verwenden Sie das Flag, nicht den Unterbefehl
openclaw models list    # ✓ Pluralform
openclaw channels list  # ✓ Pluralform
openclaw skills list    # ✓ Pluralform
openclaw hooks list     # ✓ Pluralform

11.2 Gateway laesst sich nicht starten

Problem: openclaw gateway zeigt bind: address already in use.

# Loesung 1: Erzwungener Start (beendet den blockierenden Prozess)
openclaw gateway --force

# Loesung 2: Port wechseln
openclaw gateway --port 18790
openclaw config set gateway.port 18790

# Loesung 3: Blockierenden Prozess identifizieren
netstat -ano | findstr :18789   # Windows
lsof -i :18789                  # macOS/Linux

Problem: openclaw gateway install schlaegt unter Windows fehl (Access denied).

# Gateway-Dienstinstallation erfordert Administratorrechte (schtasks)
# Loesung 1: PowerShell als Administrator ausfuehren
# Loesung 2: Vordergrund-Modus verwenden
openclaw gateway

11.3 Speicherort der Konfigurationsdatei

# OpenClaw-Konfigurationsdatei (JSON-Format)
~/.openclaw/openclaw.json

# Vollstaendiger Pfad unter Windows
C:\Users\<BENUTZERNAME>\.openclaw\openclaw.json

# Agent-Workspace
~/.openclaw/agents/main/

# Auth Profiles
~/.openclaw/agents/main/agent/auth-profiles.json

# Gateway-Logs
/tmp/openclaw/openclaw-YYYY-MM-DD.log     # macOS/Linux
\tmp\openclaw\openclaw-YYYY-MM-DD.log     # Windows

11.4 Technischen Support erhalten

# Vollstaendige Diagnose durchfuehren
openclaw doctor --deep

# Versionsinformationen anzeigen
openclaw --version

# Gateway-Status anzeigen
openclaw gateway status

# Vollstaendigen Gesundheitsstatus anzeigen
openclaw gateway health

# Offizielle Dokumentation durchsuchen
openclaw docs

Fazit

Die CLI von OpenClaw 2026.2.25 bietet ueber 40 Top-Level-Befehle, die Gateway-Verwaltung, Modellkonfiguration, Channel-Integration, Skills-/Hooks-/Plugins-Verwaltung, Sicherheitsaudits, Cron-Zeitplanung, Browser-Steuerung und weitere vollstaendige Funktionen abdecken.[8] Die Beherrschung einiger Kernbefehle -- openclaw doctor, openclaw gateway, openclaw models status, openclaw channels list -- genuegt, um den taeglichen Betrieb abzudecken.

Alle Befehle in diesem Artikel wurden mit OpenClaw 2026.2.25 in einer Windows-11-Umgebung praktisch verifiziert. Mit der Weiterentwicklung der Versionen koennen sich Flags oder Ausgabeformate einzelner Befehle aendern. Es empfiehlt sich, das Flag --help fuer die jeweils aktuelle Syntax zu nutzen und regelmaessig openclaw doctor auszufuehren, um die Gesundheit der Umgebung sicherzustellen.[1]