Ana içeriğe atla
openclaw agent, gelen bir sohbet mesajına gerek kalmadan komut satırından tek bir agent turu çalıştırır. Bunu betiklenmiş iş akışları, test ve programatik teslim için kullanın.

​
Hızlı başlangıç

1

Basit bir agent turu çalıştırın

openclaw agent --agent main --message "What is the weather today?"
Bu, mesajı Gateway üzerinden gönderir ve yanıtı yazdırır.
2

Bir dosyadan çok satırlı prompt gönderin

openclaw agent --agent ops --message-file ./task.md
Bu, geçerli bir UTF-8 dosyasını agent mesaj gövdesi olarak okur.
3

Belirli bir agent veya oturumu hedefleyin

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

Yanıtı bir kanala teslim edin

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

​
Bayraklar

BayrakAçıklama
--message \<text\>Gönderilecek satır içi mesaj
--message-file \<path\>Mesajı geçerli bir UTF-8 dosyasından oku
--to \<dest\>Bir hedeften (telefon, sohbet kimliği) oturum anahtarı türet
--session-key \<key\>Açık bir oturum anahtarı kullan
--agent \<id\>Yapılandırılmış bir agent’ı hedefle (main oturumunu kullanır)
--session-id \<id\>Mevcut bir oturumu kimliğe göre yeniden kullan
--localYerel gömülü çalışma zamanını zorla (Gateway’i atla)
--deliverYanıtı bir sohbet kanalına gönder
--channel \<name\>Teslim kanalı (whatsapp, telegram, discord, slack, vb.)
--reply-to \<target\>Teslim hedefi geçersiz kılması
--reply-channel \<name\>Teslim kanalı geçersiz kılması
--reply-account \<id\>Teslim hesap kimliği geçersiz kılması
--thinking \<level\>Seçili model profili için düşünme düzeyini ayarla
--verbose \<on|full|off\>Ayrıntılılık düzeyini ayarla
--timeout \<seconds\>Agent zaman aşımını geçersiz kıl
--jsonYapılandırılmış JSON çıktısı üret

​
Davranış

  • Varsayılan olarak CLI Gateway üzerinden gider. Mevcut makinede gömülü çalışma zamanını zorlamak için --local ekleyin.
  • --message veya --message-file seçeneklerinden tam olarak birini geçirin. Dosya mesajları, isteğe bağlı bir UTF-8 BOM kaldırıldıktan sonra çok satırlı içeriği korur.
  • Gateway’e ulaşılamazsa CLI, yerel gömülü çalıştırmaya geri döner.
  • Oturum seçimi: --to oturum anahtarını türetir (grup/kanal hedefleri izolasyonu korur; doğrudan sohbetler main altında birleşir).
  • --session-key açık bir anahtar seçer. Agent önekli anahtarlar agent:<agent-id>:<session-key> kullanmalıdır ve ikisi de sağlandığında --agent o agent kimliğiyle eşleşmelidir. Çıplak sentinel olmayan anahtarlar, sağlandığında --agent kapsamına alınır; örneğin, --agent ops --session-key incident-42, agent:ops:incident-42 hedefine yönlendirilir. --agent olmadan, çıplak sentinel olmayan anahtarlar yapılandırılmış varsayılan agent kapsamına alınır. Gerçek global ve unknown, yalnızca --agent sağlanmadığında kapsamsız kalır; bu durumda gömülü geri dönüş ve depo sahipliği yapılandırılmış varsayılan agent’ı kullanır.
  • Düşünme ve ayrıntılılık bayrakları oturum deposuna kalıcı olarak yazılır.
  • Çıktı: varsayılan olarak düz metin veya yapılandırılmış yük + meta veriler için --json.
  • --json --deliver ile JSON; gönderilen, bastırılan, kısmi ve başarısız gönderimler için teslim durumunu içerir. Bkz. JSON teslim durumu.

​
Örnekler

# 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

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

​
İlgili

Agent CLI başvurusu

Tam openclaw agent bayrak ve seçenek başvurusu.

Alt agent'lar

Arka planda alt agent oluşturma.

Oturumlar

Oturum anahtarlarının nasıl çalıştığı ve --to, --agent ile --session-id seçeneklerinin bunları nasıl çözümlediği.

Slash komutları

Agent oturumları içinde kullanılan yerel komut kataloğu.