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
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 presencesystem 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>:nowonext-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.
