Ana içeriğe atla

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, gelen bir sohbet mesajına gerek olmadan komut satırından tek bir agent turu çalıştırır. Betikli iş akışları, test etme ve programatik teslimat için kullanın.

​
Hızlı başlangıç

1

Run a simple agent turn

openclaw agent --message "What is the weather today?"
Bu, mesajı Gateway üzerinden gönderir ve yanıtı yazdırır.
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"

​
Bayraklar

BayrakAçıklama
--message \<text\>Gönderilecek mesaj (zorunlu)
--to \<dest\>Bir hedeften oturum anahtarı türetir (telefon, sohbet kimliği)
--agent \<id\>Yapılandırılmış bir agent’ı hedefler (main oturumunu kullanır)
--session-id \<id\>Mevcut bir oturumu kimliğine göre yeniden kullanır
--localYerel gömülü çalışma zamanını zorlar (Gateway’i atlar)
--deliverYanıtı bir sohbet kanalına gönderir
--channel \<name\>Teslimat kanalı (whatsapp, telegram, discord, slack vb.)
--reply-to \<target\>Teslimat hedefi geçersiz kılma
--reply-channel \<name\>Teslimat kanalı geçersiz kılma
--reply-account \<id\>Teslimat hesabı kimliği geçersiz kılma
--thinking \<level\>Seçili model profili için düşünme düzeyini ayarlar
--verbose \<on|full|off\>Ayrıntı düzeyini ayarlar
--timeout \<seconds\>Agent zaman aşımını geçersiz kılar
--jsonYapılandırılmış JSON çıktısı verir

​
Davranış

  • Varsayılan olarak CLI Gateway üzerinden gider. Geçerli makinede gömülü çalışma zamanını zorlamak için --local ekleyin.
  • 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 yalıtımı korur; doğrudan sohbetler main altında birleşir).
  • Düşünme ve ayrıntı bayrakları oturum deposunda kalıcı olur.
  • Çıktı: varsayılan olarak düz metin ya da 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 teslimat durumunu içerir. Bkz. JSON teslimat 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

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

​
İlgili

Agent CLI reference

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

Sub-agents

Arka plan alt agent oluşturma.

Sessions

Oturum anahtarlarının nasıl çalıştığı ve --to, --agent ile --session-id değerlerinin bunları nasıl çözdüğü.

Slash commands

Agent oturumlarında kullanılan yerel komut kataloğu.