Skip to main content

​
openclaw system

Hilfsfunktionen auf Systemebene für das Gateway: Systemereignisse in die Warteschlange einreihen, Heartbeats steuern und Präsenz anzeigen. Alle system-Unterbefehle verwenden Gateway-RPC und akzeptieren die gemeinsamen Client-Flags:

​
Häufig verwendete Befehle

​
system event

Reiht standardmäßig ein Systemereignis in der 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 bis zum nächsten geplanten Durchlauf. Übergeben Sie --session-key, um eine bestimmte Sitzung als Ziel festzulegen, beispielsweise um den Abschluss einer asynchronen Aufgabe an den Kanal zurückzumelden, der sie gestartet hat.
Zeitliche Ausnahme bei --session-key: Wenn --session-key angegeben wird, wird --mode next-heartbeat zu einem sofortigen gezielten Weckvorgang, anstatt auf den nächsten geplanten Durchlauf zu warten. Gezielte Weckvorgänge verwenden die Heartbeat-Absicht immediate und umgehen dadurch die Sperre des Runners für noch nicht fällige Ausführungen, die andernfalls einen Weckvorgang mit der Absicht event aufschieben (und effektiv verwerfen) würde. Wenn Sie eine verzögerte Zustellung wünschen, lassen Sie --session-key weg, damit das Ereignis in der Hauptsitzung landet und mit dem nächsten regulären Heartbeat verarbeitet wird.
Flags:
  • --text <text>: erforderlicher Text des Systemereignisses.
  • --mode <mode>: now oder next-heartbeat (Standardwert).
  • --session-key <sessionKey>: optional; legt eine bestimmte Agent-Sitzung als Ziel fest, anstatt der 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: aktiviert Heartbeats wieder (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 ein laufendes Gateway, das über Ihre aktuelle Konfiguration erreichbar ist (lokal oder remote).
  • Systemereignisse sind flüchtig und bleiben über Neustarts hinweg nicht erhalten.

​
Verwandte Themen