Agent coordination
Agent senden
openclaw agent führt eine einzelne Agent-Ausführung über die Befehlszeile aus, ohne
dass eine eingehende Chatnachricht erforderlich ist. Verwenden Sie es für skriptgesteuerte Workflows, Tests und
programmatische Zustellung.
Schnellstart
Einfache Agent-Ausführung starten
openclaw agent --message "What is the weather today?"
Dadurch wird die Nachricht über das Gateway gesendet und die Antwort ausgegeben.
Bestimmten Agent oder bestimmte Sitzung ansteuern
# Target a specific agent
openclaw agent --agent ops --message "Summarize logs"
# Target a phone number (derives session key)
openclaw agent --to +15555550123 --message "Status update"
# Reuse an existing session
openclaw agent --session-id abc123 --message "Continue the task"
Antwort an einen Kanal zustellen
# Deliver to WhatsApp (default channel)
openclaw agent --to +15555550123 --message "Report ready" --deliver
# Deliver to Slack
openclaw agent --agent ops --message "Generate report" \
--deliver --reply-channel slack --reply-to "#reports"
Flags
| Flag | Beschreibung |
|---|---|
--message \<text\> |
Zu sendende Nachricht (erforderlich) |
--to \<dest\> |
Sitzungsschlüssel aus einem Ziel ableiten (Telefon, Chat-ID) |
--agent \<id\> |
Konfigurierten Agent ansteuern (verwendet dessen main-Sitzung) |
--session-id \<id\> |
Vorhandene Sitzung anhand der ID wiederverwenden |
--local |
Lokale eingebettete Laufzeit erzwingen (Gateway überspringen) |
--deliver |
Antwort an einen Chatkanal senden |
--channel \<name\> |
Zustellungskanal (whatsapp, telegram, discord, slack usw.) |
--reply-to \<target\> |
Zustellungsziel überschreiben |
--reply-channel \<name\> |
Zustellungskanal überschreiben |
--reply-account \<id\> |
ID des Zustellungskontos überschreiben |
--thinking \<level\> |
Denkstufe für das ausgewählte Modellprofil festlegen |
--verbose \<on|full|off\> |
Ausführlichkeitsstufe festlegen |
--timeout \<seconds\> |
Agent-Timeout überschreiben |
--json |
Strukturiertes JSON ausgeben |
Verhalten
- Standardmäßig läuft die CLI über das Gateway. Fügen Sie
--localhinzu, um die eingebettete Laufzeit auf dem aktuellen Rechner zu erzwingen. - Wenn das Gateway nicht erreichbar ist, fällt die CLI auf die lokale eingebettete Ausführung zurück.
- Sitzungsauswahl:
--toleitet den Sitzungsschlüssel ab (Gruppen-/Kanalziele behalten die Isolation bei; direkte Chats werden aufmainzusammengeführt). - Thinking- und Verbose-Flags werden im Sitzungsspeicher beibehalten.
- Ausgabe: standardmäßig Nur-Text oder
--jsonfür strukturierte Nutzdaten und Metadaten.
Beispiele
# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json
# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"
Verwandte Themen
Agent-CLI-Referenz
Vollständige Referenz zu Flags und Optionen von openclaw agent.
Sub-Agents
Erzeugen von Sub-Agents im Hintergrund.
Sitzungen
Wie Sitzungsschlüssel funktionieren und wie --to, --agent und --session-id sie auflösen.
Slash-Befehle
Nativer Befehlskatalog, der innerhalb von Agent-Sitzungen verwendet wird.