CLI commands
Systeem
openclaw system
Helpers 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:
| Vlag | Standaard | Beschrijving |
|---|---|---|
--url <url> |
gateway.remote.url indien ingesteld |
WebSocket-URL van de Gateway. |
--token <token> |
geen | Gateway-token (indien vereist). |
--timeout <ms> |
30000 |
RPC-time-out in milliseconden. |
--expect-final |
uit | Wachten op het definitieve antwoord (agent). |
--json |
uit | JSON uitvoeren. heartbeat last/enable/disable en system presence drukken altijd de onbewerkte JSON-payload van RPC af, ongeacht deze vlag; system event gebruikt deze om te wisselen tussen JSON en een eenvoudige regel met ok. |
Veelgebruikte commando's
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
Plaatst standaard een systeemgebeurtenis in de wachtrij van de hoofdsessie. De volgende heartbeat voegt deze als een regel met System: in de prompt in. Gebruik --mode now om de heartbeat onmiddellijk te activeren; next-heartbeat (standaard) wacht op de volgende geplande cyclus.
Geef --session-key door om een specifieke sessie als doel te gebruiken, bijvoorbeeld om de voltooiing van een asynchrone taak terug te sturen naar het kanaal dat deze heeft gestart.
Vlaggen:
--text <text>: vereiste tekst van de systeemgebeurtenis.--mode <mode>:nowofnext-heartbeat(standaard).--session-key <sessionKey>: optioneel; richt zich op een specifieke agentsessie in plaats van op de hoofdsessie van de agent. Sleutels die niet bij de gevonden agent horen, vallen terug op de hoofdsessie van de agent.
system heartbeat last|enable|disable
last: de laatste heartbeat-gebeurtenis weergeven.enable: heartbeats weer inschakelen (gebruik dit als ze waren uitgeschakeld).disable: heartbeats pauzeren.
system presence
Geeft de huidige vermeldingen van systeemaanwezigheid weer die bij de Gateway bekend zijn (nodes, instanties en vergelijkbare statusregels).
Opmerkingen
- Vereist een actieve Gateway die bereikbaar is via je huidige configuratie (lokaal of extern).
- Systeemgebeurtenissen zijn tijdelijk en blijven niet behouden na herstarts.
