openclaw nodes

Gekoppelte Nodes (Geräte) verwalten und Node-Funktionen aufrufen.

Verwandt:

• Nodes-Übersicht: Nodes
• Kamera: Kamera-Nodes
• Bilder: Bild-Nodes

Allgemeine Optionen:

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

Allgemeine Befehle

openclaw nodes listopenclaw nodes list --connectedopenclaw nodes list --last-connected 24hopenclaw nodes pendingopenclaw nodes approve <requestId>openclaw nodes reject <requestId>openclaw nodes remove --node <id|name|ip>openclaw nodes rename --node <id|name|ip> --name <displayName>openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24h

nodes list gibt Tabellen mit ausstehenden/gekoppelten Einträgen aus. Gekoppelte Zeilen enthalten das Alter der letzten Verbindung (Last Connect). Verwenden Sie --connected, um nur aktuell verbundene Nodes anzuzeigen. Verwenden Sie --last-connected <duration>, um auf Nodes zu filtern, die sich innerhalb einer Dauer verbunden haben (z. B. 24h, 7d). Verwenden Sie nodes remove --node <id|name|ip>, um eine Node-Kopplung zu entfernen. Bei einer gerätegestützten Node widerruft dies die node-Rolle des Geräts in devices/paired.json und trennt dessen Node-Rollen-Sitzungen (ein Gerät mit gemischten Rollen behält seine Zeile und verliert nur die node-Rolle; ein reines Node-Gerät wird gelöscht); außerdem werden alle passenden Legacy-Node-Kopplungsdatensätze im Besitz des Gateway gelöscht. operator.pairing kann Nicht-Operator-Node-Zeilen entfernen; ein Device-Token-Aufrufer, der seine eigene Node-Rolle auf einem Gerät mit gemischten Rollen widerruft, benötigt zusätzlich operator.admin.

Hinweis zur Genehmigung:

• openclaw nodes pending benötigt nur den Kopplungs-Scope.
• gateway.nodes.pairing.autoApproveCidrs kann den ausstehenden Schritt nur für ausdrücklich vertrauenswürdige, erstmalige role: node-Gerätekopplungen überspringen. Es ist standardmäßig deaktiviert und genehmigt keine Upgrades.
• openclaw nodes approve <requestId> übernimmt zusätzliche Scope-Anforderungen aus der ausstehenden Anfrage:
  • Anfrage ohne Befehl: nur Kopplung
  • Nicht-Exec-Node-Befehle: Kopplung + Schreibzugriff
  • system.run / system.run.prepare / system.which: Kopplung + Admin

Aufrufen

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>

Aufruf-Flags:

• --params <json>: JSON-Objektzeichenfolge (Standard {}).
• --invoke-timeout <ms>: Timeout für Node-Aufrufe (Standard 15000).
• --idempotency-key <key>: optionaler Idempotenzschlüssel.
• system.run und system.run.prepare sind hier blockiert; verwenden Sie für Shell-Ausführung das exec-Tool mit host=node.

Verwenden Sie für Shell-Ausführung auf einer Node das exec-Tool mit host=node anstelle von openclaw nodes run. Die nodes-CLI ist jetzt funktionsorientiert: direkter RPC über nodes invoke sowie Kopplung, Kamera, Bildschirm, Standort, Canvas und Benachrichtigungen. Canvas-Befehle werden vom gebündelten experimentellen Canvas-Plugin implementiert; Core behält einen Kompatibilitäts-Hook, damit sie weiterhin unter openclaw nodes canvas verfügbar bleiben.

Verwandt

• CLI-Referenz
• Nodes