English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

Sistema

Edit source

openclaw system

Helper a livello di sistema per il Gateway: accodano eventi di sistema, controllano gli heartbeat e visualizzano la presenza.

Tutti i sottocomandi system usano Gateway RPC e accettano i flag client condivisi:

  • --url <url>
  • --token <token>
  • --timeout <ms>
  • --expect-final

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

Accoda un evento di sistema nella sessione main per impostazione predefinita. Il prossimo heartbeat lo inserirà come riga System: nel prompt. Usa --mode now per attivare subito l'heartbeat; next-heartbeat attende il prossimo tick pianificato.

Passa --session-key per indirizzare una sessione specifica (per esempio per inoltrare il completamento di un async-task al canale che l'ha avviato).

Eccezione di timing con --session-key: quando viene fornito --session-key, --mode next-heartbeat si riduce a un risveglio mirato immediato invece di attendere il prossimo tick pianificato. I risvegli mirati usano l'intent heartbeat immediate, quindi bypassano il gate not-due del runner che altrimenti differirebbe (e di fatto scarterebbe) un risveglio con intent event. Se vuoi una consegna ritardata, ometti --session-key così l'evento arriva nella sessione main e segue il successivo heartbeat regolare.

Flag:

  • --text <text>: testo dell'evento di sistema obbligatorio.
  • --mode <mode>: now o next-heartbeat (predefinito).
  • --session-key <sessionKey>: opzionale; indirizza una sessione agente specifica invece della sessione main dell'agente. Le chiavi che non appartengono all'agente risolto ricadono sulla sessione main dell'agente.
  • --json: output leggibile dalla macchina.
  • --url, --token, --timeout, --expect-final: flag Gateway RPC condivisi.

system heartbeat last|enable|disable

Controlli heartbeat:

  • last: mostra l'ultimo evento heartbeat.
  • enable: riattiva gli heartbeat (usalo se erano stati disabilitati).
  • disable: mette in pausa gli heartbeat.

Flag:

  • --json: output leggibile dalla macchina.
  • --url, --token, --timeout, --expect-final: flag Gateway RPC condivisi.

system presence

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

Flag:

  • --json: output leggibile dalla macchina.
  • --url, --token, --timeout, --expect-final: flag Gateway RPC condivisi.

Note

  • Richiede un Gateway in esecuzione raggiungibile dalla configurazione corrente (locale o remoto).
  • Gli eventi di sistema sono effimeri e non vengono mantenuti tra i riavvii.

Correlati

Was this useful?