openclaw agent (direkte Agent-Läufe)

openclaw agent führt einen einzelnen Agent-Turn aus, ohne eingehende Chat-Nachricht. Standardmäßig geht es über das Gateway; mit --local die eingebettete Runtime auf der aktuellen Maschine erzwingen.

Verhalten

• Erforderlich: --message <text>
• Sitzungsauswahl:
  • --to <dest> leitet den Sitzungs-Key ab (Gruppen-/Kanal-Ziele bewahren Isolation; Direktchats kollabieren zu main), oder
  • --session-id <id> wiederverwendet eine bestehende Sitzung per ID, oder
  • --agent <id> spricht einen konfigurierten Agenten direkt an (nutzt dessen main-Sitzungs-Key)
• Nutzt dieselbe eingebettete Agent-Runtime wie normale eingehende Antworten.
• Thinking-/Verbose-Flags bleiben im Sitzungs-Store erhalten.
• Ausgabe:
  • Standard: gibt Antworttext aus (plus MEDIA:<url>-Zeilen)
  • --json: strukturierte Payload + Metadaten
• Optionale Zustellung zurück in einen Kanal mit --deliver + --channel (Zielformate wie openclaw message --target).
• --reply-channel/--reply-to/--reply-account überschreiben die Zustellung ohne 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 Modell-Provider-API-Keys 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-Überschreibung
• --reply-channel: Zustellkanal-Überschreibung
• --reply-account: Zustell-Account-ID-Überschreibung
• --thinking <off|minimal|low|medium|high|xhigh>: Thinking-Level persistent setzen (nur GPT-5.2 + Codex-Modelle)
• --verbose <on|full|off>: Verbose-Level persistent setzen
• --timeout <seconds>: Agent-Timeout überschreiben
• --json: strukturiertes JSON ausgeben