Gateway-Steuerung mit openclaw system

Kennst du das? Du entwickelst eine Integration und fragst dich, ob das System deine Änderungen schon registriert hat. Oft fehlt die direkte Kontrolle über Hintergrundprozesse, was das Debugging unnötig in die Länge zieht.

Statt blind auf den nächsten automatischen Zyklus zu warten, kannst du mit openclaw system direkt eingreifen. Das spart Zeit und gibt dir die nötige Transparenz über den aktuellen Status deiner Instanzen.

Voraussetzungen

• Ein laufendes Gateway.
• Eine Konfiguration, die das Gateway lokal oder remote erreicht.

Schnellstart

Hier ist der schnellste Weg, um die Kontrolle über dein System zu übernehmen:

1. Event senden: openclaw system event --text "Check for urgent follow-ups" --mode now
2. Heartbeats aktivieren: openclaw system heartbeat enable
3. Status prüfen: openclaw system heartbeat last
4. Instanzen auflisten: openclaw system presence

System-Events steuern

Mit system event fügst du der main Session ein Event hinzu. Beim nächsten Heartbeat erscheint dieser Text als System: Zeile im Prompt. Ich empfehle den --mode now, wenn du nicht auf den nächsten geplanten Tick warten willst.

Verfügbare Flags

• --text <text>: Der Text für das System-Event (erforderlich).
• --mode <mode>: Wähle zwischen now (sofort) oder next-heartbeat (Standard).
• --json: Gibt die Antwort in einem maschinenlesbaren Format aus.

# Beispiel: Sofortiger Check
openclaw system event --text "Manual trigger" --mode now

Heartbeat-Kontrolle

Heartbeats halten die Verbindung aktiv. Wenn du sie pausieren musst oder den letzten Zeitpunkt prüfen willst, nutzt du diese Befehle:

• last: Zeigt das letzte Heartbeat-Event an.
• enable: Schaltet Heartbeats wieder ein.
• disable: Pausiert die Heartbeats.

Nutze das --json Flag, wenn du diese Daten in anderen Tools weiterverarbeiten möchtest.

Presence und Status

Um zu sehen, welche Nodes und Instanzen das Gateway aktuell kennt, nutzt du system presence. Das gibt dir eine Liste aller aktiven Statuszeilen.

openclaw system presence --json

Fehlerbehebung

• Gateway nicht erreichbar: Prüfe, ob das Gateway läuft und ob deine aktuelle Config auf die richtige Adresse (lokal oder remote) zeigt.
• Events verschwinden: Beachte, dass System-Events flüchtig sind. Sie werden nach einem Neustart des Gateways nicht gespeichert.

Du hast Fragen zu einem spezifischen Setup? Nutze den AI Setup Assistant.

Nächste Schritte

• Gateway Configuration Guide
• CLI Command Reference