Skip to main content
Usa questa pagina quando un Node è visibile nello stato, ma gli strumenti del Node non funzionano.

​
Sequenza di comandi

Quindi esegui i controlli specifici del Node:
Segnali di funzionamento corretto:
  • Il Node è connesso e associato per il ruolo node.
  • nodes describe include la funzionalità che stai richiamando.
  • Le approvazioni di esecuzione mostrano la modalità e l’elenco consentito previsti.

​
Requisiti per l’esecuzione in primo piano

canvas.*, camera.* e screen.* funzionano solo in primo piano sui Node iOS/Android. Controllo e correzione rapidi:
Se viene visualizzato NODE_BACKGROUND_UNAVAILABLE, porta l’app del Node in primo piano e riprova.

​
Matrice delle autorizzazioni

​
Associazione e approvazioni

Tre controlli distinti determinano se un comando del Node viene eseguito correttamente:
  1. Associazione del dispositivo: questo Node può connettersi al Gateway?
  2. Criterio dei comandi Node del Gateway: l’ID del comando RPC è consentito da gateway.nodes.allowCommands / denyCommands e dalle impostazioni predefinite della piattaforma?
  3. Approvazioni di esecuzione: questo Node può eseguire localmente uno specifico comando shell?
L’associazione del Node è un controllo di identità e attendibilità, non un sistema di approvazione per singolo comando. Per system.run, il criterio specifico del Node si trova nel file delle approvazioni di esecuzione del Node (openclaw approvals get --node ...), non nel record di associazione del Gateway. Controlli rapidi:
  • Associazione mancante: approva prima il dispositivo Node.
  • Comando mancante in nodes describe: controlla il criterio dei comandi Node del Gateway e verifica che il Node abbia effettivamente dichiarato quel comando durante la connessione.
  • Associazione corretta ma system.run non riesce: correggi le approvazioni di esecuzione o l’elenco consentito su quel Node.
Per le esecuzioni host=node basate su approvazione, il Gateway vincola inoltre l’esecuzione al systemRunPlan canonico preparato. Se un chiamante successivo modifica il comando, la directory di lavoro o i metadati della sessione prima dell’inoltro dell’esecuzione approvata, il Gateway rifiuta l’esecuzione a causa di una mancata corrispondenza con l’approvazione, anziché considerare attendibile il payload modificato.

​
Codici di errore comuni dei Node

​
Procedura rapida di ripristino

Se il problema persiste:
  • Approva nuovamente l’associazione del dispositivo.
  • Riapri l’app del Node in primo piano.
  • Concedi nuovamente le autorizzazioni del sistema operativo.
  • Ricrea o modifica il criterio delle approvazioni di esecuzione.
Per il controllo del computer, verifica inoltre che un agente con funzionalità visive esponga lo strumento computer, che screen.snapshot venga eseguito correttamente con l’autorizzazione Registrazione schermo e che /phone status mostri l’autorizzazione temporanea o permanente del Gateway prevista. Una voce in gateway.nodes.denyCommands prevale sempre su allowCommands.

​
Argomenti correlati