Skip to main content

​
openclaw system

Strumenti di supporto a livello di sistema per il Gateway: accodano eventi di sistema, controllano gli heartbeat e visualizzano la presenza. Tutti i sottocomandi system usano l’RPC del Gateway e accettano le opzioni client condivise:

​
Comandi comuni

​
system event

Per impostazione predefinita, accoda un evento di sistema nella sessione principale. Il successivo heartbeat lo inserisce nel prompt come riga System:. Usa --mode now per attivare immediatamente l’heartbeat; next-heartbeat (valore predefinito) attende il successivo ciclo pianificato. Specifica --session-key per scegliere come destinazione una sessione specifica, ad esempio per inoltrare il completamento di un’attività asincrona al canale che l’ha avviata.
Eccezione temporale con --session-key: quando viene specificato --session-key, --mode next-heartbeat si riduce a un’attivazione mirata immediata anziché attendere il successivo ciclo pianificato. Le attivazioni mirate usano l’intento heartbeat immediate, quindi ignorano il controllo del runner che verificherebbe se l’esecuzione non è ancora prevista e altrimenti rinvierebbe (e di fatto eliminerebbe) un’attivazione con intento event. Per ottenere una consegna ritardata, ometti --session-key, così l’evento viene inserito nella sessione principale e viene trasportato dal successivo heartbeat regolare.
Opzioni:
  • --text <text>: testo obbligatorio dell’evento di sistema.
  • --mode <mode>: now o next-heartbeat (valore predefinito).
  • --session-key <sessionKey>: facoltativo; sceglie come destinazione una sessione specifica dell’agente anziché la sessione principale dell’agente. Le chiavi che non appartengono all’agente individuato ripiegano sulla sessione principale dell’agente.

​
system heartbeat last|enable|disable

  • last: mostra l’ultimo evento heartbeat.
  • enable: riattiva gli heartbeat (usalo se erano stati disattivati).
  • disable: sospende gli heartbeat.

​
system presence

Elenca le voci correnti relative alla presenza del sistema note al Gateway (nodi, istanze e righe di stato simili).

​
Note

  • Richiede un Gateway in esecuzione e raggiungibile tramite la configurazione corrente (locale o remota).
  • Gli eventi di sistema sono temporanei e non vengono conservati dopo i riavvii.

​
Contenuti correlati