CLI commands

System

`openclaw system`

Hilfsfunktionen auf Systemebene für den Gateway: Systemereignisse in die Warteschlange einreihen, Heartbeats steuern und Präsenz anzeigen.

Alle system-Unterbefehle verwenden Gateway-RPC und akzeptieren die gemeinsamen Client-Flags:

Flag	Standardwert	Beschreibung
`--url <url>`	`gateway.remote.url`, falls konfiguriert	Gateway-WebSocket-URL.
`--token <token>`	keiner	Gateway-Token (falls erforderlich).
`--timeout <ms>`	`30000`	RPC-Zeitüberschreitung in Millisekunden.
`--expect-final`	aus	Auf die endgültige Antwort warten (Agent).
`--json`	aus	JSON ausgeben. `heartbeat last/enable/disable` und `system presence` geben unabhängig von diesem Flag immer die unverarbeitete JSON-Nutzlast des RPC aus; `system event` wechselt damit zwischen JSON und einer einfachen `ok`-Zeile.

Häufig verwendete Befehle

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`

Reiht standardmäßig ein Systemereignis in die Hauptsitzung ein. Der nächste Heartbeat fügt es als System:-Zeile in den Prompt ein. Verwenden Sie --mode now, um den Heartbeat sofort auszulösen; next-heartbeat (Standardwert) wartet auf den nächsten geplanten Ausführungszeitpunkt.

Übergeben Sie --session-key, um eine bestimmte Sitzung anzusprechen, beispielsweise um den Abschluss einer asynchronen Aufgabe an den Kanal zurückzumelden, der sie gestartet hat.

Flags:

--text <text>: erforderlicher Text des Systemereignisses.
--mode <mode>: now oder next-heartbeat (Standardwert).
--session-key <sessionKey>: optional; richtet sich an eine bestimmte Agent-Sitzung statt an die Hauptsitzung des Agenten. Schlüssel, die nicht zum ermittelten Agenten gehören, greifen auf die Hauptsitzung des Agenten zurück.

`system heartbeat last|enable|disable`

last: zeigt das letzte Heartbeat-Ereignis an.
enable: schaltet Heartbeats wieder ein (verwenden Sie dies, wenn sie deaktiviert wurden).
disable: pausiert Heartbeats.

`system presence`

Listet die aktuellen Systempräsenzeinträge auf, die dem Gateway bekannt sind (Nodes, Instanzen und ähnliche Statuszeilen).

Hinweise

Erfordert einen laufenden Gateway, der über Ihre aktuelle Konfiguration erreichbar ist (lokal oder remote).
Systemereignisse sind flüchtig und bleiben über Neustarts hinweg nicht erhalten.