Agent coordination

Ajan gönderimi

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ıç

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

bash

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

Bu, mesajı Gateway üzerinden gönderir ve yanıtı yazdırır.

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

bash

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

Bu, geçerli bir UTF-8 dosyasını agent mesaj gövdesi olarak okur.

Belirli bir agent veya oturumu hedefleyin

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"

Yanıtı bir kanala teslim edin

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"

Bayraklar

Bayrak	Açı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
`--local`	Yerel gömülü çalışma zamanını zorla (Gateway'i atla)
`--deliver`	Yanı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
`--json`	Yapı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

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"