Agentenversand

​

Schnellstart

openclaw agent --agent main --message "Wie ist das Wetter heute?"

openclaw agent --agent ops --message-file ./task.md

# Einen bestimmten Agenten ansprechen
openclaw agent --agent ops --message "Protokolle zusammenfassen"

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

# Eine vorhandene Sitzung wiederverwenden
openclaw agent --session-id abc123 --message "Aufgabe fortsetzen"

# Einen exakten Sitzungsschlüssel verwenden
openclaw agent --session-key agent:ops:incident-42 --message "Status zusammenfassen"

# An WhatsApp zustellen (Standardkanal)
openclaw agent --to +15555550123 --message "Bericht ist fertig" --deliver

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

​

Flags

​

Verhalten

• Standardmäßig läuft die CLI über das Gateway. Fügen Sie --local hinzu, um die eingebettete Laufzeit auf dem aktuellen Rechner zu erzwingen.
• Übergeben Sie genau eines von --message oder --message-file. Dateinachrichten behalten mehrzeilige Inhalte bei, nachdem eine optionale UTF-8-BOM entfernt wurde. Dateien mit mehr als 4 MiB werden vor der Weiterleitung abgelehnt.
• Nach vorübergehenden Wiederholungsversuchen beim Handshake führt eine Gateway-Zeitüberschreitung oder eine geschlossene Verbindung zum Fehlschlagen des Befehls mit einem Hinweis auf stderr; die CLI führt den Durchlauf niemals stillschweigend erneut eingebettet aus. Das Gateway kann einen angenommenen Durchlauf dennoch abschließen. Prüfen Sie daher den Gateway- und Sitzungsstatus, bevor Sie den Vorgang wiederholen oder mit --local erneut ausführen.
• Sitzungsauswahl: --to leitet den Sitzungsschlüssel ab (Gruppen-/Kanalziele behalten die Isolation bei; Direktchats werden zu main zusammengeführt). Wenn --agent, --channel und --to gemeinsam verwendet werden, folgt das Routing dem kanonischen Empfänger des Kanals und session.dmScope. Stabile Identitäten, die ausschließlich für ausgehende Nachrichten verwendet werden, nutzen eine vom Provider verwaltete Sitzung, die von der Hauptsitzung des Agenten isoliert ist.
• --session-key wählt einen expliziten Schlüssel aus. Mit einem Agentenpräfix versehene Schlüssel müssen agent:<agent-id>:<session-key> verwenden, und --agent muss mit dieser Agenten-ID übereinstimmen, wenn beide angegeben werden. Unqualifizierte Schlüssel, die keine Sentinel-Schlüssel sind, werden auf --agent beschränkt, wenn dies angegeben ist; beispielsweise wird --agent ops --session-key incident-42 an agent:ops:incident-42 weitergeleitet. Ohne --agent werden unqualifizierte Schlüssel, die keine Sentinel-Schlüssel sind, auf den konfigurierten Standardagenten beschränkt. Die literalen Werte global und unknown bleiben nur dann unbeschränkt, wenn kein --agent angegeben ist.
• --reply-channel und --reply-account wirken sich nur auf die Zustellung aus.
• Denk- und Ausführlichkeits-Flags werden im Sitzungsspeicher gespeichert.
• Ausgabe: standardmäßig Klartext oder --json für strukturierte Nutzdaten und Metadaten.
• Mit --json --deliver enthält das JSON den Zustellungsstatus für gesendete, unterdrückte, teilweise und fehlgeschlagene Sendungen. Siehe JSON-Zustellungsstatus.

​

Beispiele

# Einfacher Durchlauf mit JSON-Ausgabe
openclaw agent --to +15555550123 --message "Protokolle nachverfolgen" --verbose on --json

# Durchlauf mit Modellüberschreibung
openclaw agent --agent ops --model openai/gpt-5.4 --message "Protokolle zusammenfassen"

# Durchlauf mit Denkstufe
openclaw agent --session-id 1234 --message "Posteingang zusammenfassen" --thinking medium

# Mehrzeiliger Prompt aus einer Datei
openclaw agent --agent ops --message-file ./task.md

# Exakter Sitzungsschlüssel
openclaw agent --session-key agent:ops:incident-42 --message "Status zusammenfassen"

# Auf einen Agenten beschränkter Legacy-Schlüssel
openclaw agent --agent ops --session-key incident-42 --message "Status zusammenfassen"

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

​

Verwandte Themen