OpenClaw CLI Referenz

Befehlsübersicht

• setup
• onboard
• configure
• config
• completion
• doctor
• dashboard
• backup
• reset
• uninstall
• update
• message
• agent
• agents
• acp
• mcp
• status
• health
• sessions
• gateway
• logs
• system
• models
• infer
• memory
• wiki
• directory
• nodes
• devices
• node
• approvals
• sandbox
• tui
• browser
• cron
• tasks
• flows
• dns
• docs
• hooks
• webhooks
• pairing
• qr
• plugins (Plugin-Befehle)
• channels
• security
• secrets
• skills
• daemon (Legacy-Alias für Gateway-Service-Befehle)
• clawbot (Legacy-Alias-Namespace)
• voicecall (Plugin; falls installiert)

Globale Flags

• --dev: Isoliert den Status unter ~/.openclaw-dev und verschiebt die Standard-Ports.
• --profile <name>: Isoliert den Status unter ~/.openclaw-<name>.
• --container <name>: Wählt einen benannten Container für die Ausführung aus.
• --no-color: Deaktiviert ANSI-Farben.
• --update: Shortcut für openclaw update (nur bei Installationen aus dem Source-Code).
• -V, --version, -v: Zeigt die Version an und beendet den Prozess.

Ausgabe-Styling

• ANSI-Farben und Fortschrittsanzeigen werden nur in TTY-Sessions gerendert.
• OSC-8 Hyperlinks werden in unterstützten Terminals als klickbare Links angezeigt; ansonsten nutzen wir einfache URLs.
• --json (und --plain, falls unterstützt) deaktiviert das Styling für eine saubere Ausgabe.
• --no-color deaktiviert das ANSI-Styling; NO_COLOR=1 wird ebenfalls beachtet.
• Befehle mit langer Laufzeit zeigen eine Fortschrittsanzeige (OSC 9;4, sofern unterstützt).

Farbpalette

OpenClaw nutzt eine “Lobster”-Palette für die CLI-Ausgabe.

