Skip to main content
Verwenden Sie diese Seite, wenn ein Node im Status sichtbar ist, die Node-Tools jedoch fehlschlagen.

​
Befehlsabfolge

Führen Sie anschließend Node-spezifische Prüfungen aus:
Anzeichen für einen fehlerfreien Zustand:
  • Der Node ist verbunden und für die Rolle node gekoppelt.
  • nodes describe enthält die aufgerufene Fähigkeit.
  • Die Ausführungsgenehmigungen zeigen den erwarteten Modus bzw. die erwartete Zulassungsliste.

​
Anforderungen an den Vordergrundbetrieb

canvas.*, camera.* und screen.* funktionieren auf iOS-/Android-Nodes nur im Vordergrund. Schnelle Prüfung und Fehlerbehebung:
Wenn NODE_BACKGROUND_UNAVAILABLE angezeigt wird, bringen Sie die Node-App in den Vordergrund und versuchen Sie es erneut.

​
Berechtigungsmatrix

​
Kopplung und Genehmigungen

Drei separate Kontrollstufen bestimmen, ob ein Node-Befehl erfolgreich ausgeführt wird:
  1. Gerätekopplung: Kann sich dieser Node mit dem Gateway verbinden?
  2. Gateway-Richtlinie für Node-Befehle: Ist die RPC-Befehls-ID durch gateway.nodes.commands.allow / gateway.nodes.commands.deny und die Plattformstandards erlaubt?
  3. Ausführungsgenehmigungen: Darf dieser Node einen bestimmten Shell-Befehl lokal ausführen?
Die Node-Kopplung ist eine Identitäts-/Vertrauensprüfung und keine Genehmigungsoberfläche für einzelne Befehle. Für system.run befindet sich die Node-spezifische Richtlinie in der Datei mit den Ausführungsgenehmigungen dieses Nodes (openclaw approvals get --node ...) und nicht im Kopplungsdatensatz des Gateways. Schnelle Prüfungen:
  • Kopplung fehlt: Genehmigen Sie zuerst das Node-Gerät.
  • In nodes describe fehlt ein Befehl: Prüfen Sie die Gateway-Richtlinie für Node-Befehle und ob der Node diesen Befehl beim Verbindungsaufbau tatsächlich deklariert hat.
  • Die Kopplung funktioniert, aber system.run schlägt fehl: Korrigieren Sie die Ausführungsgenehmigungen/Zulassungsliste auf diesem Node.
Bei genehmigungsabhängigen host=node-Ausführungen bindet das Gateway die Ausführung außerdem an den vorbereiteten kanonischen systemRunPlan. Wenn ein späterer Aufrufer den Befehl, das Arbeitsverzeichnis oder die Sitzungsmetadaten ändert, bevor die genehmigte Ausführung weitergeleitet wird, lehnt das Gateway die Ausführung wegen einer Abweichung von der Genehmigung ab, anstatt der bearbeiteten Nutzlast zu vertrauen.

​
Häufige Node-Fehlercodes

​
Schnelle Wiederherstellungsschleife

Falls 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 bildverarbeitungsfähiger Agent das Tool computer bereitstellt, ob screen.snapshot mit der Berechtigung zur Bildschirmaufnahme erfolgreich ausgeführt wird und ob /phone status die gewünschte temporäre oder dauerhafte Gateway-Autorisierung anzeigt. Ein Eintrag gateway.nodes.commands.deny überschreibt immer gateway.nodes.commands.allow.

​
Verwandte Themen