Nodes and media
Node-Fehlerbehebung
Verwenden Sie diese Seite, wenn eine Node im Status sichtbar ist, Node-Tools jedoch fehlschlagen.
Befehlsabfolge
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeFühren Sie anschließend Node-spezifische Prüfungen aus:
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>Anzeichen für einen fehlerfreien Zustand:
- Die Node ist verbunden und für die Rolle
nodegekoppelt. nodes describeenthält die aufgerufene Funktion.- Die Ausführungsgenehmigungen zeigen den erwarteten Modus und die erwartete Zulassungsliste.
Anforderungen an den Vordergrund
canvas.*, camera.* und screen.* funktionieren auf iOS-/Android-Nodes nur im Vordergrund.
Schnellprüfung und Fehlerbehebung:
openclaw nodes describe --node <idOrNameOrIp>openclaw nodes canvas snapshot --node <idOrNameOrIp>openclaw logs --followWenn NODE_BACKGROUND_UNAVAILABLE angezeigt wird, bringen Sie die Node-App in den Vordergrund und versuchen Sie es erneut.
Berechtigungsmatrix
| Funktion | iOS | Android | macOS-Node-App | Typischer Fehlercode |
|---|---|---|---|---|
camera.snap, camera.clip |
Kamera (+ Mikrofon für Audio in Clips) | Kamera (+ Mikrofon für Audio in Clips) | Kamera (+ Mikrofon für Audio in Clips) | *_PERMISSION_REQUIRED |
screen.record |
Bildschirmaufnahme (+ optional Mikrofon) | Aufforderung zur Bildschirmaufnahme (+ optional Mikrofon) | Bildschirmaufnahme | *_PERMISSION_REQUIRED |
computer.act |
nicht verfügbar | nicht verfügbar | Bedienungshilfen + Bildschirmaufnahme | COMPUTER_DISABLED, ACCESSIBILITY_REQUIRED |
location.get |
Beim Verwenden oder immer (je nach Modus) | Standortzugriff im Vorder-/Hintergrund je nach Modus | Standortberechtigung | LOCATION_PERMISSION_REQUIRED |
system.run |
nicht verfügbar (Pfad auf dem Node-Host) | nicht verfügbar (Pfad auf dem Node-Host) | Ausführungsgenehmigungen erforderlich | SYSTEM_RUN_DENIED |
Kopplung und Genehmigungen
Drei separate Kontrollstufen bestimmen, ob ein Node-Befehl erfolgreich ausgeführt wird:
- Gerätekopplung: Kann diese Node eine Verbindung zum Gateway herstellen?
- Richtlinie für Node-Befehle des Gateways: Ist die RPC-Befehls-ID gemäß
gateway.nodes.allowCommands/denyCommandsund den Plattformstandards zulässig? - Ausführungsgenehmigungen: Darf diese Node einen bestimmten Shell-Befehl lokal ausführen?
Die Node-Kopplung ist eine Identitäts-/Vertrauenskontrolle und keine Genehmigungsoberfläche für einzelne Befehle. Für system.run befindet sich die Node-spezifische Richtlinie in der Ausführungsgenehmigungsdatei dieser Node (openclaw approvals get --node ...) und nicht im Kopplungsdatensatz des Gateways.
Schnellprüfungen:
openclaw devices listopenclaw nodes statusopenclaw approvals get --node <idOrNameOrIp>openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"- Kopplung fehlt: Genehmigen Sie zuerst das Node-Gerät.
- In
nodes describefehlt ein Befehl: Prüfen Sie die Richtlinie für Node-Befehle des Gateways und ob die Node diesen Befehl beim Verbindungsaufbau tatsächlich deklariert hat. - Die Kopplung funktioniert, aber
system.runschlägt fehl: Korrigieren Sie die Ausführungsgenehmigungen/Zulassungsliste auf dieser Node.
Bei genehmigungsbasierten Ausführungen mit host=node bindet das Gateway die Ausführung außerdem an den vorbereiteten, kanonischen systemRunPlan. Wenn ein nachgelagerter Aufrufer den Befehl, das Arbeitsverzeichnis oder die Sitzungsmetadaten verändert, bevor die genehmigte Ausführung weitergeleitet wird, lehnt das Gateway die Ausführung wegen einer Abweichung von der Genehmigung ab, anstatt den bearbeiteten Nutzdaten zu vertrauen.
Häufige Node-Fehlercodes
| Code | Bedeutung |
|---|---|
NODE_BACKGROUND_UNAVAILABLE |
Die App befindet sich im Hintergrund; bringen Sie sie in den Vordergrund. |
CAMERA_DISABLED |
Der Kameraschalter ist in den Node-Einstellungen deaktiviert. |
*_PERMISSION_REQUIRED |
Die Betriebssystemberechtigung fehlt oder wurde verweigert. |
LOCATION_DISABLED |
Der Standortmodus ist deaktiviert. |
LOCATION_PERMISSION_REQUIRED |
Der angeforderte Standortmodus wurde nicht gewährt. |
LOCATION_BACKGROUND_UNAVAILABLE |
Die App befindet sich im Hintergrund, aber es liegt nur die Berechtigung „Beim Verwenden“ vor. |
COMPUTER_DISABLED |
Aktivieren Sie Allow Computer Control in der macOS-App und genehmigen Sie anschließend die Aktualisierung der Kopplung. |
ACCESSIBILITY_REQUIRED |
Gewähren Sie dem aktuellen OpenClaw-App-Bundle in den macOS-Systemeinstellungen Zugriff auf die Bedienungshilfen. |
SYSTEM_RUN_DENIED: approval required |
Die Ausführungsanforderung benötigt eine ausdrückliche Genehmigung. |
SYSTEM_RUN_DENIED: allowlist miss |
Der Befehl wird durch den Zulassungslistenmodus blockiert. Auf Windows-Node-Hosts gelten Shell-Wrapper-Formen wie cmd.exe /c ... im Zulassungslistenmodus als nicht in der Zulassungsliste enthalten, sofern sie nicht über den Rückfrageablauf genehmigt wurden. |
Schnelle Wiederherstellungsschleife
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>openclaw logs --followWenn das Problem weiterhin besteht:
- Genehmigen Sie die Gerätekopplung erneut.
- Öffnen Sie die Node-App erneut im Vordergrund.
- Erteilen Sie die Betriebssystemberechtigungen erneut.
- Erstellen Sie die Richtlinie für Ausführungsgenehmigungen neu oder passen Sie sie an.
Prüfen Sie für die Computersteuerung außerdem, ob ein für visuelle Verarbeitung geeigneter Agent das Tool computer bereitstellt, screen.snapshot mit der Berechtigung zur Bildschirmaufnahme erfolgreich ausgeführt wird und /phone status die von Ihnen vorgesehene temporäre oder dauerhafte Gateway-Autorisierung anzeigt. Ein Eintrag in gateway.nodes.denyCommands hat immer Vorrang vor allowCommands.
