openclaw agent (direkte Agent-Ausführung)

openclaw agent führt einen einzelnen Agent-Durchlauf aus, ohne dass eine eingehende Chat-Nachricht nötig ist. Standardmäßig läuft der Befehl über das Gateway; mit --local erzwingst du die eingebettete Runtime auf dem aktuellen Rechner.

Verhalten

  • Erforderlich: --message <text>
  • Session-Auswahl:
    • --to <dest> leitet den Session-Key ab (Gruppen-/Channel-Ziele bleiben isoliert; Direktchats werden zu main zusammengefasst), oder
    • --session-id <id> verwendet eine bestehende Session anhand der ID, oder
    • --agent <id> spricht einen konfigurierten Agent direkt an (nutzt dessen main Session-Key)
  • Führt die gleiche eingebettete Agent-Runtime aus wie normale eingehende Antworten.
  • Thinking/Verbose-Flags werden im Session-Store gespeichert.
  • Ausgabe:
    • Standard: gibt Antworttext aus (plus MEDIA:<url>-Zeilen)
    • --json: gibt strukturierte Payload + Metadaten aus
  • Optionale Zustellung zurück an einen Channel mit --deliver + --channel (Zielformate entsprechen openclaw message --target).
  • Nutze --reply-channel/--reply-to/--reply-account, um die Zustellung zu überschreiben, ohne die Session zu ändern.

Falls das Gateway nicht erreichbar ist, fällt die CLI automatisch zurück auf die eingebettete lokale Ausführung.

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: lokale Ausführung (benötigt Model-Provider-API-Keys in deiner Shell)
  • --deliver: sendet die Antwort an den gewählten Channel
  • --channel: Zustellungs-Channel (whatsapp|telegram|discord|googlechat|slack|signal|imessage, Standard: whatsapp)
  • --reply-to: überschreibt das Zustellungsziel
  • --reply-channel: überschreibt den Zustellungs-Channel
  • --reply-account: überschreibt die Zustellungs-Account-ID
  • --thinking <off|minimal|low|medium|high|xhigh>: speichert das Thinking-Level (nur GPT-5.2 + Codex-Modelle)
  • --verbose <on|full|off>: speichert das Verbose-Level
  • --timeout <seconds>: überschreibt das Agent-Timeout
  • --json: gibt strukturiertes JSON aus