openclaw agent: Agenten-Turns direkt über das CLI starten

Kennst du das? Du entwickelst einen Agenten und musst jedes Mal zum Testen eine Nachricht in WhatsApp oder Slack tippen. Das unterbricht den Workflow und macht das Debugging unnötig kompliziert.

Der openclaw agent Befehl löst das Problem. Du triggerst Agenten-Turns direkt aus deinem Terminal, egal ob für einen schnellen Test oder als Teil eines Skripts. Das spart Zeit und lässt dich Agenten-Logik isoliert testen.

Voraussetzungen

• Zugriff auf das Gateway (Standardeinstellung)
• API Keys deiner Model Provider in der Shell (nur für den --local Modus erforderlich)

Schnellstart

Ein Turn wird standardmäßig über das Gateway ausgeführt. Falls das Gateway nicht erreichbar ist, nutzt die CLI automatisch die eingebettete lokale Runtime als Fallback.

Hier sind die schnellsten Wege, um den Befehl zu nutzen:

1. Agenten-Turn starten

Du kannst ein Ziel mit --to angeben oder einen konfigurierten Agenten direkt mit --agent ansprechen.

# Über das Ziel (Session-Key wird abgeleitet)
openclaw agent --to +15555550123 --message "status update"

# Direkt über die Agenten-ID
openclaw agent --agent ops --message "Summarize logs"

2. Sessions und Thinking-Level steuern

Du kannst bestehende Sessions fortsetzen und das Verhalten für GPT-5.2 oder Codex Modelle anpassen.

# Bestehende Session nutzen
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Debugging mit JSON-Output und Verbose-Modus
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

3. Ergebnisse an Channels ausliefern

Wenn die Antwort nicht nur im Terminal erscheinen soll, nutzt du --deliver.

# Antwort an den ursprünglichen Channel senden
openclaw agent --to +15555550123 --message "Summon reply" --deliver

# Antwort an einen anderen Channel umleiten
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"

Wichtige Flags im Überblick

• --local: Erzwingt die lokale Ausführung auf deiner Maschine (benötigt API Keys).
• --json: Gibt den Payload und Metadaten als strukturiertes JSON aus.
• --thinking <level>: Setzt das Thinking-Level (off, minimal, low, medium, high, xhigh).
• --channel: Definiert den Delivery-Channel (z. B. whatsapp, telegram, slack, discord).

Fehlerbehebung

• Gateway unreachable: Wenn die Verbindung zum Gateway fehlschlägt, wechselt die CLI zum lokalen Modus. Stelle in diesem Fall sicher, dass die API Keys deiner Model Provider in deiner Umgebung hinterlegt sind.
• Session Isolation: Wenn du --to nutzt, werden Session-Keys für Gruppen und Channels isoliert. Direkte Chats werden im main Key zusammengefasst.

Brauchst du Hilfe bei der Konfiguration? Nutze den AI Setup Assistant.

Nächste Schritte

• openclaw message Dokumentation
• Session Management Guide
• Gateway Konfiguration
• Model Provider Setup