openclaw agent (direkte Agent-Läufe)

openclaw agent führt einen einzelnen Agent-Turn aus, ohne dass eine eingehende Chat-Nachricht nötig ist. Standardmäßig läuft es über das Gateway; füge --local hinzu, um die eingebettete Laufzeit auf dem aktuellen Rechner zu erzwingen.

Verhalten

• Erforderlich: --message <text>
• Sitzungsauswahl:
  • --to <dest> leitet den Session-Key ab (Gruppen-/Kanalziele bewahren die Isolation; Direktchats fallen auf main zusammen), oder
  • --session-id <id> verwendet eine bestehende Sitzung anhand der ID wieder, oder
  • --agent <id> spricht einen konfigurierten Agenten direkt an (verwendet den main-Session-Key dieses Agenten)
• Führt dieselbe eingebettete Agent-Laufzeit wie normale eingehende Antworten aus.
• Thinking-/Verbose-Flags werden im Session-Store gespeichert.
• Ausgabe:
  • Standard: gibt Antworttext aus (plus MEDIA:<url>-Zeilen)
  • --json: gibt strukturierte Nutzlast + Metadaten aus
• Optionale Zustellung zurück an einen Kanal mit --deliver + --channel (Zielformate entsprechen openclaw message --target).
• Verwende --reply-channel/--reply-to/--reply-account, um die Zustellung zu überschreiben, ohne die Sitzung zu ändern.

Wenn das Gateway nicht erreichbar ist, fällt die CLI auf den eingebetteten lokalen Lauf zurück.

Beispiele

openclaw agent --to +15555550123 --message "status update"
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json
openclaw agent --to +15555550123 --message "Summon reply" --deliver
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"

Flags

• --local: lokal ausführen (erfordert API-Schlüssel des Modellanbieters in deiner Shell)
• --deliver: Antwort an den gewählten Kanal senden
• --channel: Zustellkanal (whatsapp|telegram|discord|googlechat|slack|signal|imessage, Standard: whatsapp)
• --reply-to: Zustellziel überschreiben
• --reply-channel: Zustellkanal überschreiben
• --reply-account: Zustell-Account-ID überschreiben
• --thinking <off|minimal|low|medium|high|xhigh>: Thinking-Level speichern (nur GPT-5.2 + Codex-Modelle)
• --verbose <on|full|off>: Verbose-Level speichern
• --timeout <seconds>: Agent-Timeout überschreiben
• --json: strukturiertes JSON ausgeben