Skip to main content
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

Mesajı Gateway üzerinden gönderir ve yanıtı yazdırır.
2

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

Geçerli bir UTF-8 dosyasını ajan mesajının gövdesi olarak okur.
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 --local ekleyin.
  • --message veya --message-file seç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 --local ile yeniden denemeden veya yeniden çalıştırmadan önce Gateway ve oturum durumunu doğrulayın.
  • Oturum seçimi: --to oturum anahtarını türetir (grup/kanal hedefleri yalıtımı korur; doğrudan sohbetler main olarak birleştirilir). --agent, --channel ve --to birlikte kullanıldığında yönlendirme, kanalın standart alıcısını ve session.dmScope değ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 anahtarlar agent:<agent-id>:<session-key> biçimini kullanmalıdır ve ikisi de sağlandığında --agent bu ajan kimliğiyle eşleşmelidir. Özel işaretçi olmayan yalın anahtarlar, sağlandığında --agent kapsamında değerlendirilir; örneğin --agent ops --session-key incident-42, agent:ops:incident-42 hedefine yönlendirilir. --agent olmadan özel işaretçi olmayan yalın anahtarlar, yapılandırılmış varsayılan ajan kapsamında değerlendirilir. Değişmez global ve unknown, yalnızca --agent sağlanmadığında kapsam dışında kalır.
  • --reply-channel ve --reply-account yalnı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 --deliver ile 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.