openclaw agent, gelen bir sohbet mesajı olmadan komut satırından tek bir ajan turu çalıştırır. Betikli iş akışları, test ve programatik teslimat için kullanın. Bayrakların ve davranışların tam başvurusu:
Ajan CLI başvurusu.
Hızlı başlangıç
1
Basit bir ajan turu çalıştırın
2
Bir dosyadan çok satırlı istem gönderin
3
Belirli bir ajanı veya oturumu hedefleyin
4
Yanıtı bir kanala teslim edin
Bayraklar
Davranış
- CLI, varsayılan olarak Gateway üzerinden çalışır. Geçerli makinedeki
gömülü çalışma zamanını zorlamak için
--localekleyin. --messageveya--message-fileseçeneklerinden tam olarak birini belirtin. Dosya mesajları, isteğe bağlı UTF-8 BOM kaldırıldıktan sonra çok satırlı içeriği korur. 4 MiB’den büyük dosyalar gönderimden önce reddedilir.- Geçici el sıkışma yeniden denemelerinden sonra Gateway zaman aşımı veya kapanmış bağlantı,
komutun stderr üzerinde bir ipucuyla başarısız olmasına yol açar; CLI, turu gömülü olarak
hiçbir zaman sessizce yeniden çalıştırmaz. Gateway kabul edilmiş bir turu yine de tamamlayabilir;
bu nedenle
--localile yeniden denemeden veya yeniden çalıştırmadan önce Gateway ve oturum durumunu doğrulayın. - Oturum seçimi:
--tooturum anahtarını türetir (grup/kanal hedefleri yalıtımı korur; doğrudan sohbetlermainolarak birleştirilir).--agent,--channelve--tobirlikte kullanıldığında yönlendirme, kanalın standart alıcısını vesession.dmScopedeğerini izler. Yalnızca giden iletiler için kullanılan kararlı kimlikler, ajanın ana oturumundan yalıtılmış, sağlayıcıya ait bir oturum kullanır. --session-key, açıkça belirtilmiş bir anahtar seçer. Ajan önekli anahtarlaragent:<agent-id>:<session-key>biçimini kullanmalıdır ve ikisi de sağlandığında--agentbu ajan kimliğiyle eşleşmelidir. Özel işaretçi olmayan yalın anahtarlar, sağlandığında--agentkapsamında değerlendirilir; örneğin--agent ops --session-key incident-42,agent:ops:incident-42hedefine yönlendirilir.--agentolmadan özel işaretçi olmayan yalın anahtarlar, yapılandırılmış varsayılan ajan kapsamında değerlendirilir. Değişmezglobalveunknown, yalnızca--agentsağlanmadığında kapsam dışında kalır.--reply-channelve--reply-accountyalnızca teslimatı etkiler.- Düşünme ve ayrıntı bayrakları oturum deposunda kalıcı hâle gelir.
- Çıktı: varsayılan olarak düz metin veya yapılandırılmış yük + meta veriler için
--json. --json --deliverile JSON; gönderilen, engellenen, kısmi ve başarısız teslimatların durumunu içerir. Bkz. JSON teslimat durumu.
Örnekler
İlgili
Ajan CLI başvurusu
openclaw agent bayraklarının ve seçeneklerinin tam başvurusu.Alt ajanlar
Arka planda alt ajan başlatma.
Oturumlar
Oturum anahtarlarının nasıl çalıştığı ve
--to, --agent ile --session-id tarafından nasıl çözümlendiği.Eğik çizgi komutları
Ajan oturumlarında kullanılan yerel komut kataloğu.