Wysyłanie przez agenta

​

Szybki start

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

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

# 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"

# Target an exact session key
openclaw 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 Slack
openclaw agent --agent ops --message "Generate report" \
  --deliver --reply-channel slack --reply-to "#reports"

​

Flagi

​

Zachowanie

• Domyślnie CLI działa przez Gateway. Dodaj --local, aby wymusić osadzone środowisko wykonawcze na bieżącym komputerze.
• Przekaż dokładnie jedną z opcji --message lub --message-file. Wiadomości z pliku zachowują wielowierszową treść po usunięciu opcjonalnego znacznika BOM UTF-8.
• Jeśli żądanie Gateway zakończy się niepowodzeniem, CLI przełącza się na lokalne uruchomienie osadzone; przekroczenie limitu czasu Gateway powoduje przełączenie z nową sesją zamiast rywalizacji z pierwotnym transkryptem.
• Wybór sesji: --to wyprowadza klucz sesji (odbiorcy grupowi i kanałowi zachowują izolację; czaty bezpośrednie są sprowadzane do main). Gdy --agent, --channel i --to są używane razem, trasowanie wykorzystuje kanonicznego odbiorcę kanału oraz session.dmScope. Stabilne tożsamości używane wyłącznie do wysyłania korzystają z sesji należącej do dostawcy, odizolowanej od głównej sesji agenta.
• --session-key wybiera jawny klucz. Klucze z prefiksem agenta muszą mieć postać agent:<agent-id>:<session-key>, a gdy podano również --agent, jego identyfikator musi być zgodny z tym identyfikatorem agenta. Zwykłe klucze niebędące wartościami specjalnymi są przypisywane do --agent, jeśli go podano; na przykład --agent ops --session-key incident-42 prowadzi do agent:ops:incident-42. Bez --agent zwykłe klucze niebędące wartościami specjalnymi są przypisywane do skonfigurowanego agenta domyślnego. Literały global i unknown pozostają bez zakresu tylko wtedy, gdy nie podano --agent; osadzona ścieżka rezerwowa przypisuje te specjalne sesje do skonfigurowanego agenta domyślnego.
• --reply-channel i --reply-account wpływają tylko na dostarczanie.
• Flagi poziomu rozumowania i szczegółowości są utrwalane w magazynie sesji.
• Dane wyjściowe: domyślnie zwykły tekst lub --json dla ustrukturyzowanego ładunku i metadanych.
• W przypadku --json --deliver dane JSON zawierają stan dostarczania dla wysyłek wysłanych, pominiętych, częściowych i zakończonych niepowodzeniem. Zobacz Stan dostarczania JSON.

​

Przykłady

# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turn with a model override
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"

# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Multiline prompt from a file
openclaw agent --agent ops --message-file ./task.md

# Exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Legacy key scoped to an agent
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​

Powiązane