Zum Hauptinhalt springen

​
Agent Send

openclaw agent führt einen einzelnen Agent-Zug über die Befehlszeile aus, ohne dass eine eingehende Chat-Nachricht erforderlich ist. Verwenden Sie es für skriptgesteuerte Workflows, Tests und programmgesteuerte Zustellung.

​
Schnellstart

1

Einen einfachen Agent-Zug ausführen

openclaw agent --message "What is the weather today?"
Dies sendet die Nachricht über das Gateway und gibt die Antwort aus.
2

Einen bestimmten Agenten oder eine Sitzung ansprechen

# Einen bestimmten Agenten ansprechen
openclaw agent --agent ops --message "Summarize logs"

# Eine Telefonnummer ansprechen (leitet den Sitzungsschlüssel ab)
openclaw agent --to +15555550123 --message "Status update"

# Eine vorhandene Sitzung wiederverwenden
openclaw agent --session-id abc123 --message "Continue the task"
3

Die Antwort an einen Kanal zustellen

# An WhatsApp zustellen (Standardkanal)
openclaw agent --to +15555550123 --message "Report ready" --deliver

# An Slack zustellen
openclaw agent --agent ops --message "Generate report" \
  --deliver --reply-channel slack --reply-to "#reports"

​
Flags

FlagBeschreibung
--message \<text\>Zu sendende Nachricht (erforderlich)
--to \<dest\>Sitzungsschlüssel aus einem Ziel ableiten (Telefon, Chat-ID)
--agent \<id\>Einen konfigurierten Agenten ansprechen (verwendet seine main-Sitzung)
--session-id \<id\>Eine vorhandene Sitzung anhand der ID wiederverwenden
--localLokale eingebettete Laufzeit erzwingen (Gateway überspringen)
--deliverDie Antwort an einen Chat-Kanal senden
--channel \<name\>Zustellkanal (whatsapp, telegram, discord, slack usw.)
--reply-to \<target\>Überschreibung des Zustellziels
--reply-channel \<name\>Überschreibung des Zustellkanals
--reply-account \<id\>Überschreibung der Zustellkonto-ID
--thinking \<level\>Thinking-Level setzen (off, minimal, low, medium, high, xhigh)
--verbose \<on|full|off\>Verbose-Level setzen
--timeout \<seconds\>Agent-Timeout überschreiben
--jsonStrukturiertes JSON ausgeben

​
Verhalten

  • Standardmäßig läuft die CLI über das Gateway. Fügen Sie --local hinzu, um die eingebettete Laufzeit auf der aktuellen Maschine zu erzwingen.
  • Wenn das Gateway nicht erreichbar ist, fällt die CLI auf den lokalen eingebetteten Lauf zurück.
  • Sitzungsauswahl: --to leitet den Sitzungsschlüssel ab (Gruppen-/Kanalziele behalten die Isolation bei; direkte Chats werden zu main zusammengeführt).
  • Thinking- und Verbose-Flags werden im Sitzungsspeicher persistiert.
  • Ausgabe: standardmäßig Klartext oder mit --json als strukturierte Payload + Metadaten.

​
Beispiele

# Einfacher Zug mit JSON-Ausgabe
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Zug mit Thinking-Level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# An einen anderen Kanal als die Sitzung zustellen
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​
Verwandte Themen