CLI-Referenz

Diese Seite beschreibt das aktuelle CLI-Verhalten. Wenn sich Befehle \u00e4ndern, aktualisiere dieses Dokument.

Befehlsseiten

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

Globale Flags

• --dev: State unter ~/.openclaw-dev isolieren und Standard-Ports verschieben.
• --profile <name>: State unter ~/.openclaw-<name> isolieren.
• --no-color: ANSI-Farben deaktivieren.
• --update: Kurzform f\u00fcr openclaw update (nur Source-Installationen).
• -V, --version, -v: Version ausgeben und beenden.

Ausgabe-Styling

• ANSI-Farben und Fortschrittsanzeigen werden nur in TTY-Sessions gerendert.
• OSC-8-Hyperlinks werden in unterst\u00fctzten Terminals als klickbare Links dargestellt; andernfalls wird auf reine URLs zur\u00fcckgegriffen.
• --json (und --plain wo unterst\u00fctzt) deaktiviert Styling f\u00fcr saubere Ausgabe.
• --no-color deaktiviert ANSI-Styling; NO_COLOR=1 wird ebenfalls ber\u00fccksichtigt.
• Langandauernde Befehle zeigen eine Fortschrittsanzeige (OSC 9;4 wenn unterst\u00fctzt).

Farbpalette

OpenClaw verwendet eine Lobster-Palette f\u00fcr die CLI-Ausgabe.

