openclaw nodes

Verwalte gepaarte Nodes (Geräte) und rufe Node-Fähigkeiten auf.

Verwandte Themen:

• Nodes-Überblick: Nodes
• Kamera: Camera nodes
• Bilder: Image nodes

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 gibt Tabellen für ausstehende/gepaarte Nodes aus. Gepaarte Zeilen enthalten das Alter der letzten Verbindung (Last Connect). Verwende --connected, um nur aktuell verbundene Nodes anzuzeigen. Verwende --last-connected <duration>, um auf Nodes zu filtern, die sich innerhalb eines Zeitraums verbunden haben (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-String (Standard {}).
• --invoke-timeout <ms>: Node-Invoke-Timeout (Standard 15000).
• --idempotency-key <key>: Optionaler Idempotenz-Schlüssel.

Exec-Stil-Standardwerte

nodes run spiegelt das Exec-Verhalten des Modells wider (Standardwerte + Genehmigungen):

• Liest tools.exec.* (plus agents.list[].tools.exec.*-Überschreibungen).
• Verwendet 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 advertised (macOS-Companion-App oder Headless-Node-Host).

Flags:

• --cwd <path>: Arbeitsverzeichnis.
• --env <key=val>: Umgebungsvariablen-Überschreibung (wiederholbar). Hinweis: Node-Hosts ignorieren PATH-Überschreibungen (und tools.exec.pathPrepend wird nicht auf Node-Hosts angewendet).
• --command-timeout <ms>: Befehls-Timeout.
• --invoke-timeout <ms>: Node-Invoke-Timeout (Standard 30000).
• --needs-screen-recording: Screen-Recording-Berechtigung erforderlich.
• --raw <command>: Einen Shell-String ausführen (/bin/sh -lc oder cmd.exe /c). Im Allowlist-Modus auf Windows-Node-Hosts erfordern cmd.exe /c-Shell-Wrapper-Ausführungen eine Genehmigung (der Allowlist-Eintrag allein erlaubt die Wrapper-Form nicht automatisch).
• --agent <id>: Agentenbezogene Genehmigungen/Allowlists (Standard: konfigurierter Agent).
• --ask <off|on-miss|always>, --security <deny|allowlist|full>: Überschreibungen.