CLI commands

Systeem

openclaw system

Hulpmiddelen op systeemniveau voor de Gateway: systeemgebeurtenissen in de wachtrij plaatsen, Heartbeats beheren, en aanwezigheid bekijken.

Alle system-subcommando's gebruiken Gateway-RPC en accepteren de gedeelde clientvlaggen:

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

Algemene opdrachten

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

Plaatst standaard een systeemgebeurtenis in de wachtrij op de hoofdsessie. De volgende Heartbeat injecteert deze als een System:-regel in de prompt. Gebruik --mode now om de Heartbeat onmiddellijk te activeren; next-heartbeat wacht op de volgende geplande tik.

Geef --session-key door om een specifieke sessie te targeten (bijvoorbeeld om een voltooiing van een async-taak terug te sturen naar het kanaal dat deze heeft gestart).

Timing-uitzondering met --session-key: wanneer --session-key is opgegeven, valt --mode next-heartbeat terug naar een onmiddellijke gerichte wake in plaats van te wachten op de volgende geplande tik. Gerichte wakes gebruiken Heartbeat-intentie immediate, zodat ze de not-due-gate van de runner omzeilen die anders een wake met event-intentie zou uitstellen (en feitelijk laten vallen). Als je vertraagde levering wilt, laat --session-key dan weg zodat de gebeurtenis op de hoofdsessie terechtkomt en meelift op de volgende reguliere Heartbeat.

Vlaggen:

  • --text <text>: vereiste tekst voor de systeemgebeurtenis.
  • --mode <mode>: now of next-heartbeat (standaard).
  • --session-key <sessionKey>: optioneel; target een specifieke agentsessie in plaats van de hoofdsessie van de agent. Sleutels die niet bij de opgeloste agent horen, vallen terug naar de hoofdsessie van de agent.
  • --json: machineleesbare uitvoer.
  • --url, --token, --timeout, --expect-final: gedeelde Gateway-RPC-vlaggen.

system heartbeat last|enable|disable

Heartbeat-beheer:

  • last: toon de laatste Heartbeat-gebeurtenis.
  • enable: schakel Heartbeats weer in (gebruik dit als ze waren uitgeschakeld).
  • disable: pauzeer Heartbeats.

Vlaggen:

  • --json: machineleesbare uitvoer.
  • --url, --token, --timeout, --expect-final: gedeelde Gateway-RPC-vlaggen.

system presence

Maak een lijst van de huidige systeemaanwezigheidsitems die de Gateway kent (nodes, instanties en vergelijkbare statusregels).

Vlaggen:

  • --json: machineleesbare uitvoer.
  • --url, --token, --timeout, --expect-final: gedeelde Gateway-RPC-vlaggen.

Opmerkingen

  • Vereist een draaiende Gateway die bereikbaar is via je huidige configuratie (lokaal of remote).
  • Systeemgebeurtenissen zijn tijdelijk en blijven niet behouden na herstarts.

Gerelateerd

Was this useful?