• accent (#FF5A2D): \u00dcberschriften, Labels, prim\u00e4re Hervorhebungen.
• accentBright (#FF7A3D): Befehlsnamen, Betonung.
• accentDim (#D14A22): Sekund\u00e4rer Hervorhebungstext.
• info (#FF8A5B): Informationswerte.
• success (#2FBF71): Erfolgszust\u00e4nde.
• warn (#FFB020): Warnungen, Fallbacks, Aufmerksamkeit.
• error (#E23D2D): Fehler, Fehlschl\u00e4ge.
• muted (#8B7F77): Debetonung, Metadaten.

Palette-Quelle: src/terminal/palette.ts (auch “lobster seam” genannt).

Befehlsbaum

openclaw [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
  completion
  doctor
  dashboard
  backup
    create
    verify
  security
    audit
  secrets
    reload
    migrate
  reset
  uninstall
  update
  channels
    list
    status
    logs
    add
    remove
    login
    logout
  directory
  skills
    list
    info
    check
  plugins
    list
    info
    install
    enable
    disable
    doctor
  memory
    status
    index
    search
  message
  agent
  agents
    list
    add
    delete
  acp
  status
  health
  sessions
  gateway
    call
    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
    auth add|setup-token|paste-token
    auth order get|set|clear
  sandbox
    list
    recreate
    explain
  cron
    status
    list
    add
    edit
    rm
    enable
    disable
    runs
    run
  nodes
  devices
  node
    run
    status
    install
    uninstall
    start
    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\u00f6nnen zus\u00e4tzliche Top-Level-Befehle hinzuf\u00fcgen (z.B. openclaw voicecall).

Sicherheit

• openclaw security audit \u2014 Config + lokalen State auf h\u00e4ufige Sicherheitsfallen pr\u00fcfen.
• openclaw security audit --deep \u2014 bestm\u00f6glicher Live-Gateway-Probe.
• openclaw security audit --fix \u2014 sichere Standards verschr\u00e4nken und State/Config chmod anpassen.

Secrets

• openclaw secrets reload \u2014 Refs neu aufl\u00f6sen und den Runtime-Snapshot atomar austauschen.
• openclaw secrets audit \u2014 nach Klartext-R\u00fcckst\u00e4nden, nicht aufgel\u00f6sten Refs und Vorrang-Drift scannen.
• openclaw secrets configure \u2014 interaktiver Helfer f\u00fcr Provider-Setup + SecretRef-Mapping + Preflight/Apply.
• openclaw secrets apply --from <plan.json> \u2014 einen zuvor generierten Plan anwenden (--dry-run unterst\u00fctzt).

Plugins

Erweiterungen und ihre Config verwalten:

• openclaw plugins list \u2014 Plugins entdecken (verwende --json f\u00fcr maschinenlesbare Ausgabe).
• openclaw plugins info <id> \u2014 Details f\u00fcr ein Plugin anzeigen.
• openclaw plugins install <path|.tgz|npm-spec> \u2014 ein Plugin installieren (oder einen Plugin-Pfad zu plugins.load.paths hinzuf\u00fcgen).
• openclaw plugins enable <id> / disable <id> \u2014 plugins.entries.<id>.enabled umschalten.
• openclaw plugins doctor \u2014 Plugin-Ladefehler melden.

Die meisten Plugin-\u00c4nderungen erfordern einen Gateway-Neustart. Siehe /plugin.

Memory

Vektorsuche \u00fcber MEMORY.md + memory/*.md:

• openclaw memory status \u2014 Index-Statistiken anzeigen.
• openclaw memory index \u2014 Memory-Dateien neu indizieren.
• openclaw memory search "<query>" (oder --query "<query>") \u2014 semantische Suche \u00fcber Memory.

Chat-Slash-Befehle

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

Highlights:

• /status f\u00fcr schnelle Diagnostik.
• /config f\u00fcr persistierte Config-\u00c4nderungen.
• /debug f\u00fcr Runtime-only-Config-\u00dcberschreibungen (Memory, nicht Festplatte; erfordert commands.debug: true).

Setup + Onboarding

setup

Config + Workspace initialisieren.

Optionen:

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

Der Assistent startet automatisch, wenn Assistenten-Flags vorhanden sind (--non-interactive, --mode, --remote-url, --remote-token).

onboard

Interaktiver Assistent zum Einrichten von Gateway, Workspace und Skills.

Optionen:

• --workspace <dir>
• --reset (Config + Anmeldeinformationen + Sessions vor dem Assistenten zur\u00fccksetzen)
• --reset-scope <config|config+creds+sessions|full> (Standard config+creds+sessions; verwende full, um auch den Workspace zu entfernen)
• --non-interactive
• --mode <local|remote>
• --flow <quickstart|advanced|manual> (manual ist ein Alias f\u00fcr advanced)
• --auth-choice <setup-token|token|chutes|openai-codex|openai-api-key|openrouter-api-key|ollama|ai-gateway-api-key|moonshot-api-key|moonshot-api-key-cn|kimi-code-api-key|synthetic-api-key|venice-api-key|gemini-api-key|zai-api-key|mistral-api-key|apiKey|minimax-api|minimax-api-lightning|opencode-zen|opencode-go|custom-api-key|skip>
• --token-provider <id> (nicht-interaktiv; verwendet mit --auth-choice token)
• --token <token> (nicht-interaktiv; verwendet mit --auth-choice token)
• --token-profile-id <id> (nicht-interaktiv; Standard: <provider>:manual)
• --token-expires-in <duration> (nicht-interaktiv; z.B. 365d, 12h)
• --secret-input-mode <plaintext|ref> (Standard plaintext; verwende ref, um Provider-Standard-Env-Refs statt Klartext-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; verwendet mit --auth-choice custom-api-key oder --auth-choice ollama)
• --custom-model-id <id> (nicht-interaktiv; verwendet mit --auth-choice custom-api-key oder --auth-choice ollama)
• --custom-api-key <key> (nicht-interaktiv; optional; verwendet mit --auth-choice custom-api-key; F\u00e4llt auf CUSTOM_API_KEY zur\u00fcck, wenn weggelassen)
• --custom-provider-id <id> (nicht-interaktiv; optionale benutzerdefinierte 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; gateway.auth.token als env-SecretRef speichern; erfordert, dass diese Umgebungsvariable gesetzt ist; kann nicht mit --gateway-token kombiniert werden)
• --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-health
• --skip-ui
• --node-manager <npm|pnpm|bun> (pnpm empfohlen; bun nicht empfohlen f\u00fcr Gateway-Runtime)
• --json

configure

Interaktiver Konfigurationsassistent (Modelle, Channels, Skills, Gateway).

config

Nicht-interaktive Config-Helfer (get/set/unset/file/validate). openclaw config ohne Unterbefehl startet den Assistenten.

Unterbefehle:

• config get <path>: Einen Config-Wert ausgeben (Punkt-/Klammer-Pfad).
• config set <path> <value>: Einen Wert setzen (JSON5 oder roher String).
• config unset <path>: Einen Wert entfernen.
• config file: Den aktiven Config-Dateipfad ausgeben.
• config validate: Die aktuelle Config gegen das Schema validieren, ohne das Gateway zu starten.
• config validate --json: Maschinenlesbares JSON ausgeben.

doctor

Gesundheitspr\u00fcfungen + Schnellreparaturen (Config + Gateway + Legacy-Services).

Optionen:

• --no-workspace-suggestions: Workspace-Memory-Hinweise deaktivieren.
• --yes: Standards ohne Prompt akzeptieren (headless).
• --non-interactive: Prompts \u00fcberspringen; nur sichere Migrationen anwenden.
• --deep: System-Services auf zus\u00e4tzliche Gateway-Installationen scannen.

Channel-Helfer

channels

Chat-Channel-Accounts verwalten (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/Signal/iMessage/MS Teams).

Unterbefehle:

• channels list: Konfigurierte Channels und Auth-Profile anzeigen.
• channels status: Gateway-Erreichbarkeit und Channel-Health pr\u00fcfen (--probe f\u00fchrt zus\u00e4tzliche Checks durch; verwende openclaw health oder openclaw status --deep f\u00fcr Gateway-Health-Probes).
• Tipp: channels status gibt Warnungen mit L\u00f6sungsvorschl\u00e4gen aus, wenn h\u00e4ufige Fehlkonfigurationen erkannt werden (und verweist dann auf openclaw doctor).
• channels logs: Aktuelle Channel-Logs aus der Gateway-Logdatei anzeigen.
• channels add: Assistenten-Style-Setup, wenn keine Flags \u00fcbergeben werden; Flags schalten auf nicht-interaktiven Modus.
  • Beim Hinzuf\u00fcgen eines nicht-Standard-Accounts zu einem Channel, der noch Single-Account-Top-Level-Config verwendet, verschiebt OpenClaw account-bezogene Werte in channels.<channel>.accounts.default, bevor der neue Account geschrieben wird.
  • Nicht-interaktives channels add erstellt/aktualisiert keine Bindings automatisch; Channel-only-Bindings matchen weiterhin den Standard-Account.
• channels remove: Standardm\u00e4\u00dfig deaktivieren; \u00fcbergib --delete, um Config-Eintr\u00e4ge ohne Prompts zu entfernen.
• channels login: Interaktiver Channel-Login (nur WhatsApp Web).
• channels logout: Aus einer Channel-Session abmelden (falls unterst\u00fctzt).

H\u00e4ufige Optionen:

• --channel <name>: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
• --account <id>: Channel-Account-ID (Standard default)
• --name <label>: Anzeigename f\u00fcr den Account

channels login-Optionen:

• --channel <channel> (Standard whatsapp; unterst\u00fctzt whatsapp/web)
• --account <id>
• --verbose

channels logout-Optionen:

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

channels list-Optionen:

• --no-usage: Model-Provider-Usage/Quota-Snapshots \u00fcberspringen (nur OAuth/API-basiert).
• --json: JSON ausgeben (enth\u00e4lt Usage, wenn nicht --no-usage gesetzt).

channels logs-Optionen:

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

Mehr Details: /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

skills

Verf\u00fcgbare Skills auflisten und pr\u00fcfen plus Bereitschaftsinformationen.

Unterbefehle:

• skills list: Skills auflisten (Standard wenn kein Unterbefehl).
• skills info <name>: Details zu einem Skill anzeigen.
• skills check: Zusammenfassung von bereit vs. fehlende Anforderungen.

Optionen:

• --eligible: Nur bereite Skills anzeigen.
• --json: JSON ausgeben (kein Styling).
• -v, --verbose: Details zu fehlenden Anforderungen einschlie\u00dfen.

Tipp: Verwende npx clawhub, um Skills zu suchen, installieren und synchronisieren.

pairing

DM-Pairing-Anfragen \u00fcber Channels genehmigen.

Unterbefehle:

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

devices

Gateway-Ger\u00e4te-Pairing-Eintr\u00e4ge und rollenbezogene Ger\u00e4te-Tokens verwalten.

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>

webhooks gmail

Gmail Pub/Sub Hook-Setup + Runner. Siehe /automation/gmail-pubsub.

Unterbefehle:

• webhooks gmail setup (erfordert --account <email>; unterst\u00fctzt --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-\u00dcberschreibungen f\u00fcr dieselben Flags)

dns setup

Wide-Area-Discovery-DNS-Helfer (CoreDNS + Tailscale). Siehe /gateway/discovery.

Optionen:

• --apply: CoreDNS-Config installieren/aktualisieren (erfordert sudo; nur macOS).

Messaging + Agent

message

Vereinheitlichtes Outbound-Messaging + Channel-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

Einen Agent-Turn \u00fcber das Gateway ausf\u00fchren (oder --local eingebettet).

Erforderlich:

• --message <text>

Optionen:

• --to <dest> (f\u00fcr Session-Key und optionale Zustellung)
• --session-id <id>
• --thinking <off|minimal|low|medium|high|xhigh> (nur GPT-5.2 + Codex-Modelle)
• --verbose <on|full|off>
• --channel <whatsapp|telegram|discord|slack|mattermost|signal|imessage|msteams>
• --local
• --deliver
• --json
• --timeout <seconds>

agents

Isolierte Agents verwalten (Workspaces + Auth + Routing).

agents list

Konfigurierte Agents auflisten.

Optionen:

• --json
• --bindings

agents add [name]

Einen neuen isolierten Agent hinzuf\u00fcgen. F\u00fchrt den gef\u00fchrten Assistenten aus, es sei denn, Flags (oder --non-interactive) werden \u00fcbergeben; --workspace ist im nicht-interaktiven Modus erforderlich.

Optionen:

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

Binding-Specs verwenden channel[:accountId]. Wenn accountId weggelassen wird, kann OpenClaw den Account-Scope \u00fcber Channel-Defaults/Plugin-Hooks aufl\u00f6sen; andernfalls ist es ein Channel-Binding ohne expliziten Account-Scope.

agents bindings

Routing-Bindings auflisten.

Optionen:

• --agent <id>
• --json

agents bind

Routing-Bindings f\u00fcr einen Agent hinzuf\u00fcgen.

Optionen:

• --agent <id>
• --bind <channel[:accountId]> (wiederholbar)
• --json

agents unbind

Routing-Bindings f\u00fcr einen Agent entfernen.

Optionen:

• --agent <id>
• --bind <channel[:accountId]> (wiederholbar)
• --all
• --json

agents delete <id>

Einen Agent l\u00f6schen und seinen Workspace + State bereinigen.

Optionen:

• --force
• --json

acp

Die ACP-Bridge starten, die IDEs mit dem Gateway verbindet.

Siehe acp f\u00fcr vollst\u00e4ndige Optionen und Beispiele.

status

Verkn\u00fcpfte Session-Health und aktuelle Empf\u00e4nger anzeigen.

Optionen:

• --json
• --all (vollst\u00e4ndige Diagnose; schreibgesch\u00fctzt, kopierbar)
• --deep (Channels pr\u00fcfen)
• --usage (Model-Provider-Usage/Quota anzeigen)
• --timeout <ms>
• --verbose
• --debug (Alias f\u00fcr --verbose)

Hinweise:

• Die \u00dcbersicht enth\u00e4lt Gateway- + Node-Host-Servicestatus, wenn verf\u00fcgbar.

Usage-Tracking

OpenClaw kann Provider-Usage/Quota anzeigen, wenn OAuth/API-Anmeldeinformationen verf\u00fcgbar sind.

Wo angezeigt:

• /status (f\u00fcgt eine kurze Provider-Usage-Zeile hinzu, wenn verf\u00fcgbar)
• openclaw status --usage (gibt vollst\u00e4ndige Provider-Aufschl\u00fcsselung aus)
• macOS-Men\u00fcleiste (Usage-Abschnitt unter Context)

Hinweise:

• Daten kommen direkt von Provider-Usage-Endpoints (keine Sch\u00e4tzungen).
• Provider: Anthropic, GitHub Copilot, OpenAI Codex OAuth, plus Gemini CLI/Antigravity wenn diese Provider-Plugins aktiviert sind.
• Wenn keine passenden Anmeldeinformationen existieren, wird Usage ausgeblendet.
• Details: siehe Usage tracking.

health

Health-Informationen vom laufenden Gateway abrufen.

Optionen:

• --json
• --timeout <ms>
• --verbose

sessions

Gespeicherte Gespr\u00e4chssessions auflisten.

Optionen:

• --json
• --verbose
• --store <path>
• --active <minutes>

Zur\u00fccksetzen / Deinstallieren

reset

Lokale Config/State zur\u00fccksetzen (CLI bleibt installiert).

Optionen:

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

Hinweise:

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

uninstall

Gateway-Service + lokale Daten deinstallieren (CLI bleibt).

Optionen:

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

Hinweise:

• --non-interactive erfordert --yes und explizite Scopes (oder --all).

Gateway

gateway

Den WebSocket-Gateway starten.

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 (Dev-Config + Anmeldeinformationen + Sessions + Workspace zur\u00fccksetzen)
• --force (bestehenden Listener auf dem Port beenden)
• --verbose
• --claude-cli-logs
• --ws-log <auto|full|compact>
• --compact (Alias f\u00fcr --ws-log compact)
• --raw-stream
• --raw-stream-path <path>

gateway service

Den Gateway-Service verwalten (launchd/systemd/schtasks).

Unterbefehle:

• gateway status (pr\u00fcft standardm\u00e4\u00dfig den Gateway-RPC)
• gateway install (Service-Installation)
• gateway uninstall
• gateway start
• gateway stop
• gateway restart

Hinweise:

• gateway status pr\u00fcft standardm\u00e4\u00dfig den Gateway-RPC unter Verwendung des aufgel\u00f6sten Ports/Config des Service (\u00fcberschreibe mit --url/--token/--password).
• gateway status unterst\u00fctzt --no-probe, --deep und --json f\u00fcr Scripting.
• gateway status zeigt auch Legacy- oder zus\u00e4tzliche Gateway-Services, wenn sie erkannt werden (--deep f\u00fcgt System-Level-Scans hinzu). Profilbenannte OpenClaw-Services werden als erste Klasse behandelt und nicht als “extra” markiert.
• gateway status gibt aus, welchen Config-Pfad die CLI verwendet vs. welche Config der Service wahrscheinlich verwendet (Service-Env), plus die aufgel\u00f6ste Probe-Ziel-URL.
• Bei Linux-systemd-Installationen lesen Status-Token-Drift-Checks sowohl Environment=- als auch EnvironmentFile=-Werte aus der Unit (einschlie\u00dflich %h, quotierte Pfade, mehrere Dateien und optionale --Dateien).
• gateway install|uninstall|start|stop|restart unterst\u00fctzen --json f\u00fcr Scripting (Standard-Ausgabe bleibt menschenfreundlich).
• gateway install verwendet standardm\u00e4\u00dfig Node-Runtime; bun wird nicht empfohlen (WhatsApp/Telegram-Bugs).
• gateway install-Optionen: --port, --runtime, --token, --force, --json.

logs

Gateway-Datei-Logs \u00fcber RPC verfolgen.

Hinweise:

• TTY-Sessions rendern eine farbige, strukturierte Ansicht; Nicht-TTY f\u00e4llt auf reinen Text zur\u00fcck.
• --json gibt zeilengetrenntes JSON aus (ein Log-Event pro Zeile).

Beispiele:

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

gateway <subcommand>

Gateway-CLI-Helfer (verwende --url, --token, --password, --timeout, --expect-final f\u00fcr RPC-Unterbefehle). Wenn du --url \u00fcbergibst, wendet die CLI nicht automatisch Config- oder Umgebungs-Anmeldeinformationen an. \u00dcbergib --token oder --password explizit. Fehlende explizite Anmeldeinformationen sind ein Fehler.

Unterbefehle:

• gateway call <method> [--params <json>]
• gateway health
• gateway status
• gateway probe
• gateway discover
• gateway install|uninstall|start|stop|restart
• gateway run

H\u00e4ufige RPCs:

• config.apply (Config validieren + schreiben + neustarten + aufwecken)
• config.patch (Partial-Update mergen + neustarten + aufwecken)
• update.run (Update ausf\u00fchren + neustarten + aufwecken)

Tipp: Beim direkten Aufrufen von config.set/config.apply/config.patch \u00fcbergib baseHash von config.get, wenn eine Config bereits existiert.

Modelle

Siehe /concepts/models f\u00fcr Fallback-Verhalten und Scan-Strategie.

Anthropic setup-token (unterst\u00fctzt):

claude setup-token
openclaw models auth setup-token --provider anthropic
openclaw models status

Policy-Hinweis: Dies ist technische Kompatibilit\u00e4t. Anthropic hat in der Vergangenheit einige Abonnement-Nutzung au\u00dferhalb von Claude Code blockiert; pr\u00fcfe die aktuellen Anthropic- Nutzungsbedingungen, bevor du auf setup-token in der Produktion vertraust.

models (Root)

openclaw models ist ein Alias f\u00fcr models status.

Root-Optionen:

• --status-json (Alias f\u00fcr models status --json)
• --status-plain (Alias f\u00fcr models status --plain)

models list

Optionen:

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

models status

Optionen:

• --json
• --plain
• --check (Exit 1=abgelaufen/fehlend, 2=l\u00e4uft ab)
• --probe (Live-Probe konfigurierter Auth-Profile)
• --probe-provider <name>
• --probe-profile <id> (wiederholbar oder kommagetrennt)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>

Enth\u00e4lt immer die Auth-\u00dcbersicht und den OAuth-Ablaufstatus f\u00fcr Profile im Auth-Store. --probe f\u00fchrt Live-Requests durch (kann Tokens verbrauchen und Rate-Limits ausl\u00f6sen).

models set <model>

agents.defaults.model.primary setzen.

models set-image <model>

agents.defaults.imageModel.primary setzen.

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|setup-token|paste-token

Optionen:

• add: Interaktiver Auth-Helfer
• setup-token: --provider <name> (Standard anthropic), --yes
• paste-token: --provider <name>, --profile-id <id>, --expires-in <duration>

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

Ein System-Event einreihen und optional einen Heartbeat ausl\u00f6sen (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

System-Presence-Eintr\u00e4ge auflisten (Gateway-RPC).

Optionen:

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

Cron

Geplante Jobs verwalten (Gateway-RPC). Siehe /automation/cron-jobs.

Unterbefehle:

• cron status [--json]
• cron list [--all] [--json] (Tabellenausgabe standardm\u00e4\u00dfig; verwende --json f\u00fcr raw)
• cron add (Alias: create; erfordert --name und genau eines von --at | --every | --cron, und genau ein 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> [--force]

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

Node-Host

node betreibt einen Headless-Node-Host oder verwaltet ihn als Hintergrunddienst. Siehe openclaw node.

Unterbefehle:

• 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

Auth-Hinweise:

• node l\u00f6st Gateway-Auth aus env/config auf (keine --token/--password-Flags): OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD, dann gateway.auth.*. Im lokalen Modus ignoriert der Node-Host absichtlich gateway.remote.*; bei gateway.mode=remote nimmt gateway.remote.* gem\u00e4\u00df Remote-Vorrangregeln teil.
• Legacy-CLAWDBOT_GATEWAY_*-Umgebungsvariablen werden absichtlich f\u00fcr Node-Host-Auth-Aufl\u00f6sung ignoriert.

Nodes

nodes kommuniziert mit dem Gateway und steuert gekoppelte Nodes. Siehe /nodes.

H\u00e4ufige Optionen:

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

Unterbefehle:

• nodes status [--connected] [--last-connected <duration>]
• nodes describe --node <id|name|ip>
• nodes list [--connected] [--last-connected <duration>]
• nodes pending
• nodes approve <requestId>
• nodes reject <requestId>
• nodes rename --node <id|name|ip> --name <displayName>
• nodes invoke --node <id|name|ip> --command <command> [--params <json>] [--invoke-timeout <ms>] [--idempotency-key <key>]
• nodes run --node <id|name|ip> [--cwd <path>] [--env KEY=VAL] [--command-timeout <ms>] [--needs-screen-recording] [--invoke-timeout <ms>] <command...> (Mac-Node oder Headless-Node-Host)
• nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>] (nur Mac)

Kamera:

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

Canvas + Screen:

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

Standort:

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

Browser

Browser-Steuerungs-CLI (dediziertes Chrome/Brave/Edge/Chromium). Siehe openclaw browser und das Browser tool.

H\u00e4ufige Optionen:

• --url, --token, --timeout, --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>]
• 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 <left|right|middle>] [--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 <error|warn|info>] [--target-id <id>]
• browser pdf [--target-id <id>]

Docs-Suche

docs [query...]

Den Live-Docs-Index durchsuchen.

TUI

tui

Das Terminal-UI verbunden mit dem Gateway \u00f6ffnen.

Optionen:

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