Agent coordination

Wysyłanie przez agenta

openclaw agent uruchamia pojedynczą turę agenta z wiersza poleceń bez potrzeby przychodzącej wiadomości czatu. Używaj go do skryptowanych przepływów pracy, testowania i dostarczania programowego.

Szybki start

Uruchom prostą turę agenta

bash

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

To wysyła wiadomość przez Gateway i wypisuje odpowiedź.

Wyślij wielowierszowy prompt z pliku

bash

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

To odczytuje poprawny plik UTF-8 jako treść wiadomości agenta.

Wskaż konkretnego 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ść inline do wysłania
`--message-file \<path\>`	Odczytaj wiadomość z poprawnego pliku UTF-8
`--to \<dest\>`	Wyprowadź klucz sesji z celu (telefonu, identyfikatora czatu)
`--session-key \<key\>`	Użyj jawnego klucza sesji
`--agent \<id\>`	Wskaż skonfigurowanego agenta (używa jego sesji `main`)
`--session-id \<id\>`	Użyj ponownie istniejącej sesji według identyfikatora
`--local`	Wymuś lokalne osadzone środowisko uruchomieniowe (pomiń Gateway)
`--deliver`	Wyślij odpowiedź do kanału czatu
`--channel \<name\>`	Kanał dostarczania (whatsapp, telegram, discord, slack itd.)
`--reply-to \<target\>`	Nadpisanie celu dostarczania
`--reply-channel \<name\>`	Nadpisanie kanału dostarczania
`--reply-account \<id\>`	Nadpisanie identyfikatora konta dostarczania
`--thinking \<level\>`	Ustaw poziom myślenia dla wybranego profilu modelu
`--verbose \<on\|full\|off\>`	Ustaw poziom szczegółowości
`--timeout \<seconds\>`	Nadpisz limit czasu agenta
`--json`	Wypisz ustrukturyzowany JSON

Zachowanie

Domyślnie CLI przechodzi przez Gateway. Dodaj --local, aby wymusić osadzone środowisko uruchomieniowe na bieżącej maszynie.
Przekaż dokładnie jedną z opcji --message albo --message-file. Wiadomości z pliku zachowują treść wielowierszową po usunięciu opcjonalnego znacznika BOM UTF-8.
Jeśli Gateway jest nieosiągalny, CLI wraca do lokalnego uruchomienia osadzonego.
Wybór sesji: --to wyprowadza klucz sesji (cele grup/kanałów zachowują izolację; czaty bezpośrednie są sprowadzane do main).
--session-key wybiera jawny klucz. Klucze z prefiksem agenta muszą używać formatu agent:<agent-id>:<session-key>, a --agent musi pasować do tego identyfikatora agenta, gdy podano oba. Gołe klucze niebędące sentinelem są ograniczane zakresem do --agent, gdy go podano; na przykład --agent ops --session-key incident-42 kieruje do agent:ops:incident-42. Bez --agent gołe klucze niebędące sentinelem są ograniczane do skonfigurowanego domyślnego agenta. Literały global i unknown pozostają bez zakresu tylko wtedy, gdy nie podano --agent; w takim przypadku osadzony fallback i własność magazynu używają skonfigurowanego domyślnego agenta.
Flagi myślenia i szczegółowości są utrwalane w magazynie sesji.
Dane wyjściowe: domyślnie zwykły tekst albo --json dla ustrukturyzowanego ładunku i metadanych.
Z --json --deliver JSON zawiera status dostarczania dla wysyłek wysłanych, pominiętych, częściowych i nieudanych. Zobacz status dostarczania JSON.

Przykłady

bash

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