openclaw nodes

Verwalte gepaarte Nodes (Geräte) und führe Node-Funktionen aus.

Verwandte Themen:

Allgemeine Optionen:

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

Häufige Befehle

openclaw nodes list
openclaw nodes list --connected
openclaw nodes list --last-connected 24h
openclaw nodes pending
openclaw nodes approve <requestId>
openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h

nodes list zeigt Tabellen mit ausstehenden und gepaarten Nodes. Bei gepaarten Nodes siehst du auch, wann sie zuletzt verbunden waren (Last Connect). Mit --connected werden nur aktuell verbundene Nodes angezeigt. Mit --last-connected <duration> filterst du nach Nodes, die innerhalb eines Zeitraums verbunden waren (z.B. 24h, 7d).

Invoke / run

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>
openclaw nodes run --node <id|name|ip> <command...>
openclaw nodes run --raw "git status"
openclaw nodes run --agent main --node <id|name|ip> --raw "git status"

Invoke-Flags:

  • --params <json>: JSON-Objekt als String (Standard {}).
  • --invoke-timeout <ms>: Node-Invoke-Timeout (Standard 15000).
  • --idempotency-key <key>: optionaler Idempotency-Key.

Exec-Standardverhalten

nodes run verhält sich wie das Exec-Verhalten des Models (Standardwerte + Genehmigungen):

  • Liest tools.exec.* (plus agents.list[].tools.exec.* Overrides).
  • Nutzt Exec-Genehmigungen (exec.approval.request) vor dem Aufruf von system.run.
  • --node kann weggelassen werden, wenn tools.exec.node gesetzt ist.
  • Erfordert einen Node, der system.run anbietet (macOS Companion App oder Headless Node Host).

Flags:

  • --cwd <path>: Arbeitsverzeichnis.
  • --env <key=val>: Umgebungsvariablen-Override (wiederholbar).
  • --command-timeout <ms>: Befehl-Timeout.
  • --invoke-timeout <ms>: Node-Invoke-Timeout (Standard 30000).
  • --needs-screen-recording: erfordert Bildschirmaufnahme-Berechtigung.
  • --raw <command>: führt einen Shell-String aus (/bin/sh -lc oder cmd.exe /c).
  • --agent <id>: Agent-spezifische Genehmigungen/Allowlists (Standard ist der konfigurierte Agent).
  • --ask <off|on-miss|always>, --security <deny|allowlist|full>: Overrides.