Agentenversand

openclaw agent führt einen einzelnen Agentendurchlauf über die Befehlszeile ohne eine eingehende Chatnachricht aus. Verwenden Sie dies für skriptgesteuerte Workflows, Tests und programmatische Zustellung. Vollständige Referenz zu Flags und Verhalten: Agent-CLI-Referenz.

Schnellstart

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

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

# Einen bestimmten Agenten ansprechenopenclaw agent --agent ops --message "Protokolle zusammenfassen" # Eine Telefonnummer ansprechen (leitet den Sitzungsschlüssel ab)openclaw agent --to +15555550123 --message "Statusaktualisierung" # Eine vorhandene Sitzung wiederverwendenopenclaw agent --session-id abc123 --message "Aufgabe fortsetzen" # Einen exakten Sitzungsschlüssel verwendenopenclaw 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 zustellenopenclaw 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-Ausgabeopenclaw agent --to +15555550123 --message "Protokolle nachverfolgen" --verbose on --json # Durchlauf mit Modellüberschreibungopenclaw agent --agent ops --model openai/gpt-5.4 --message "Protokolle zusammenfassen" # Durchlauf mit Denkstufeopenclaw agent --session-id 1234 --message "Posteingang zusammenfassen" --thinking medium # Mehrzeiliger Prompt aus einer Dateiopenclaw agent --agent ops --message-file ./task.md # Exakter Sitzungsschlüsselopenclaw agent --session-key agent:ops:incident-42 --message "Status zusammenfassen" # Auf einen Agenten beschränkter Legacy-Schlüsselopenclaw agent --agent ops --session-key incident-42 --message "Status zusammenfassen" # An einen anderen Kanal als den der Sitzung zustellenopenclaw agent --agent ops --message "Warnung" --deliver --reply-channel telegram --reply-to "@admin"

Verwandte Themen