openclaw nodes

Verwalten Sie gekoppelte Nodes (Geräte) und rufen Sie Node-Funktionen auf.

Verwandte Themen: Node-Übersicht - Aktive Computerpräsenz - Kamera-Nodes - Bild-Nodes

Allgemeine Optionen für jeden Unterbefehl: --url <url>, --token <token>, --timeout <ms> (Standardwert 10000), --json.

Status

openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24hopenclaw nodes listopenclaw nodes describe --node <idOrNameOrIp>

status und list akzeptieren beide --connected (nur verbundene Nodes) und --last-connected <duration> (z. B. 24h, 7d; nur Nodes, die innerhalb des Zeitraums verbunden waren). list zeigt ausstehende und gekoppelte Nodes in separaten Tabellen, wobei die Zeilen gekoppelter Nodes das Alter der letzten Verbindung (Last Connect) enthalten; status zeigt eine zusammengeführte Tabelle mit Angaben zu Funktionen, Version und letzter Eingabe für jeden Node. Ein verbundener macOS-Node meldet die letzte Eingabe erst, nachdem der Benutzer Aktive Computererkennung aktiviert und Bedienungshilfen gewährt hat; die aktuellste Zeile ist mit active gekennzeichnet. Siehe Aktive Computerpräsenz. describe gibt die Funktionen, Berechtigungen, Aktivität sowie die wirksamen und ausstehenden Aufrufbefehle eines Nodes aus.

Kopplung

openclaw 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>

Diese Befehle steuern den Gateway-eigenen Speicher node.pair.*, der von der Gerätekopplung (openclaw devices approve) getrennt ist, welche den WS-Handshake connect des Nodes kontrolliert. Unter Nodes wird erläutert, wie beide zusammenhängen.

• remove widerruft den Eintrag für die gekoppelte Rolle des Nodes. Bei einem gerätegestützten Node wird dadurch die Rolle node im Speicher für Gerätekopplungen widerrufen und seine Sitzungen mit der Node-Rolle werden getrennt: Ein Gerät mit gemischten Rollen behält seine Zeile und verliert nur die Rolle node, während die Zeile eines Geräts, das ausschließlich als Node dient, gelöscht wird. Außerdem werden alle übereinstimmenden Legacy-Kopplungseinträge für Gateway-eigene Nodes entfernt.
• pending benötigt lediglich den Geltungsbereich operator.pairing.
• gateway.nodes.pairing.autoApproveCidrs kann den ausstehenden Schritt bei der erstmaligen Kopplung eines ausdrücklich vertrauenswürdigen Geräts vom Typ role: node überspringen. Standardmäßig deaktiviert; Rollen-Upgrades werden nicht genehmigt.
• gateway.nodes.pairing.sshVerify (standardmäßig aktiviert) genehmigt automatisch die erstmalige Kopplung eines Geräts vom Typ role: node, wenn der Gateway den Geräteschlüssel über SSH zum Node-Host verifizieren kann; die erste Funktionsoberfläche wird im selben Schritt genehmigt. Siehe Node-Kopplung.
• Die Anforderungen an den Geltungsbereich von approve richten sich nach den in der ausstehenden Anfrage deklarierten Befehlen:
  • Anfrage ohne Befehl: operator.pairing
  • gewöhnliche Node-Befehle: operator.pairing + operator.write
  • administrativ sensible Befehle (system.run, system.run.prepare, system.which, browser.proxy, fs.listDir und system.execApprovals.get/set): operator.pairing + operator.admin
• Geltungsbereich von remove: operator.pairing kann Node-Zeilen entfernen, die nicht zu Operatoren gehören; ein Aufrufer mit Geräte-Token, der seine eigene Node-Rolle auf einem Gerät mit gemischten Rollen widerruft, benötigt zusätzlich operator.admin.

Aufrufen

openclaw nodes invoke --node <id> --command system.which --params '{"bins":["uname"]}'

Optionen:

• --command <command> (erforderlich): z. B. canvas.eval.
• --params <json>: JSON-Objekt als Zeichenfolge (Standardwert {}).
• --invoke-timeout <ms>: Zeitüberschreitung für den Node-Aufruf (Standardwert 15000).
• --idempotency-key <key>: optionaler Idempotenzschlüssel.

system.run und system.run.prepare sind hier gesperrt; verwenden Sie stattdessen das Tool exec mit host=node zur Shell-Ausführung. system.which ist über invoke zulässig.

Benachrichtigung, Push, Standort, Bildschirm

openclaw nodes notify --node <id> --title "Build" --body "Done" --priority timeSensitiveopenclaw nodes push --node <id> --title "OpenClaw" --environment sandboxopenclaw nodes location get --node <id> --accuracy preciseopenclaw nodes screen record --node <id> --duration 10s --fps 10 --out ./clip.mp4

• notify sendet eine lokale Benachrichtigung an einen Node, der system.notify deklariert, einschließlich macOS-, iOS-, Android- und direkter watchOS-Nodes. Für die direkte Zustellung an watchOS muss OpenClaw aktiv sein. Erfordert --title oder --body. Optionen: --sound <name>, --priority <passive|active|timeSensitive>, --delivery <system|overlay|auto> (Standardwert system), --invoke-timeout <ms> (Standardwert 15000).
• push sendet einen APNs-Test-Push an einen iOS-Node. Optionen: --title <text> (Standardwert OpenClaw), --body <text>, --environment <sandbox|production> zum Überschreiben der erkannten APNs-Umgebung.
• location get ruft den aktuellen Standort des Nodes ab. Optionen: --max-age <ms> (eine zwischengespeicherte Positionsbestimmung wiederverwenden), --accuracy <coarse|balanced|precise>, --location-timeout <ms> (Standardwert 10000), --invoke-timeout <ms> (Standardwert 20000).
• screen record zeichnet einen kurzen Clip auf und gibt den Speicherpfad aus (oder schreibt mit --json JSON). Optionen: --screen <index> (Standardwert 0), --duration <ms|10s> (Standardwert 10000), --fps <fps> (Standardwert 10), --no-audio, --out <path>, --invoke-timeout <ms> (Standardwert 120000).

Für Kamera- und Canvas-Befehle gibt es eigene Dokumentationen: Kamera-Nodes, Canvas. Canvas wird durch das gebündelte experimentelle Canvas-Plugin implementiert; der Core behält openclaw nodes canvas als Kompatibilitäts-Einhängepunkt bei.

Verwandte Themen

• CLI-Referenz
• Nodes