Agent coordination

Wysyłanie przez agenta

openclaw agent uruchamia pojedynczą turę agenta z wiersza poleceń bez przychodzącej wiadomości czatu. Używaj go w skryptowanych przepływach pracy, testach i dostarczaniu programistycznym. Pełna dokumentacja flag i zachowania: Dokumentacja CLI agenta.

Szybki start

Uruchom prostą turę agenta

bash

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

Wysyła wiadomość przez Gateway i wyświetla odpowiedź.

Wyślij wielowierszowy monit z pliku

bash

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

Odczytuje prawidłowy plik UTF-8 jako treść wiadomości agenta.

Wybierz określonego agenta lub sesję

bash

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

Dostarcz odpowiedź do kanału

bash

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

Flagi

Flaga	Opis
`--message <text>`	Wiadomość wbudowana do wysłania
`--message-file <path>`	Odczytanie wiadomości z prawidłowego pliku UTF-8
`--to <dest>`	Wyprowadzenie klucza sesji z odbiorcy (telefonu, identyfikatora czatu)
`--session-key <key>`	Użycie jawnego klucza sesji
`--agent <id>`	Wybór skonfigurowanego agenta (używa jego sesji `main`)
`--session-id <id>`	Ponowne użycie istniejącej sesji według identyfikatora
`--model <id>`	Zastąpienie modelu dla tego uruchomienia (`provider/model` lub identyfikator modelu)
`--local`	Wymuszenie lokalnego, osadzonego środowiska wykonawczego (z pominięciem Gateway)
`--deliver`	Wysłanie odpowiedzi do kanału czatu
`--channel <name>`	Kanał dostarczania; z `--agent` + `--to` dotyczy również zakresu wiadomości bezpośrednich
`--reply-to <target>`	Zastąpienie odbiorcy dostarczania
`--reply-channel <name>`	Zastąpienie kanału dostarczania
`--reply-account <id>`	Zastąpienie identyfikatora konta używanego do dostarczania
`--thinking <level>`	Ustawienie poziomu rozumowania dla wybranego profilu modelu
`--verbose <on\|full\|off>`	Utrwalenie poziomu szczegółowości dla sesji (`full` rejestruje także dane wyjściowe narzędzi)
`--timeout <seconds>`	Zastąpienie limitu czasu agenta (domyślnie 600 lub wartość konfiguracji)
`--json`	Wyświetlenie ustrukturyzowanego formatu JSON

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

bash

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