Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw system

Systemweite Helfer für den Gateway: Systemereignisse einreihen, Heartbeats steuern und Präsenz anzeigen. Alle system-Unterbefehle verwenden Gateway-RPC und akzeptieren die gemeinsamen Client-Flags:
  • --url <url>
  • --token <token>
  • --timeout <ms>
  • --expect-final

​
Häufige Befehle

openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence

​
system event

Reiht standardmäßig ein Systemereignis in der Haupt-Sitzung 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 wartet auf den nächsten geplanten Tick. Übergeben Sie --session-key, um eine bestimmte Sitzung anzusteuern (zum Beispiel, um den Abschluss einer asynchronen Aufgabe an den Kanal zurückzumelden, der sie gestartet hat).
Timing-Ausnahme mit --session-key: Wenn --session-key angegeben wird, wird --mode next-heartbeat zu einem sofortigen gezielten Wake, statt auf den nächsten geplanten Tick zu warten. Gezielte Wakes verwenden die Heartbeat-Absicht immediate, sodass sie die Noch-nicht-fällig-Sperre des Runners umgehen, die andernfalls einen Wake mit event-Absicht verzögern (und effektiv verwerfen) würde. Wenn Sie eine verzögerte Zustellung wünschen, lassen Sie --session-key weg, sodass das Ereignis in der Hauptsitzung landet und mit dem nächsten regulären Heartbeat mitläuft.
Flags:
  • --text <text>: erforderlicher Systemereignistext.
  • --mode <mode>: now oder next-heartbeat (Standard).
  • --session-key <sessionKey>: optional; steuert eine bestimmte Agent-Sitzung an statt der Hauptsitzung des Agenten. Schlüssel, die nicht zum aufgelösten Agenten gehören, fallen auf die Hauptsitzung des Agenten zurück.
  • --json: maschinenlesbare Ausgabe.
  • --url, --token, --timeout, --expect-final: gemeinsame Gateway-RPC-Flags.

​
system heartbeat last|enable|disable

Heartbeat-Steuerung:
  • last: zeigt das letzte Heartbeat-Ereignis an.
  • enable: schaltet Heartbeats wieder ein (verwenden Sie dies, wenn sie deaktiviert wurden).
  • disable: pausiert Heartbeats.
Flags:
  • --json: maschinenlesbare Ausgabe.
  • --url, --token, --timeout, --expect-final: gemeinsame Gateway-RPC-Flags.

​
system presence

Listet die aktuellen Systempräsenz-Einträge auf, die dem Gateway bekannt sind (Nodes, Instanzen und ähnliche Statuszeilen). Flags:
  • --json: maschinenlesbare Ausgabe.
  • --url, --token, --timeout, --expect-final: gemeinsame Gateway-RPC-Flags.

​
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.

​
Verwandt