Skip to main content
Use esta página cuando un nodo sea visible en el estado, pero las herramientas del nodo fallen.

​
Secuencia de comandos

A continuación, ejecute las comprobaciones específicas del nodo:
Indicadores de funcionamiento correcto:
  • El nodo está conectado y emparejado para el rol node.
  • nodes describe incluye la capacidad que se está invocando.
  • Las aprobaciones de ejecución muestran el modo o la lista de permitidos esperados.

​
Requisitos de primer plano

canvas.*, camera.* y screen.* solo funcionan en primer plano en nodos iOS/Android. Comprobación y solución rápidas:
Si aparece NODE_BACKGROUND_UNAVAILABLE, lleve la aplicación del nodo al primer plano y vuelva a intentarlo.

​
Matriz de permisos

​
Emparejamiento frente a aprobaciones

Tres controles independientes determinan si un comando de nodo se ejecuta correctamente:
  1. Emparejamiento del dispositivo: ¿puede este nodo conectarse al Gateway?
  2. Política de comandos de nodo del Gateway: ¿permiten gateway.nodes.commands.allow / gateway.nodes.commands.deny y los valores predeterminados de la plataforma el identificador del comando RPC?
  3. Aprobaciones de ejecución: ¿puede este nodo ejecutar localmente un comando de shell específico?
El emparejamiento de nodos es un control de identidad y confianza, no una interfaz de aprobación por comando. Para system.run, la política por nodo reside en el archivo de aprobaciones de ejecución de ese nodo (openclaw approvals get --node ...), no en el registro de emparejamiento del Gateway. Comprobaciones rápidas:
  • Falta el emparejamiento: apruebe primero el dispositivo del nodo.
  • A nodes describe le falta un comando: compruebe la política de comandos de nodo del Gateway y si el nodo declaró realmente ese comando al conectarse.
  • El emparejamiento es correcto, pero system.run falla: corrija las aprobaciones de ejecución o la lista de permitidos en ese nodo.
Para las ejecuciones de host=node respaldadas por aprobación, el Gateway también vincula la ejecución al systemRunPlan canónico preparado. Si posteriormente un invocador modifica el comando, el directorio de trabajo o los metadatos de la sesión antes de reenviar la ejecución aprobada, el Gateway rechaza la ejecución por discrepancia con la aprobación en lugar de confiar en la carga útil modificada.

​
Códigos de error habituales de los nodos

​
Bucle de recuperación rápida

Si el problema persiste:
  • Vuelva a aprobar el emparejamiento del dispositivo.
  • Vuelva a abrir la aplicación del nodo en primer plano.
  • Vuelva a conceder los permisos del sistema operativo.
  • Vuelva a crear o ajuste la política de aprobación de ejecución.
Para el control del equipo, verifique también que un agente con capacidad de visión exponga la herramienta computer, que screen.snapshot se ejecute correctamente con el permiso Grabación de pantalla y que /phone status muestre la autorización temporal o persistente del Gateway prevista. Una entrada gateway.nodes.commands.deny siempre prevalece sobre gateway.nodes.commands.allow.

​
Temas relacionados