Agent senden

openclaw agent führt einen einzelnen Agent-Turn über die Befehlszeile aus, ohne eine eingehende Chat-Nachricht zu benötigen. Verwenden Sie es für skriptgesteuerte Workflows, Tests und programmgesteuerte Zustellung.

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 Computer 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 der Gateway nicht erreichbar ist, fällt die CLI auf die lokale eingebettete Ausführung zurück.
• Sitzungsauswahl: --to leitet den Sitzungsschlüssel ab (Gruppen-/Kanalziele bleiben isoliert; direkte Chats werden auf main zusammengeführt).
• --session-key wählt einen expliziten Schlüssel aus. Schlüssel mit Agent-Präfix müssen agent:<agent-id>:<session-key> verwenden, und --agent muss mit dieser Agent-ID übereinstimmen, wenn beide angegeben werden. Bloße Nicht-Sentinel-Schlüssel werden auf --agent begrenzt, wenn angegeben; zum Beispiel leitet --agent ops --session-key incident-42 an agent:ops:incident-42 weiter. Ohne --agent werden bloße Nicht-Sentinel-Schlüssel auf den konfigurierten Standard-Agent begrenzt. Die Literale global und unknown bleiben nur dann unbegrenzt, wenn kein --agent angegeben ist; in diesem Fall verwenden eingebetteter Fallback und Speicherzuständigkeit den konfigurierten Standard-Agent.
• Thinking- und Verbose-Flags werden im Sitzungsspeicher beibehalten.
• Ausgabe: standardmäßig Klartext oder --json für strukturierte Nutzdaten + Metadaten.
• Mit --json --deliver enthält das JSON den Zustellstatus für gesendete, unterdrückte, teilweise und fehlgeschlagene Sendungen. Siehe JSON-Zustellstatus.

Beispiele

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # 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