CLI-Referenz

Diese Seite beschreibt das aktuelle CLI-Verhalten. Wenn sich Befehle ändern, aktualisiere diese Dokumentation.

Befehlsseiten

Globale Flags

  • --dev: Status unter ~/.openclaw-dev isolieren und Standard-Ports verschieben.
  • --profile <name>: Status unter ~/.openclaw-<name> isolieren.
  • --no-color: ANSI-Farben deaktivieren.
  • --update: Kurzform für openclaw update (nur bei 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ützten Terminals als klickbare Links angezeigt; ansonsten werden einfache URLs verwendet.
  • --json (und --plain wo unterstützt) deaktiviert Styling für saubere Ausgabe.
  • --no-color deaktiviert ANSI-Styling; NO_COLOR=1 wird ebenfalls berücksichtigt.
  • Lang laufende Befehle zeigen eine Fortschrittsanzeige (OSC 9;4 wenn unterstützt).

Farbpalette

OpenClaw verwendet eine Lobster-Palette für die CLI-Ausgabe.

  • accent (#FF5A2D): Überschriften, Labels, primäre Hervorhebungen.
  • accentBright (#FF7A3D): Befehlsnamen, Betonungen.
  • accentDim (#D14A22): Sekundärer Hervorhebungstext.
  • info (#FF8A5B): Informationswerte.
  • success (#2FBF71): Erfolgszustände.
  • warn (#FFB020): Warnungen, Fallbacks, Aufmerksamkeit.
  • error (#E23D2D): Fehler, Fehlschläge.
  • muted (#8B7F77): Abgeschwächt, Metadaten.

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

Befehlsbaum

openclaw [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
  doctor
  security
    audit
  reset
  uninstall
  update
  channels
    list
    status
    logs
    add
    remove
    login
    logout
  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
  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
  docs
  dns
    setup
  tui

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

Security

  • openclaw security audit — Konfiguration und lokalen Status auf häufige Sicherheitsprobleme prüfen.
  • openclaw security audit --deep — Best-Effort Live-Gateway-Prüfung.
  • openclaw security audit --fix — Sichere Standardwerte setzen und chmod auf Status/Konfiguration anwenden.

Plugins

Erweiterungen und deren Konfiguration verwalten:

  • openclaw plugins list — Plugins entdecken (nutze --json für maschinenlesbare Ausgabe).
  • openclaw plugins info <id> — Details zu einem Plugin anzeigen.
  • openclaw plugins install <path|.tgz|npm-spec> — Plugin installieren (oder Plugin-Pfad zu plugins.load.paths hinzufügen).
  • openclaw plugins enable <id> / disable <id>plugins.entries.<id>.enabled umschalten.
  • openclaw plugins doctor — Plugin-Ladefehler melden.

Die meisten Plugin-Änderungen erfordern einen Gateway-Neustart. Siehe /plugin.

Memory

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

  • openclaw memory status — Index-Statistiken anzeigen.
  • openclaw memory index — Memory-Dateien neu indizieren.
  • openclaw memory search "<query>" — Semantische Suche über Memory.

Chat-Slash-Befehle

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

Highlights:

  • /status für schnelle Diagnose.
  • /config für persistente Konfigurationsänderungen.
  • /debug für Runtime-Only-Konfigurationsüberschreibungen (Memory, nicht Disk; erfordert commands.debug: true).

Setup + Onboarding

setup

Konfiguration und Workspace initialisieren.

Optionen:

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

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

onboard

Interaktiver Wizard zum Einrichten von Gateway, Workspace und Skills.

Optionen:

  • --workspace <dir>
  • --reset (Konfiguration + Credentials + Sessions + Workspace vor dem Wizard zurücksetzen)
  • --non-interactive
  • --mode <local|remote>
  • --flow <quickstart|advanced|manual> (manual ist ein Alias für advanced)
  • --auth-choice <setup-token|token|chutes|openai-codex|openai-api-key|openrouter-api-key|ai-gateway-api-key|moonshot-api-key|kimi-code-api-key|synthetic-api-key|venice-api-key|gemini-api-key|zai-api-key|apiKey|minimax-api|minimax-api-lightning|opencode-zen|skip>
  • --token-provider <id> (non-interactive; verwendet mit --auth-choice token)
  • --token <token> (non-interactive; verwendet mit --auth-choice token)
  • --token-profile-id <id> (non-interactive; Standard: <provider>:manual)
  • --token-expires-in <duration> (non-interactive; z.B. 365d, 12h)
  • --anthropic-api-key <key>
  • --openai-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>
  • --gateway-port <port>
  • --gateway-bind <loopback|lan|tailnet|auto|custom>
  • --gateway-auth <token|password>
  • --gateway-token <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-health
  • --skip-ui
  • --node-manager <npm|pnpm|bun> (pnpm empfohlen; bun nicht empfohlen für Gateway-Runtime)
  • --json

configure

Interaktiver Konfigurations-Wizard (Models, Channels, Skills, Gateway).

config

Nicht-interaktive Konfigurations-Helfer (get/set/unset). openclaw config ohne Unterbefehl startet den Wizard.

Unterbefehle:

  • config get <path>: Konfigurationswert ausgeben (Punkt/Klammer-Pfad).
  • config set <path> <value>: Wert setzen (JSON5 oder Raw-String).
  • config unset <path>: Wert entfernen.

doctor

Gesundheitschecks und schnelle Fixes (Konfiguration + Gateway + Legacy-Services).

Optionen:

  • --no-workspace-suggestions: Workspace-Memory-Hinweise deaktivieren.
  • --yes: Standardwerte ohne Nachfrage akzeptieren (headless).
  • --non-interactive: Eingabeaufforderungen überspringen; nur sichere Migrationen anwenden.
  • --deep: System-Services nach zusätzlichen 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-Gesundheit prüfen (--probe führt zusätzliche Checks durch; nutze openclaw health oder openclaw status --deep für Gateway-Health-Probes).
  • Tipp: channels status gibt Warnungen mit Lösungsvorschlägen aus, wenn häufige Fehlkonfigurationen erkannt werden (und verweist dann auf openclaw doctor).
  • channels logs: Aktuelle Channel-Logs aus der Gateway-Logdatei anzeigen.
  • channels add: Wizard-Style-Setup wenn keine Flags übergeben werden; Flags schalten auf nicht-interaktiven Modus um.
  • channels remove: Standardmäßig deaktivieren; --delete übergeben um Konfigurationseinträge ohne Nachfrage zu entfernen.
  • channels login: Interaktiver Channel-Login (nur WhatsApp Web).
  • channels logout: Von einer Channel-Session abmelden (falls unterstützt).

Allgemeine Optionen:

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

channels login Optionen:

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

channels logout Optionen:

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

channels list Optionen:

  • --no-usage: Model-Provider-Usage/Quota-Snapshots überspringen (nur OAuth/API-basiert).
  • --json: JSON ausgeben (enthält Usage außer wenn --no-usage gesetzt ist).

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ügbare Skills und Bereitschaftsinfos auflisten und inspizieren.

Unterbefehle:

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

Optionen:

  • --eligible: Nur bereite Skills anzeigen.
  • --json: JSON ausgeben (ohne Styling).
  • -v, --verbose: Details zu fehlenden Anforderungen einschließen.

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

pairing

DM-Pairing-Anfragen über Channels genehmigen.

Unterbefehle:

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

webhooks gmail

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

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-Überschreibungen für dieselben Flags)

dns setup

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

Optionen:

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

Messaging + Agent

message

Einheitliches ausgehendes Messaging und 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 über das Gateway ausführen (oder --local eingebettet).

Erforderlich:

  • --message <text>

Optionen:

  • --to <dest> (für 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]

Neuen isolierten Agent hinzufügen. Startet den geführten Wizard außer wenn 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-Specs verwenden channel[:accountId]. Wenn accountId für WhatsApp weggelassen wird, wird die Standard-Account-ID verwendet.

agents delete <id>

Agent löschen und dessen Workspace + Status bereinigen.

Optionen:

  • --force
  • --json

acp

Die ACP-Bridge ausführen, die IDEs mit dem Gateway verbindet.

Siehe acp für alle Optionen und Beispiele.

status

Verknüpfte Session-Gesundheit und aktuelle Empfänger anzeigen.

Optionen:

  • --json
  • --all (vollständige Diagnose; nur-lesen, kopierbar)
  • --deep (Channels prüfen)
  • --usage (Model-Provider-Usage/Quota anzeigen)
  • --timeout <ms>
  • --verbose
  • --debug (Alias für --verbose)

Hinweise:

  • Übersicht enthält Gateway- und Node-Host-Service-Status wenn verfügbar.

Usage-Tracking

OpenClaw kann Provider-Usage/Quota anzeigen, wenn OAuth/API-Credentials verfügbar sind.

Oberflächen:

  • /status (fügt eine kurze Provider-Usage-Zeile hinzu wenn verfügbar)
  • openclaw status --usage (gibt vollständige Provider-Aufschlüsselung aus)
  • macOS-Menüleiste (Usage-Abschnitt unter Context)

Hinweise:

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

health

Gesundheit vom laufenden Gateway abrufen.

Optionen:

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

sessions

Gespeicherte Konversations-Sessions auflisten.

Optionen:

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

Reset / Uninstall

reset

Lokale Konfiguration/Status zurücksetzen (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 und 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

Das WebSocket-Gateway ausführen.

Optionen:

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

gateway service

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

Unterbefehle:

  • gateway status (prüft standardmäßig das Gateway-RPC)
  • gateway install (Service installieren)
  • gateway uninstall
  • gateway start
  • gateway stop
  • gateway restart

Hinweise:

  • gateway status prüft standardmäßig das Gateway-RPC mit dem aufgelösten Port/Konfiguration des Services (überschreiben mit --url/--token/--password).
  • gateway status unterstützt --no-probe, --deep und --json für Scripting.
  • gateway status zeigt auch Legacy- oder zusätzliche Gateway-Services an, wenn sie erkannt werden (--deep fügt System-Level-Scans hinzu). Profil-benannte OpenClaw-Services werden als erstklassig behandelt und nicht als “extra” markiert.
  • gateway status gibt aus, welchen Konfigurationspfad die CLI verwendet vs. welche Konfiguration der Service wahrscheinlich verwendet (Service-Env), plus die aufgelöste Probe-Ziel-URL.
  • gateway install|uninstall|start|stop|restart unterstützen --json für Scripting (Standard-Ausgabe bleibt benutzerfreundlich).
  • gateway install verwendet standardmäßig Node-Runtime; bun wird nicht empfohlen (WhatsApp/Telegram-Bugs).
  • gateway install Optionen: --port, --runtime, --token, --force, --json.

logs

Gateway-Datei-Logs über RPC verfolgen.

Hinweise:

  • TTY-Sessions rendern eine farbige, strukturierte Ansicht; Nicht-TTY fällt auf Klartext zurück.
  • --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 (nutze --url, --token, --password, --timeout, --expect-final für RPC-Unterbefehle).

Unterbefehle:

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

Häufige RPCs:

  • config.apply (validieren + Konfiguration schreiben + neustarten + aufwecken)
  • config.patch (partielles Update mergen + neustarten + aufwecken)
  • update.run (Update ausführen + neustarten + aufwecken)

Tipp: Beim direkten Aufrufen von config.set/config.apply/config.patch, übergib baseHash von config.get wenn bereits eine Konfiguration existiert.

Models

Siehe /concepts/models für Fallback-Verhalten und Scan-Strategie.

Bevorzugte Anthropic-Auth (setup-token):

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

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/fehlend, 2=läuft ab)
  • --probe (Live-Prüfung konfigurierter Auth-Profile)
  • --probe-provider <name>
  • --probe-profile <id> (wiederholbar oder kommagetrennt)
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>

Enthält immer die Auth-Übersicht und OAuth-Ablaufstatus für Profile im Auth-Store. --probe führt Live-Anfragen aus (kann Tokens verbrauchen und Rate-Limits auslösen).

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

System-Event einreihen und optional einen Heartbeat auslösen (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äge 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äßig; nutze --json für Raw)
  • cron add (Alias: create; erfordert --name und genau eines von --at | --every | --cron, und genau 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> [--force]

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

Node Host

node führt einen Headless Node Host aus oder verwaltet ihn als Hintergrund-Service. 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

Nodes

nodes kommuniziert mit dem Gateway und zielt auf gepaarte Nodes. Siehe /nodes.

Allgemeine 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)

Camera:

  • 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>]

Location:

  • 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.

Allgemeine 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 öffnen, das mit dem Gateway verbunden ist.

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>