Agent senden

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

Schnellstart

openclaw agent --agent main --message "What is the weather today?"

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

# Target a specific agentopenclaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)openclaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionopenclaw agent --session-id abc123 --message "Continue the task" # Target an exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Deliver to WhatsApp (default channel)openclaw agent --to +15555550123 --message "Report ready" --deliver # Deliver to Slackopenclaw agent --agent ops --message "Generate report" \  --deliver --reply-channel slack --reply-to "#reports"

Flags

Verhalten

• Standardmäßig läuft die CLI über den Gateway. Fügen Sie --local hinzu, um die eingebettete Laufzeit auf dem aktuellen Rechner zu erzwingen.
• Übergeben Sie genau eine der Optionen --message oder --message-file. Dateinachrichten behalten mehrzeilige Inhalte bei, nachdem eine optionale UTF-8-BOM entfernt wurde.
• Wenn die Gateway-Anfrage fehlschlägt, weicht die CLI auf den lokalen eingebetteten Durchlauf aus. Bei einer Gateway-Zeitüberschreitung erfolgt der Ausweichvorgang mit einer neuen Sitzung, statt mit dem ursprünglichen Transkript zu konkurrieren.
• Sitzungsauswahl: --to leitet den Sitzungsschlüssel ab (Gruppen- und Kanalziele bleiben isoliert; direkte Chats werden unter 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 das Format agent:<agent-id>:<session-key> verwenden, und --agent muss mit dieser Agenten-ID übereinstimmen, wenn beide angegeben werden. Unqualifizierte Schlüssel, die keine Sentinel-Werte sind, werden dem mit --agent angegebenen Agenten zugeordnet. Beispielsweise wird --agent ops --session-key incident-42 an agent:ops:incident-42 weitergeleitet. Ohne --agent werden unqualifizierte Schlüssel, die keine Sentinel-Werte sind, dem konfigurierten Standardagenten zugeordnet. Die Literalwerte global und unknown bleiben nur dann ohne Zuordnung, wenn kein --agent angegeben ist. Der eingebettete Ausweichpfad ordnet diese Sentinel-Sitzungen dem konfigurierten Standardagenten zu.
• --reply-channel und --reply-account wirken sich nur auf die Zustellung aus.
• Flags für die Denk- und Ausführlichkeitsstufe werden im Sitzungsspeicher beibehalten.
• Ausgabe: standardmäßig Klartext oder mit --json eine strukturierte Nutzlast einschließlich Metadaten.
• Mit --json --deliver enthält das JSON den Zustellungsstatus für gesendete, unterdrückte, teilweise und fehlgeschlagene Sendungen. Siehe JSON-Zustellungsstatus.

Beispiele

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with a model overrideopenclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs" # Turn with thinking levelopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Multiline prompt from a fileopenclaw agent --agent ops --message-file ./task.md # Exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Legacy key scoped to an agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

Verwandte Themen