Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Szybki start

1

Run a simple agent turn

openclaw agent --message "What is the weather today?"
To wysyła wiadomość przez Gateway i wypisuje odpowiedź.
2

Target a specific agent or session

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

Deliver the reply to a channel

# 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

FlagaOpis
--message \<text\>Wiadomość do wysłania (wymagana)
--to \<dest\>Wyprowadź klucz sesji z celu (telefon, identyfikator czatu)
--agent \<id\>Wybierz skonfigurowanego agenta (używa jego sesji main)
--session-id \<id\>Użyj ponownie istniejącej sesji według identyfikatora
--localWymuś lokalne osadzone środowisko wykonawcze (pomiń Gateway)
--deliverWyś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
--jsonWypisz ustrukturyzowany JSON

​
Zachowanie

  • Domyślnie CLI przechodzi przez Gateway. Dodaj --local, aby wymusić osadzone środowisko wykonawcze na bieżącej maszynie.
  • Jeśli Gateway jest nieosiągalny, CLI wraca do lokalnego osadzonego uruchomienia.
  • Wybór sesji: --to wyprowadza klucz sesji (cele grup/kanałów zachowują izolację; czaty bezpośrednie zwijają się do main).
  • Flagi myślenia i szczegółowości są utrwalane w magazynie sesji.
  • Wyjście: domyślnie zwykły tekst albo --json dla ustrukturyzowanego ładunku + metadanych.
  • Z --json --deliver JSON obejmuje status dostarczania dla wysyłek wysłanych, wstrzymanych, częściowych i nieudanych. Zobacz status dostarczania JSON.

​
Przykłady

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

​
Powiązane

Agent CLI reference

Pełna dokumentacja flag i opcji openclaw agent.

Sub-agents

Uruchamianie podagentów w tle.

Sessions

Jak działają klucze sesji i jak --to, --agent oraz --session-id je rozpoznają.

Slash commands

Natywny katalog poleceń używany wewnątrz sesji agenta.