OpenClawDocs
In questa pagina

In questa pagina

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Sistema

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:

Opzione Valore predefinito Descrizione
--url <url> gateway.remote.url se configurato URL WebSocket del Gateway.
--token <token> nessuno Token del Gateway (se richiesto).
--timeout <ms> 30000 Timeout RPC in millisecondi.
--expect-final disattivato Attende la risposta finale (agente).
--json disattivato Produce output JSON. heartbeat last/enable/disable e system presence stampano sempre il payload JSON RPC non elaborato indipendentemente da questa opzione; system event la usa per scegliere tra JSON e una semplice riga ok.

Comandi comuni

bash
openclaw system event --text "Check for urgent follow-ups" --mode nowopenclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"openclaw system heartbeat enableopenclaw system heartbeat lastopenclaw system presence

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.

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

Was this useful?