• accent (#FF5A2D): Überschriften, Labels, primäre Highlights.
• accentBright (#FF7A3D): Befehlsnamen, Betonungen.
• accentDim (#D14A22): Sekundäre Highlight-Texte.
• info (#FF8A5B): Informationswerte.
• success (#2FBF71): Erfolgsstatus.
• warn (#FFB020): Warnungen, Fallbacks, Aufmerksamkeit.
• error (#E23D2D): Fehler, Fehlschläge.
• muted (#8B7F77): De-Emphasis, Metadaten.

Source of Truth für die Palette: src/terminal/palette.ts (die „Lobster-Palette“).

Befehlsstruktur

openclaw [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
    file
    schema
    validate
  completion
  doctor
  dashboard
  backup
    create
    verify
  security
    audit
  secrets
    reload
    audit
    configure
    apply
  reset
  uninstall
  update
    wizard
    status
  channels
    list
    status
    capabilities
    resolve
    logs
    add
    remove
    login
    logout
  directory
    self
    peers list
    groups list|members
  skills
    search
    install
    update
    list
    info
    check
  plugins
    list
    inspect
    install
    uninstall
    update
    enable
    disable
    doctor
    marketplace list
  memory
    status
    index
    search
  wiki
    status
    doctor
    init
    ingest
    compile
    lint
    search
    get
    apply
    bridge import
    unsafe-local import
    obsidian status|search|open|command|daily
  message
    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
    ban
  agent
  agents
    list
    add
    delete
    bindings
    bind
    unbind
    set-identity
  acp
  mcp
    serve
    list
    show
    set
    unset
  status
  health
  sessions
    cleanup
  tasks
    list
    audit
    maintenance
    show
    notify
    cancel
    flow list|show|cancel
  gateway
    call
    usage-cost
    health
    status
    probe
    discover
    install
    uninstall
    start
    stop
    restart
    run
  daemon
    status
    install
    uninstall
    start
    stop
    restart
  logs
  system
    event
    heartbeat last|enable|disable
    presence
  models
    list
    status
    set
    set-image
    aliases list|add|remove
    fallbacks list|add|remove|clear
    image-fallbacks list|add|remove|clear
    scan
  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|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|clear
  sandbox
    list
    recreate
    explain
  cron
    status
    list
    add
    edit
    rm
    enable
    disable
    runs
    run
  nodes
    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 get
  devices
    list
    remove
    clear
    approve
    reject
    rotate
    revoke
  node
    run
    status
    install
    uninstall
    stop
    restart
  approvals
    get
    set
    allowlist add|remove
  browser
    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
    pdf
  hooks
    list
    info
    check
    enable
    disable
    install
    update
  webhooks
    gmail setup|run
  pairing
    list
    approve
  qr
  clawbot
    qr
  docs
  dns
    setup
  tui

Hinweis: Plugins können zusätzliche Top-Level-Commands hinzufügen (zum Beispiel openclaw voicecall).

Sicherheit

• openclaw security audit — prüft die Config und den lokalen Status auf typische Sicherheitsrisiken.
• openclaw security audit --deep — führt einen best-effort Live-Gateway-Probe durch.
• openclaw security audit --fix — verschärft Sicherheits-Defaults sowie Berechtigungen für Status und Config.

Secrets

secrets

Verwalte SecretRefs sowie die allgemeine Hygiene für Runtime und Config.

Subcommands:

• secrets reload
• secrets audit
• secrets configure
• secrets apply --from <path>

Optionen für secrets reload:

• --url, --token, --timeout, --expect-final, --json

Optionen für secrets audit:

• --check
• --allow-exec
• --json

Optionen für secrets configure:

• --apply
• --yes
• --providers-only
• --skip-provider-setup
• --agent <id>
• --allow-exec
• --plan-out <path>
• --json

Optionen für secrets apply --from <path>:

• --dry-run
• --allow-exec
• --json

Anmerkungen:

• reload ist ein Gateway RPC und behält den letzten bekannten funktionierenden Runtime-Snapshot, falls die Auflösung fehlschlägt.
• audit --check gibt bei Funden einen Wert ungleich Null zurück; nicht aufgelöste Referenzen nutzen einen höher priorisierten Exit-Code.
• Checks für Dry-run-Executions werden standardmäßig übersprungen; nutze --allow-exec, um sie zu aktivieren.

Plugins

Verwalte Extensions und deren Config:

• openclaw plugins list — entdecke Plugins (nutze --json für maschinenlesbaren Output).
• openclaw plugins inspect <id> — zeigt Details zu einem Plugin (info ist ein Alias).
• openclaw plugins install <path|.tgz|npm-spec|plugin@marketplace> — installiert ein Plugin (oder fügt einen Plugin-Pfad zu plugins.load.paths hinzu; nutze --force, um ein bestehendes Ziel zu überschreiben).
• openclaw plugins marketplace list <marketplace> — listet Marketplace-Einträge vor der Installation auf.
• openclaw plugins enable <id> / disable <id> — schaltet plugins.entries.<id>.enabled um.
• openclaw plugins doctor — meldet Fehler beim Laden von Plugins.

Die meisten Plugin-Änderungen erfordern einen Gateway-Restart. Schau dir dazu /plugin an.

Memory

Vektorsuche über MEMORY.md + memory/*.md:

• openclaw memory status — zeigt Index-Statistiken; nutze --deep für Vector + Embedding Readiness-Checks oder --fix, um veraltete Recall/Promotion-Artefakte zu reparieren.
• openclaw memory index — Memory-Dateien neu indizieren.
• openclaw memory search "<query>" (oder --query "<query>") — semantische Suche im Memory.
• openclaw memory promote — bewertet Kurzzeit-Recalls und hängt optional die besten Einträge an MEMORY.md an.

Sandbox

Verwalte Sandbox-Runtimes für die isolierte Ausführung von Agenten. Siehe /cli/sandbox.

Sub-Befehle:

• sandbox list [--browser] [--json]
• sandbox recreate [--all] [--session <key>] [--agent <id>] [--browser] [--force]
• sandbox explain [--session <key>] [--agent <id>] [--json]

Hinweise:

• sandbox recreate entfernt bestehende Runtimes, damit sie bei der nächsten Nutzung mit der aktuellen Config neu erstellt werden.
• Für ssh und OpenShell remote Backends löscht recreate den kanonischen Remote-Workspace für den gewählten Scope.

Chat Slash-Befehle

Chat-Nachrichten unterstützen /... Befehle (Text und nativ). Siehe /tools/slash-commands.

Highlights:

• /status für schnelle Diagnosen.
• /config für dauerhafte Konfigurationsänderungen.
• /debug für Runtime-Overrides der Config (nur im Memory, nicht auf der Disk; erfordert commands.debug: true).

Setup + Onboarding

completion

Erstelle Shell-Completion-Skripte und installiere sie optional in deinem Shell-Profil.

Optionen:

• -s, --shell <zsh|bash|powershell|fish>
• -i, --install
• --write-state
• -y, --yes

Hinweise:

• Ohne --install oder --write-state gibt completion das Skript in der Standardausgabe (stdout) aus.
• --install schreibt einen OpenClaw Completion Block in dein Shell-Profil und verweist auf das gecachte Skript im OpenClaw State-Verzeichnis.

setup

Initialisiere Config + Workspace.

Optionen:

• --workspace <dir>: Pfad zum Agent-Workspace (Standard: ~/.openclaw/workspace).
• --wizard: Onboarding starten.
• --non-interactive: Onboarding ohne Abfragen ausführen.
• --mode <local|remote>: Onboarding-Modus.
• --remote-url <url>: Remote Gateway-URL.
• --remote-token <token>: Remote Gateway-Token.

Das Onboarding startet automatisch, wenn Onboarding-Flags wie --non-interactive, --mode, --remote-url oder --remote-token vorhanden sind.

onboard

Interaktives Onboarding für Gateway, Workspace und Skills.

Optionen:

• --workspace <dir>
• --reset (setzt Config, Credentials und Sessions vor dem Onboarding zurück)
• --reset-scope <config|config+creds+sessions|full> (Standard: config+creds+sessions; nutze full, um auch den Workspace zu löschen)
• --non-interactive
• --mode <local|remote>
• --flow <quickstart|advanced|manual> (manual ist ein Alias für advanced)
• --auth-choice <choice> wobei <choice> einer der folgenden Werte ist: chutes, deepseek-api-key, openai-codex, openai-api-key, openrouter-api-key, kilocode-api-key, litellm-api-key, ai-gateway-api-key, cloudflare-ai-gateway-api-key, moonshot-api-key, moonshot-api-key-cn, kimi-code-api-key, synthetic-api-key, venice-api-key, together-api-key, huggingface-api-key, apiKey, gemini-api-key, google-gemini-cli, zai-api-key, zai-coding-global, zai-coding-cn, zai-global, zai-cn, xiaomi-api-key, minimax-global-oauth, minimax-global-api, minimax-cn-oauth, minimax-cn-api, opencode-zen, opencode-go, github-copilot, copilot-proxy, xai-api-key, mistral-api-key, volcengine-api-key, byteplus-api-key, qianfan-api-key, qwen-standard-api-key-cn, qwen-standard-api-key, qwen-api-key-cn, qwen-api-key, modelstudio-standard-api-key-cn, modelstudio-standard-api-key, modelstudio-api-key-cn, modelstudio-api-key, custom-api-key, skip
• Hinweis zu Qwen: qwen-* ist die kanonische auth-choice Familie. modelstudio-* IDs werden nur noch als Legacy-Kompatibilitäts-Aliase akzeptiert.
• --secret-input-mode <plaintext|ref> (Standard: plaintext; nutze ref, um Provider-Default-Env-Refs statt Plaintext-Keys zu speichern)
• --anthropic-api-key <key>
• --openai-api-key <key>
• --mistral-api-key <key>
• --openrouter-api-key <key>
• --ai-gateway-api-key <key>
• --moonshot-api-key <key>
• --kimi-code-api-key <key>
• --gemini-api-key <key>
• --zai-api-key <key>
• --minimax-api-key <key>
• --opencode-zen-api-key <key>
• --opencode-go-api-key <key>
• --custom-base-url <url> (nicht-interaktiv; genutzt mit --auth-choice custom-api-key)
• --custom-model-id <id> (nicht-interaktiv; genutzt mit --auth-choice custom-api-key)
• --custom-api-key <key> (nicht-interaktiv; optional; genutzt mit --auth-choice custom-api-key; nutzt CUSTOM_API_KEY, falls weggelassen)
• --custom-provider-id <id> (nicht-interaktiv; optionale Custom Provider ID)
• --custom-compatibility <openai|anthropic> (nicht-interaktiv; optional; Standard: openai)
• --gateway-port <port>
• --gateway-bind <loopback|lan|tailnet|auto|custom>
• --gateway-auth <token|password>
• --gateway-token <token>
• --gateway-token-ref-env <name> (nicht-interaktiv; speichert gateway.auth.token als Env-SecretRef; erfordert, dass die Env-Variable gesetzt ist; nicht kombinierbar mit --gateway-token)
• --gateway-password <password>
• --remote-url <url>
• --remote-token <token>
• --tailscale <off|serve|funnel>
• --tailscale-reset-on-exit
• --install-daemon
• --no-install-daemon (Alias: --skip-daemon)
• --daemon-runtime <node|bun>
• --skip-channels
• --skip-skills
• --skip-search
• --skip-health
• --skip-ui
• --cloudflare-ai-gateway-account-id <id>
• --cloudflare-ai-gateway-gateway-id <id>
• --node-manager <npm|pnpm|bun> (Node-Manager für Skills; pnpm empfohlen, bun wird ebenfalls unterstützt)
• --json

configure

Interaktiver Konfigurations-Wizard (Modelle, Channels, Skills und Gateway).

Optionen:

• --section <section> (wiederholbar; beschränkt den Wizard auf bestimmte Abschnitte)

config

Nicht-interaktive Config-Helfer (get/set/unset/file/schema/validate). Wenn du openclaw config ohne Sub-Befehl ausführst, startet der Wizard.

Sub-Befehle:

• config get <path>: gibt einen Config-Wert aus (Dot/Bracket-Pfad).
• config set: unterstützt vier Zuweisungsmodi:
  • Value-Modus: config set <path> <value> (JSON5- oder String-Parsing)
  • SecretRef-Builder-Modus: config set <path> --ref-provider <provider> --ref-source <source> --ref-id <id>
  • Provider-Builder-Modus: config set secrets.providers.<alias> --provider-source <env|file|exec> ...
  • Batch-Modus: config set --batch-json '<json>' oder config set --batch-file <path>
• config set --dry-run: validiert Zuweisungen, ohne openclaw.json zu schreiben (exec SecretRef-Checks werden standardmäßig übersprungen).
• config set --allow-exec --dry-run: aktiviert exec SecretRef Dry-Run-Checks (kann Provider-Befehle ausführen).
• config set --dry-run --json: gibt maschinenlesbare Dry-Run-Ergebnisse aus (Checks, Vollständigkeit, Operationen sowie Fehler).
• config set --strict-json: erfordert JSON5-Parsing für Pfad/Wert-Eingaben. --json bleibt ein Legacy-Alias für striktes Parsing außerhalb des Dry-Run-Modus.
• config unset <path>: entfernt einen Wert.
• config file: gibt den Pfad der aktiven Config-Datei aus.
• config schema: gibt das generierte JSON-Schema für openclaw.json aus, inklusive Metadaten für title / description über verschachtelte Objekte, Wildcards und Arrays hinweg, plus Best-Effort Metadaten für Plugins/Channels.
• config validate: validiert die aktuelle Config gegen das Schema, ohne das Gateway zu starten.
• config validate --json: gibt maschinenlesbare JSON-Daten aus.

doctor

Health-Checks + schnelle Fehlerbehebung (Config, Gateway und Legacy-Dienste).

Optionen:

• --no-workspace-suggestions: deaktiviert Workspace-Memory-Hinweise.
• --yes: akzeptiert Standardwerte ohne Nachfrage (headless).
• --non-interactive: überspringt Abfragen; wendet nur sichere Migrationen an.
• --deep: scannt Systemdienste nach zusätzlichen Gateway-Installationen.
• --repair (Alias: --fix): versucht automatische Reparaturen für erkannte Probleme.
• --force: erzwingt Reparaturen, auch wenn sie nicht zwingend erforderlich sind.
• --generate-gateway-token: generiert ein neues Gateway-Auth-Token.

dashboard

Öffnet das Control UI mit deinem aktuellen Token.

Optionen:

• --no-open: gibt die URL aus, öffnet aber keinen Browser.

Hinweise:

• Bei Gateway-Tokens, die über SecretRef verwaltet werden, gibt dashboard eine URL ohne Token aus oder öffnet diese, um das Geheimnis nicht in der Terminal-Ausgabe oder den Browser-Argumenten zu exponieren.

update

Aktualisiert die installierte CLI.

Root-Optionen:

• --json
• --no-restart
• --dry-run
• --channel <stable|beta|dev>
• --tag <dist-tag|version|spec>
• --timeout <seconds>
• --yes

Sub-Befehle:

• update status
• update wizard

update status Optionen:

• --json
• --timeout <seconds>

update wizard Optionen:

• --timeout <seconds>

Hinweise:

• openclaw --update wird intern zu openclaw update umgeschrieben.

backup

Erstelle und verifiziere lokale Backup-Archive für den OpenClaw-Status.

Sub-Befehle:

• backup create
• backup verify <archive>

backup create Optionen:

• --output <path>
• --json
• --dry-run
• --verify
• --only-config
• --no-include-workspace

backup verify <archive> Optionen:

• --json

AI Setup Assistant

Channel-Helfer

channels

Verwalte deine Chat-Kanal-Accounts (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/Signal/iMessage/Microsoft Teams).

Unterbefehle:

• channels list: Zeigt konfigurierte Kanäle und Auth-Profile an.
• channels status: Prüft die Erreichbarkeit des Gateways und den Zustand der Kanäle (--probe führt Live-Prüfungen pro Account durch, wenn das Gateway erreichbar ist; falls nicht, werden nur Konfigurationszusammenfassungen angezeigt. Nutze openclaw health oder openclaw status --deep für umfassendere Gateway-Prüfungen).
• Tipp: channels status gibt Warnungen mit Lösungsvorschlägen aus, wenn häufige Fehlkonfigurationen erkannt werden (und verweist dich dann auf openclaw doctor).
• channels logs: Zeigt aktuelle Kanal-Logs aus der Gateway-Logdatei an.
• channels add: Startet einen Setup-Assistenten, wenn keine Flags übergeben werden; Flags wechseln in den nicht-interaktiven Modus.
  • Wenn du einen Nicht-Standard-Account zu einem Kanal hinzufügst, der noch eine Single-Account-Konfiguration nutzt, verschiebt OpenClaw die Account-Werte in die Map der Kanal-Accounts, bevor der neue Account geschrieben wird. Die meisten Kanäle nutzen accounts.default; Matrix kann stattdessen ein bestehendes passendes Ziel beibehalten.
  • Ein nicht-interaktives channels add erstellt oder aktualisiert Bindings nicht automatisch; kanalbezogene Bindings passen weiterhin zum Standard-Account.
• channels remove: Standardmäßig deaktiviert; nutze --delete, um Konfigurationseinträge ohne Rückfrage zu entfernen.
• channels login: Interaktiver Kanal-Login (nur für WhatsApp Web).
• channels logout: Meldet dich von einer Kanal-Session ab (sofern unterstützt).

Gemeinsame Optionen:

• --channel <name>: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
• --account <id>: ID des Kanal-Accounts (Standard ist default)
• --name <label>: Anzeigename für den Account

Optionen für channels login:

• --channel <channel> (Standard ist whatsapp; unterstützt whatsapp/web)
• --account <id>
• --verbose

Optionen für channels logout:

• --channel <channel> (Standard ist whatsapp)
• --account <id>

Optionen für channels list:

• --no-usage: Überspringt Snapshots zur Nutzung/Quota von Model-Providern (nur für OAuth/API-basierte Accounts).
• --json: Ausgabe als JSON (enthält die Nutzung, sofern --no-usage nicht gesetzt ist).

Optionen für channels status:

• --probe
• --timeout <ms>
• --json

Optionen für channels capabilities:

• --channel <name>
• --account <id> (nur zusammen mit --channel)
• --target <dest>
• --timeout <ms>
• --json

Optionen für channels resolve:

• <entries...>
• --channel <name>
• --account <id>
• --kind <auto|user|group>
• --json

Optionen für channels logs:

• --channel <name|all> (Standard ist all)
• --lines <n> (Standard ist 200)
• --json

Hinweise:

• channels login unterstützt --verbose.
• channels capabilities --account gilt nur, wenn --channel gesetzt ist.
• channels status --probe kann den Transport-Status sowie Ergebnisse wie works, probe failed, audit ok oder audit failed anzeigen, je nach Unterstützung des Kanals.

Mehr Details findest du unter: /concepts/oauth

Beispiele:

openclaw channels add --channel telegram --account alerts --name "Alerts Bot" --token $TELEGRAM_BOT_TOKEN
openclaw channels add --channel discord --account work --name "Work Bot" --token $DISCORD_BOT_TOKEN
openclaw channels remove --channel discord --account work --delete
openclaw channels status --probe
openclaw status --deep

directory

Suche nach eigenen IDs, Peer-IDs und Gruppen-IDs für Kanäle, die ein Directory bereitstellen. Siehe openclaw directory.

Gemeinsame Optionen:

• --channel <name>
• --account <id>
• --json

Unterbefehle:

• directory self
• directory peers list [--query <text>] [--limit <n>]
• directory groups list [--query <text>] [--limit <n>]
• directory groups members --group-id <id> [--limit <n>]

skills

Liste verfügbare Skills auf und prüfe deren Status sowie Anforderungen.

Unterbefehle:

• skills search [query...]: Durchsuche ClawHub-Skills.
• skills search --limit <n> --json: Begrenze Suchergebnisse oder gib maschinenlesbaren Output aus.
• skills install <slug>: Installiere einen Skill von ClawHub in den aktiven Workspace.
• skills install <slug> --version <version>: Installiere eine spezifische ClawHub-Version.
• skills install <slug> --force: Überschreibe einen existierenden Skill-Ordner im Workspace.
• skills update <slug|--all>: Aktualisiere getrackte ClawHub-Skills.
• skills list: Liste Skills auf (Standard, wenn kein Unterbefehl angegeben wird).
• skills list --json: Gibt das Skill-Inventar als JSON auf stdout aus.
• skills list --verbose: Zeigt fehlende Anforderungen in der Tabelle an.
• skills info <name>: Zeigt Details zu einem Skill an.
• skills info <name> --json: Gibt Details als JSON auf stdout aus.
• skills check: Zusammenfassung von bereiten vs. fehlenden Anforderungen.
• skills check --json: Gibt den Status der Einsatzbereitschaft als JSON auf stdout aus.

Optionen:

• --eligible: Zeige nur einsatzbereite Skills an.
• --json: JSON-Ausgabe (ohne Styling).
• -v, --verbose: Enthält Details zu fehlenden Anforderungen.

Tipp: Nutze openclaw skills search, openclaw skills install und openclaw skills update für Skills, die über ClawHub bereitgestellt werden.

pairing

Bestätige DM-Pairing-Anfragen über verschiedene Kanäle hinweg.

Unterbefehle:

• pairing list [channel] [--channel <channel>] [--account <id>] [--json]
• pairing approve <channel> <code> [--account <id>] [--notify]
• pairing approve --channel <channel> [--account <id>] <code> [--notify]

Hinweise:

• Wenn genau ein Pairing-fähiger Kanal konfiguriert ist, ist auch pairing approve <code> zulässig.
• Sowohl list als auch approve unterstützen --account <id> für Kanäle mit mehreren Accounts.

devices

Verwalte Gateway-Device-Pairings und Device-Tokens pro Rolle.

Unterbefehle:

• devices list [--json]
• devices approve [requestId] [--latest]
• devices reject <requestId>
• devices remove <deviceId>
• devices clear --yes [--pending]
• devices rotate --device <id> --role <role> [--scope <scope...>]
• devices revoke --device <id> --role <role>

Hinweise:

• devices list und devices approve können auf lokale Pairing-Dateien via Loopback zurückgreifen, wenn kein direkter Pairing-Scope verfügbar ist.
• devices approve erfordert eine explizite Request-ID, bevor Tokens erstellt werden; ohne requestId oder mit --latest wird nur eine Vorschau der neuesten ausstehenden Anfrage angezeigt.
• Reconnects mit gespeicherten Tokens nutzen die gecachten Scopes; ein explizites devices rotate --scope ... aktualisiert diesen gespeicherten Scope-Satz für zukünftige Reconnects.
• devices rotate und devices revoke geben JSON-Daten zurück.

qr

Erstelle einen mobilen Pairing-QR-Code und einen Setup-Code aus der aktuellen Gateway-Konfiguration. Siehe openclaw qr.

Optionen:

• --remote
• --url <url>
• --public-url <url>
• --token <token>
• --password <password>
• --setup-code-only
• --no-ascii
• --json

Hinweise:

• --token und --password schließen sich gegenseitig aus.
• Der Setup-Code enthält einen kurzlebigen Bootstrap-Token, nicht den geteilten Gateway-Token oder das Passwort.
• Die integrierte Bootstrap-Übergabe belässt den primären Node-Token bei scopes: [].
• Jeder übergebene Operator-Bootstrap-Token bleibt auf operator.approvals, operator.read, operator.talk.secrets und operator.write beschränkt.
• Bootstrap-Scope-Prüfungen sind rollenbasiert, sodass die Operator-Allowlist nur Operator-Anfragen bedient; andere Rollen benötigen weiterhin Scopes unter ihrem eigenen Präfix.
• --remote kann gateway.remote.url oder die aktive Tailscale Serve/Funnel URL nutzen.
• Nach dem Scannen bestätigst du die Anfrage mit openclaw devices list / openclaw devices approve <requestId>.

clawbot

Legacy-Alias-Namespace. Unterstützt derzeit openclaw clawbot qr, was auf openclaw qr verweist.

hooks

Verwalte interne Agent-Hooks.

Unterbefehle:

• hooks list
• hooks info <name>
• hooks check
• hooks enable <name>
• hooks disable <name>
• hooks install <path-or-spec> (veralteter Alias für openclaw plugins install)
• hooks update [id] (veralteter Alias für openclaw plugins update)

Gemeinsame Optionen:

• --json
• --eligible
• -v, --verbose

Hinweise:

• Über Plugins verwaltete Hooks können nicht direkt über openclaw hooks aktiviert oder deaktiviert werden; aktiviere oder deaktiviere stattdessen das zugehörige Plugin.
• hooks install und hooks update funktionieren weiterhin als Kompatibilitäts-Aliase, geben jedoch eine Warnung aus und leiten an die Plugin-Befehle weiter.

webhooks

Hilfsprogramme für Webhooks. Die aktuell integrierte Funktion ist das Gmail Pub/Sub Setup inklusive Runner:

• webhooks gmail setup
• webhooks gmail run

webhooks gmail

Setup und Runner für Gmail Pub/Sub Hooks. Siehe Gmail Pub/Sub.

Unterbefehle:

• webhooks gmail setup (erfordert --account <email>; unterstützt --project, --topic, --subscription, --label, --hook-url, --hook-token, --push-token, --bind, --port, --path, --include-body, --max-bytes, --renew-minutes, --tailscale, --tailscale-path, --tailscale-target, --push-endpoint, --json)
• webhooks gmail run (Runtime-Overrides für dieselben Flags)

Hinweise:

• setup konfiguriert den Gmail-Watch sowie den Push-Pfad in Richtung OpenClaw.
• run startet den lokalen Gmail-Watcher und den Erneuerungs-Loop mit optionalen Overrides.

dns

DNS-Hilfsprogramme für Wide-Area Discovery (CoreDNS + Tailscale). Aktuelle Funktionen:

• dns setup [--domain <domain>] [--apply]

dns setup

DNS-Hilfsprogramm für Wide-Area Discovery (CoreDNS + Tailscale). Siehe /gateway/discovery.

Optionen:

• --domain <domain>
• --apply: Installiert oder aktualisiert die CoreDNS-Konfiguration (erfordert sudo; nur macOS).

Hinweise:

• Ohne --apply dient dies als Planungshilfe und gibt die empfohlene OpenClaw + Tailscale DNS-Konfiguration aus.
• --apply unterstützt derzeit nur macOS mit Homebrew CoreDNS.

Messaging + Agent

message

Einheitliches Messaging für ausgehende Nachrichten und Kanal-Aktionen.

Siehe: /cli/message

Unterbefehle:

• message send|poll|react|reactions|read|edit|delete|pin|unpin|pins|permissions|search|timeout|kick|ban
• message thread <create|list|reply>
• message emoji <list|upload>
• message sticker <send|upload>
• message role <info|add|remove>
• message channel <info|list>
• message member info
• message voice status
• message event <list|create>

Beispiele:

• openclaw message send --target +15555550123 --message "Hi"
• openclaw message poll --channel discord --target channel:123 --poll-question "Snack?" --poll-option Pizza --poll-option Sushi

agent

Führe einen Agent-Turn über das Gateway aus (oder lokal eingebettet mit --local).

Übergib mindestens einen Session-Selektor: --to, --session-id oder --agent.

Erforderlich:

• -m, --message <text>

Optionen:

• -t, --to <dest> (für den Session-Key und optionale Zustellung)
• --session-id <id>
• --agent <id> (Agent-ID; überschreibt Routing-Bindings)
• --thinking <off|minimal|low|medium|high|xhigh> (Unterstützung variiert je nach Provider)
• --verbose <on|off>
• --channel <channel> (Zustellungskanal; weglassen, um den Hauptkanal der Session zu nutzen)
• --reply-to <target> (Override für das Zustellungsziel, getrennt vom Session-Routing)
• --reply-channel <channel> (Override für den Zustellungskanal)
• --reply-account <id> (Override für die Zustellungs-Account-ID)
• --local (Eingebetteter Lauf; Plugin-Registry wird dennoch zuerst geladen)
• --deliver
• --json
• --timeout <seconds>

Hinweise:

• Der Gateway-Modus nutzt den eingebetteten Agent als Fallback, wenn die Gateway-Anfrage fehlschlägt.
• --local lädt weiterhin die Plugin-Registry, sodass Provider, Tools und Kanäle aus Plugins auch lokal verfügbar bleiben.
• --channel, --reply-channel und --reply-account beeinflussen die Zustellung der Antwort, nicht das Routing.

agents

Verwalte isolierte Agents (Workspaces + Auth + Routing).

Das Ausführen von openclaw agents ohne Unterbefehl entspricht openclaw agents list.

agents list

Liste alle konfigurierten Agents auf.

Optionen:

• --json
• --bindings

agents add [name]

Füge einen neuen isolierten Agent hinzu. Startet den Assistenten, sofern keine Flags (oder --non-interactive) übergeben werden; --workspace ist im nicht-interaktiven Modus erforderlich.

Optionen:

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (wiederholbar)
• --non-interactive
• --json

Binding-Spezifikationen nutzen das Format channel[:accountId]. Wenn accountId fehlt, versucht OpenClaw den Account-Scope über Kanal-Standards oder Plugin-Hooks aufzulösen. main ist reserviert und kann nicht als ID für einen neuen Agent genutzt werden.

agents bindings

Liste Routing-Bindings auf.

Optionen:

• --agent <id>
• --json

agents bind

Füge Routing-Bindings für einen Agent hinzu.

Optionen:

• --agent <id> (Standard ist der aktuelle Default-Agent)
• --bind <channel[:accountId]> (wiederholbar)
• --json

agents unbind

Entferne Routing-Bindings für einen Agent.

Optionen:

• --agent <id> (Standard ist der aktuelle Default-Agent)
• --bind <channel[:accountId]> (wiederholbar)
• --all
• --json

Nutze entweder --all oder --bind, nicht beides gleichzeitig.

agents delete <id>

Lösche einen Agent und entferne seinen Workspace sowie Status.

Optionen:

• --force
• --json

Hinweise:

• main kann nicht gelöscht werden.
• Ohne --force ist eine interaktive Bestätigung erforderlich.

agents set-identity

Aktualisiere die Identität eines Agents (Name/Theme/Emoji/Avatar).

Optionen:

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

Hinweise:

• Nutze --agent oder --workspace, um den Ziel-Agent auszuwählen.
• Wenn keine expliziten Felder angegeben werden, liest der Befehl die Datei IDENTITY.md.

acp

Führe die ACP-Bridge aus, die IDEs mit dem Gateway verbindet.

Root-Optionen:

• --url <url>
• --token <token>
• --token-file <path>
• --password <password>
• --password-file <path>
• --session <key>
• --session-label <label>
• --require-existing
• --reset-session
• --no-prefix-cwd
• --provenance <off|meta|meta+receipt>
• --verbose

acp client

Interaktiver ACP-Client zum Debuggen der Bridge.

Optionen:

• --cwd <dir>
• --server <command>
• --server-args <args...>
• --server-verbose
• --verbose

Siehe acp für Details zum Verhalten, Sicherheitshinweise und Beispiele.

mcp

Verwalte gespeicherte MCP-Server-Definitionen und stelle OpenClaw-Kanäle über MCP stdio bereit.

mcp serve

Stelle geroutete OpenClaw-Kanal-Konversationen über MCP stdio bereit.

Optionen:

• --url <url>
• --token <token>
• --token-file <path>
• --password <password>
• --password-file <path>
• --claude-channel-mode <auto|on|off>
• --verbose

mcp list

Liste gespeicherte MCP-Server-Definitionen auf.

Optionen:

• --json

mcp show [name]

Zeige eine spezifische oder alle gespeicherten MCP-Server-Definitionen an.

Optionen:

• --json

mcp set <name> <value>

Speichere eine MCP-Server-Definition aus einem JSON-Objekt.

mcp unset <name>

Entferne eine gespeicherte MCP-Server-Definition.

approvals

Verwalte Freigaben für die Befehlsausführung (Exec-Approvals). Alias: exec-approvals.

approvals get

Ruft den Snapshot der Exec-Freigaben und die geltende Policy ab.

Optionen:

• --node <node>
• --gateway
• --json
• Node-RPC-Optionen aus openclaw nodes

approvals set

Ersetze Exec-Freigaben durch JSON aus einer Datei oder von stdin.

Optionen:

• --node <node>
• --gateway
• --file <path>
• --stdin
• --json
• Node-RPC-Optionen aus openclaw nodes

approvals allowlist add|remove

Bearbeite die Exec-Allowlist pro Agent.

Optionen:

• --node <node>
• --gateway
• --agent <id> (Standard ist *)
• --json
• Node-RPC-Optionen aus openclaw nodes

status

Zeigt den Zustand verknüpfter Sessions und die letzten Empfänger an.

Optionen:

• --json
• --all (Vollständige Diagnose; schreibgeschützt, zum Kopieren geeignet)
• --deep (Fragt das Gateway nach einem Live-Status-Check, inklusive Kanal-Prüfungen)
• --usage (Zeigt Nutzung/Quota der Model-Provider an)
• --timeout <ms>
• --verbose
• --debug (Alias für --verbose)

Hinweise:

• Die Übersicht enthält den Status des Gateways und des Node-Host-Services, sofern verfügbar.
• --usage gibt die Nutzung in Prozent aus (X% left).

Usage tracking

OpenClaw kann die Nutzung und Quota von Providern anzeigen, wenn OAuth- oder API-Zugangsdaten verfügbar sind.

Anzeigeorte:

• /status (fügt eine kurze Zeile zur Nutzung hinzu)
• openclaw status --usage (zeigt eine detaillierte Aufschlüsselung)
• macOS Menüleiste (Bereich “Usage” unter “Context”)

Hinweise:

• Die Daten stammen direkt von den Endpunkten der Provider (keine Schätzungen).
• Die Ausgabe wird providerübergreifend auf X% left normiert.
• Unterstützte Provider: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi und z.ai.
• Hinweis zu MiniMax: Da usage_percent dort die verbleibende Quota angibt, invertiert OpenClaw diesen Wert vor der Anzeige.
• Die Authentifizierung erfolgt über providerspezifische Hooks oder passende Credentials aus Auth-Profilen, Umgebungsvariablen oder der Konfiguration. Falls nichts gefunden wird, bleibt die Anzeige ausgeblendet.
• Details: siehe Usage tracking.

health

Ruft den Gesundheitsstatus vom laufenden Gateway ab.

Optionen:

• --json
• --timeout <ms>
• --verbose (erzwingt eine Live-Prüfung und zeigt Gateway-Verbindungsdetails)
• --debug (Alias für --verbose)

Hinweise:

• Der Standardbefehl health kann einen aktuellen, gecachten Snapshot zurückgeben.
• health --verbose erzwingt eine Live-Prüfung für alle konfigurierten Accounts und Agents.

sessions

Liste gespeicherte Konversations-Sessions auf.

Optionen:

• --json
• --verbose
• --store <path>
• --active <minutes>
• --agent <id> (Filtert Sessions nach Agent)
• --all-agents (Zeigt Sessions aller Agents)

Unterbefehle:

• sessions cleanup — Entfernt abgelaufene oder verwaiste Sessions.

Hinweise:

• sessions cleanup unterstützt auch --fix-missing, um Einträge zu löschen, deren Transkript-Dateien nicht mehr existieren.

Reset / Deinstallieren

reset

Setzt die lokale Konfiguration oder den Status zurück (die CLI bleibt installiert).

Optionen:

• --scope <config|config+creds+sessions|full>
• --yes
• --non-interactive
• --dry-run

Hinweise:

• --non-interactive erfordert --scope und --yes.

uninstall

Deinstalliert den Gateway-Dienst und die lokalen Daten (die CLI bleibt erhalten).

Optionen:

• --service
• --state
• --workspace
• --app
• --all
• --yes
• --non-interactive
• --dry-run

Hinweise:

• --non-interactive erfordert --yes und explizite Scopes (oder --all).
• --all entfernt den Dienst, den Status, den Workspace und die App zusammen.

tasks

Liste und verwalte background task Ausführungen über Agents hinweg.

• tasks list — zeigt aktive und kürzlich ausgeführte Task-Runs
• tasks show <id> — zeigt Details für einen spezifischen Task-Run
• tasks notify <id> — ändert die Benachrichtigungsrichtlinie für einen Task-Run
• tasks cancel <id> — bricht einen laufenden Task ab
• tasks audit — macht betriebliche Probleme sichtbar (veraltet, verloren, Zustellungsfehler)
• tasks maintenance [--apply] [--json] — Vorschau oder Anwendung von Tasks und TaskFlow-Bereinigung/Abgleich (ACP/Subagent-Child-Sessions, aktive Cron-Jobs, Live-CLI-Runs)
• tasks flow list — listet aktive und kürzlich ausgeführte Task Flow-Flows auf
• tasks flow show <lookup> — inspiziert einen Flow anhand der ID oder des Lookup-Keys
• tasks flow cancel <lookup> — bricht einen laufenden Flow und seine aktiven Tasks ab

flows

Legacy-Shortcut für die Dokumentation. Flow-Befehle befinden sich unter openclaw tasks flow:

• tasks flow list [--json]
• tasks flow show <lookup>
• tasks flow cancel <lookup>

Gateway

gateway

Führt das WebSocket Gateway aus.

Optionen:

• --port <port>
• --bind <loopback|tailnet|lan|auto|custom>
• --token <token>
• --auth <token|password>
• --password <password>
• --password-file <path>
• --tailscale <off|serve|funnel>
• --tailscale-reset-on-exit
• --allow-unconfigured
• --dev
• --reset (setzt Dev-Konfiguration + Credentials + Sessions + Workspace zurück)
• --force (beendet existierende Listener auf dem Port)
• --verbose
• --cli-backend-logs
• --ws-log <auto|full|compact>
• --compact (Alias für --ws-log compact)
• --raw-stream
• --raw-stream-path <path>

gateway service

Verwalte den Gateway-Dienst (launchd/systemd/schtasks).

Subcommands:

• gateway status (prüft standardmäßig den Gateway RPC)
• gateway install (Dienst-Installation)
• gateway uninstall
• gateway start
• gateway stop
• gateway restart

Hinweise:

• gateway status prüft standardmäßig den Gateway RPC unter Verwendung des aufgelösten Ports/Konfiguration des Dienstes (überschreibe dies mit --url/--token/--password).
• gateway status unterstützt --no-probe, --deep, --require-rpc und --json für Scripting.
• gateway status macht auch Legacy- oder zusätzliche Gateway-Dienste sichtbar, wenn diese erkannt werden (--deep fügt Scans auf Systemebene hinzu). OpenClaw-Dienste mit Profilnamen werden als erstklassig behandelt und nicht als “extra” markiert.
• gateway status bleibt für Diagnosen verfügbar, selbst wenn die lokale CLI-Konfiguration fehlt oder ungültig ist.
• gateway status gibt den aufgelösten Log-Dateipfad, einen Snapshot der CLI- vs. Dienst-Konfigurationspfade/Gültigkeit und die aufgelöste Probe-Ziel-URL aus.
• Wenn Gateway-Auth-SecretRefs im aktuellen Befehlspfad nicht aufgelöst sind, meldet gateway status --json nur dann rpc.authWarning, wenn die Probe-Verbindung oder Authentifizierung fehlschlägt (Warnungen werden unterdrückt, wenn die Probe erfolgreich ist).
• Bei Linux systemd-Installationen umfassen die Prüfungen auf Token-Drift sowohl Environment= als auch EnvironmentFile= Unit-Quellen.
• gateway install|uninstall|start|stop|restart unterstützen --json für Scripting (die Standardausgabe bleibt benutzerfreundlich).
• gateway install verwendet standardmäßig die Node-Runtime; Bun wird nicht empfohlen (WhatsApp/Telegram-Bugs).
• gateway install Optionen: --port, --runtime, --token, --force, --json.

daemon

Legacy-Alias für die Gateway-Dienst-Management-Befehle. Siehe /cli/daemon.

Subcommands:

• daemon status
• daemon install
• daemon uninstall
• daemon start
• daemon stop
• daemon restart

Gemeinsame Optionen:

• status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
• install: --port, --runtime <node|bun>, --token, --force, --json
• uninstall|start|stop|restart: --json

logs

Verfolge Gateway-Dateilogs via RPC.

Optionen:

• --limit <n>: Maximale Anzahl der zurückzugebenden Logzeilen
• --max-bytes <n>: Maximale Bytes, die aus der Logdatei gelesen werden sollen
• --follow: Folgt der Logdatei (Tail -f Stil)
• --interval <ms>: Polling-Intervall in ms beim Folgen
• --local-time: Zeigt Zeitstempel in lokaler Zeit an
• --json: Gibt zeilengetrenntes JSON aus
• --plain: Deaktiviert strukturierte Formatierung
• --no-color: Deaktiviert ANSI-Farben
• --url <url>: Explizite Gateway WebSocket URL
• --token <token>: Gateway-Token
• --timeout <ms>: Gateway RPC Timeout
• --expect-final: Wartet bei Bedarf auf eine finale Antwort

Beispiele:

openclaw logs --follow
openclaw logs --limit 200
openclaw logs --plain
openclaw logs --json
openclaw logs --no-color

Hinweise:

• Wenn du --url übergibst, wendet die CLI Konfigurations- oder Umgebungs-Credentials nicht automatisch an.
• Fehler bei der lokalen Loopback-Kopplung fallen auf die konfigurierte lokale Logdatei zurück; explizite --url Ziele tun dies nicht.

gateway <subcommand>

Gateway CLI-Helfer (verwende --url, --token, --password, --timeout, --expect-final für RPC-Subcommands). Wenn du --url übergibst, wendet die CLI Konfigurations- oder Umgebungs-Credentials nicht automatisch an. Gib --token oder --password explizit an. Fehlende explizite Credentials führen zu einem Fehler.

Subcommands:

• gateway call <method> [--params <json>] [--url <url>] [--token <token>] [--password <password>] [--timeout <ms>] [--expect-final] [--json]
• gateway health
• gateway status
• gateway probe
• gateway discover
• gateway install|uninstall|start|stop|restart
• gateway run

Hinweise:

• gateway status --deep fügt einen Dienst-Scan auf Systemebene hinzu. Verwende gateway probe, health --verbose oder das Top-Level status --deep für detailliertere Runtime-Probe-Informationen.

Häufige RPCs:

• config.schema.lookup (inspiziert einen Konfigurations-Teilbaum mit einem flachen Schema-Knoten, passenden Hint-Metadaten und Zusammenfassungen der direkten Child-Elemente)
• config.get (liest den aktuellen Konfigurations-Snapshot + Hash)
• config.set (validiert + schreibt die vollständige Konfiguration; verwende baseHash für optimistische Nebenläufigkeit)
• config.apply (validiert + schreibt Konfiguration + Neustart + Wake)
• config.patch (führt ein partielles Update zusammen + Neustart + Wake)
• update.run (führt Update aus + Neustart + Wake)

Tipp: Wenn du config.set/config.apply/config.patch direkt aufrufst, übergib den baseHash von config.get, falls bereits eine Konfiguration existiert. Tipp: Für partielle Bearbeitungen solltest du zuerst mit config.schema.lookup prüfen und config.patch bevorzugen. Tipp: Diese Konfigurations-Schreib-RPCs prüfen vorab die aktive SecretRef-Auflösung für Referenzen im übermittelten Konfigurations-Payload und lehnen Schreibvorgänge ab, wenn eine effektiv aktive übermittelte Referenz nicht aufgelöst werden kann. Tipp: Das nur für Besitzer zugängliche gateway Runtime-Tool verweigert weiterhin das Überschreiben von tools.exec.ask oder tools.exec.security; Legacy tools.bash.* Aliase normalisieren sich auf dieselben geschützten Exec-Pfade.

Modelle

Unter /concepts/models findest du Details zum Fallback-Verhalten und zur Scanning-Strategie.

Hinweis zu Anthropic: Mitarbeiter von Anthropic haben uns mitgeteilt, dass die Nutzung des Claude CLI im OpenClaw-Stil wieder erlaubt ist. OpenClaw betrachtet die Wiederverwendung des Claude CLI und die Nutzung von claude -p daher als sanktioniert, solange Anthropic keine neue Policy veröffentlicht. Für den produktiven Einsatz solltest du einen Anthropic API Key oder einen anderen unterstützten Provider mit Abo-Modell bevorzugen, wie etwa OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan oder Z.AI / GLM Coding Plan.

Anthropic setup-token bleibt als unterstützter Pfad für die Token-Authentifizierung verfügbar, aber OpenClaw bevorzugt jetzt die Wiederverwendung des Claude CLI und claude -p, sofern verfügbar.

models (root)

openclaw models ist ein Alias für models status.

Root-Optionen:

• --status-json (Alias für models status --json)
• --status-plain (Alias für models status --plain)

models list

Optionen:

• --all
• --local
• --provider <name>
• --json
• --plain

models status

Optionen:

• --json
• --plain
• --check (Exit 1=abgelaufen/fehlt, 2=läuft bald ab)
• --probe (Live-Probe der konfigurierten Auth-Profile)
• --probe-provider <name>
• --probe-profile <id> (Wiederholbar oder durch Komma getrennt)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id>

Enthält immer die Auth-Übersicht und den OAuth-Ablaufstatus für Profile im Auth-Store. --probe führt Live-Anfragen aus (kann Tokens verbrauchen und Rate Limits auslösen). Probe-Zeilen können aus Auth-Profilen, Umgebungsvariablen (env credentials) oder der models.json stammen. Erwarte Probe-Status wie ok, auth, rate_limit, billing, timeout, format, unknown und no_model. Wenn eine explizite auth.order.<provider> ein gespeichertes Profil auslässt, meldet die Probe excluded_by_auth_order, anstatt dieses Profil stillschweigend zu testen.

models set <model>

Setzt agents.defaults.model.primary.

models set-image <model>

Setzt agents.defaults.imageModel.primary.

models aliases list|add|remove

Optionen:

• list: --json, --plain
• add <alias> <model>
• remove <alias>

models fallbacks list|add|remove|clear

Optionen:

• list: --json, --plain
• add <model>
• remove <model>
• clear

models image-fallbacks list|add|remove|clear

Optionen:

• list: --json, --plain
• add <model>
• remove <model>
• clear

models scan

Optionen:

• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms>
• --concurrency <n>
• --no-probe
• --yes
• --no-input
• --set-default
• --set-image
• --json

models auth add|login|login-github-copilot|setup-token|paste-token

Optionen:

• add: Interaktiver Auth-Helper (Provider-Auth-Flow oder Token einfügen)
• login: --provider <name>, --method <method>, --set-default
• login-github-copilot: GitHub Copilot OAuth Login-Flow (--yes)
• setup-token: --provider <name>, --yes
• paste-token: --provider <name>, --profile-id <id>, --expires-in <duration>

Hinweise:

• setup-token und paste-token sind generische Token-Befehle für Provider, die Token-Auth-Methoden anbieten.
• setup-token erfordert ein interaktives TTY und führt die Token-Auth-Methode des Providers aus.
• paste-token fragt den Token-Wert ab und nutzt standardmäßig die Auth-Profil-ID <provider>:manual, wenn --profile-id weggelassen wird.
• Anthropic setup-token / paste-token bleiben als unterstützter OpenClaw-Token-Pfad verfügbar, aber OpenClaw bevorzugt jetzt die Wiederverwendung des Claude CLI und claude -p, falls verfügbar.

models auth order get|set|clear

Optionen:

• get: --provider <name>, --agent <id>, --json
• set: --provider <name>, --agent <id>, <profileIds...>
• clear: --provider <name>, --agent <id>

System

system event

Füge ein System-Event zur Queue hinzu und löse optional einen Heartbeat aus (Gateway RPC).

Erforderlich:

• --text <text>

Optionen:

• --mode <now|next-heartbeat>
• --json
• --url, --token, --timeout, --expect-final

system heartbeat last|enable|disable

Heartbeat-Steuerung (Gateway RPC).

Optionen:

• --json
• --url, --token, --timeout, --expect-final

system presence

Liste der System-Presence-Einträge (Gateway RPC).

Optionen:

• --json
• --url, --token, --timeout, --expect-final

Cron

Verwalte geplante Jobs (Gateway RPC). Schau dir dazu /automation/cron-jobs an.

Subcommands:

• cron status [--json]
• cron list [--all] [--json] (Tabellenausgabe standardmäßig; nutze --json für Rohdaten)
• cron add (Alias: create; erfordert --name und exakt eine der Optionen --at | --every | --cron sowie exakt eine Payload von --system-event | --message)
• cron edit <id> (Felder patchen)
• cron rm <id> (Aliase: remove, delete)
• cron enable <id>
• cron disable <id>
• cron runs --id <id> [--limit <n>]
• cron run <id> [--due]

Alle cron Befehle akzeptieren --url, --token, --timeout und --expect-final.

cron add|edit --model ... verwendet das gewählte erlaubte Model für den Job. Falls das Model nicht zulässig ist, gibt cron eine Warnung aus und greift stattdessen auf die Agent/Default-Model-Auswahl des Jobs zurück. Konfigurierte Fallback-Chains greifen weiterhin, aber ein einfacher Model-Override ohne explizite Fallback-Liste pro Job fügt den primären Agenten nicht mehr als verstecktes zusätzliches Retry-Ziel hinzu.

Node host

node

node führt einen headless node host aus oder verwaltet ihn als Hintergrunddienst. Siehe openclaw node.

Subcommands:

• node run --host <gateway-host> --port 18789
• node status
• node install [--host <gateway-host>] [--port <port>] [--tls] [--tls-fingerprint <sha256>] [--node-id <id>] [--display-name <name>] [--runtime <node|bun>] [--force]
• node uninstall
• node stop
• node restart

Hinweise zur Authentifizierung:

• node löst die Gateway-Authentifizierung über Umgebungsvariablen oder die Konfiguration auf (es gibt keine --token oder --password Flags): Zuerst OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD, dann gateway.auth.*. Im lokalen Modus ignoriert der Node-Host gateway.remote.* absichtlich; im Modus gateway.mode=remote wird gateway.remote.* nach den Regeln für Remote-Präzedenz einbezogen.
• Die Auth-Auflösung des Node-Hosts berücksichtigt ausschließlich OPENCLAW_GATEWAY_* Umgebungsvariablen.

Nodes

nodes kommuniziert mit dem Gateway und steuert gekoppelte Nodes an. Details findest du unter /nodes.

Häufige Optionen:

• --url, --token, --timeout, --json

Subcommands:

nodes status [--connected] [--last-connected <duration>]
nodes describe --node &lt;id|name|ip&gt;
nodes list [--connected] [--last-connected <duration>]
nodes pending
nodes approve <requestId>
nodes reject <requestId>
nodes rename --node &lt;id|name|ip&gt; --name <displayName>
nodes invoke --node &lt;id|name|ip&gt; --command <command> [--params <json>] [--invoke-timeout <ms>] [--idempotency-key <key>]
nodes notify --node &lt;id|name|ip&gt; [--title <text>] [--body <text>] [--sound <name>] [--priority &lt;passive|active|timeSensitive&gt;] [--delivery &lt;system|overlay|auto&gt;] [--invoke-timeout <ms>]

(nur Mac)

Kamera:

nodes camera list --node <id|name|ip>
nodes camera snap --node &lt;id|name|ip&gt; [--facing front|back|both] [--device-id <id>] [--max-width <px>] [--quality <0-1>] [--delay-ms <ms>] [--invoke-timeout <ms>]
nodes camera clip --node &lt;id|name|ip&gt; [--facing front|back] [--device-id <id>] [--duration &lt;ms|10s|1m&gt;] [--no-audio] [--invoke-timeout <ms>]

Canvas + Screen:

nodes canvas snapshot --node &lt;id|name|ip&gt; [--format png|jpg|jpeg] [--max-width <px>] [--quality <0-1>] [--invoke-timeout <ms>]
nodes canvas present --node &lt;id|name|ip&gt; [--target <urlOrPath>] [--x <px>] [--y <px>] [--width <px>] [--height <px>] [--invoke-timeout <ms>]
nodes canvas hide --node &lt;id|name|ip&gt; [--invoke-timeout <ms>]
nodes canvas navigate <url> --node &lt;id|name|ip&gt; [--invoke-timeout <ms>]
nodes canvas eval [<js>] --node &lt;id|name|ip&gt; [--js <code>] [--invoke-timeout <ms>]
nodes canvas a2ui push --node &lt;id|name|ip&gt; (--jsonl <path> | --text <text>) [--invoke-timeout <ms>]
nodes canvas a2ui reset --node &lt;id|name|ip&gt; [--invoke-timeout <ms>]
nodes screen record --node &lt;id|name|ip&gt; [--screen <index>] [--duration &lt;ms|10s&gt;] [--fps <n>] [--no-audio] [--out <path>] [--invoke-timeout <ms>]

Standort:

nodes location get --node &lt;id|name|ip&gt; [--max-age <ms>] [--accuracy &lt;coarse|balanced|precise&gt;] [--location-timeout <ms>] [--invoke-timeout <ms>]

Browser

CLI zur Browser-Steuerung (für Chrome, Brave, Edge oder Chromium). Schau dir dazu openclaw browser und das Browser tool an.

Häufige Optionen:

• --url, --token, --timeout, --expect-final, --json
• --browser-profile <name>

Verwalten:

browser status
browser start
browser stop
browser reset-profile
browser tabs
browser open <url>
browser focus <targetId>
browser close [targetId]
browser profiles
browser create-profile --name <name> [--color <hex>] [--cdp-url <url>] [--driver existing-session] [--user-data-dir <path>]
browser delete-profile --name <name>

Inspizieren:

browser screenshot [targetId] [--full-page] [--ref <ref>] [--element <selector>] [--type png|jpeg]
browser snapshot [--format aria|ai] [--target-id <id>] [--limit <n>] [--interactive] [--compact] [--depth <n>] [--selector <sel>] [--out <path>]

Aktionen:

browser navigate <url> [--target-id <id>]
browser resize <width> <height> [--target-id <id>]
browser click <ref> [--double] [--button &lt;left|right|middle&gt;] [--modifiers <csv>] [--target-id <id>]
browser type <ref> <text> [--submit] [--slowly] [--target-id <id>]
browser press <key> [--target-id <id>]
browser hover <ref> [--target-id <id>]
browser drag <startRef> <endRef> [--target-id <id>]
browser select <ref> <values...> [--target-id <id>]
browser upload <paths...> [--ref <ref>] [--input-ref <ref>] [--element <selector>] [--target-id <id>] [--timeout-ms <ms>]
browser fill [--fields <json>] [--fields-file <path>] [--target-id <id>]
browser dialog --accept|--dismiss [--prompt <text>] [--target-id <id>] [--timeout-ms <ms>]
browser wait [--time <ms>] [--text <value>] [--text-gone <value>] [--target-id <id>]
browser evaluate --fn <code> [--ref <ref>] [--target-id <id>]
browser console [--level &lt;error|warn|info&gt;] [--target-id <id>]
browser pdf [--target-id <id>]

Sprachanrufe

voicecall

Hier findest du die vom Plugin bereitgestellten Utilities für Sprachanrufe. Diese Funktionen sind nur verfügbar, wenn du das voice-call Plugin installiert und aktiviert hast. Schau dir dazu auch openclaw voicecall an.

Häufige Commands:

voicecall call --to <phone> --message <text> [--mode notify|conversation]
voicecall start --to <phone> [--message <text>] [--mode notify|conversation]
voicecall continue --call-id <id> --message <text>
voicecall speak --call-id <id> --message <text>
voicecall end --call-id <id>
voicecall status --call-id <id>
voicecall tail [--file <path>] [--since <n>] [--poll <ms>]
voicecall latency [--file <path>] [--last <n>]
voicecall expose [--mode off|serve|funnel] [--path <path>] [--port <port>] [--serve-path <path>]

Dokumentationssuche

docs

Durchsuche den Live-Index der OpenClaw-Docs.

docs [query...]

Mit diesem Command kannst du den Live-Index der Docs direkt abfragen.

TUI

tui

Öffne das Terminal UI, das direkt mit dem Gateway verbunden ist.

Optionen:

• --url <url>
• --token <token>
• --password <password>
• --session <key>
• --deliver
• --thinking <level>
• --message <text>
• --timeout-ms <ms> (Standardwert ist agents.defaults.timeoutSeconds)
• --history-limit <n>