Skip to main content
Raft, yerel Raft CLI aracılığıyla bir OpenClaw ajanını bir Raft External Agent’a bağlar. Raft, Gateway’e kimliği doğrulanmış uyandırma ipuçları gönderir; ardından ajan, mesajları kontrol etmek ve göndermek için Raft CLI aracını kullanır. Yalnızca doğrudan sohbet desteklenir (gruplar desteklenmez).

​
Kurulum

Raft, resmi bir harici Plugin’dir. Gateway ana makinesine kurun:
Ayrıntılar: Plugin’ler

​
Ön Koşullar

  • External Agent içeren bir Raft çalışma alanı.
  • Raft CLI aracının OpenClaw Gateway ile aynı ana makinede, hizmetin PATH konumunda kurulu olması.
  • Oturumu önceden açılmış ve söz konusu External Agent ile ilişkilendirilmiş bir Raft CLI profili.
Plugin, Raft kimlik bilgilerini saklamaz; Raft CLI bu kimlik doğrulamasını kendi profilinde tutar.

​
Yapılandırma

Profili yapılandırmada ayarlayın:
Varsayılan hesap için bunun yerine Gateway ortamında RAFT_PROFILE ayarlayabilirsiniz:
Tek bir Gateway birden fazla Raft External Agent’a bağlandığında adlandırılmış bir hesap kullanın:
Etkileşimli kurulum aynı profili kaydeder:

​
Çalışma biçimi

Gateway başlatıldığında Plugin:
  1. Geçici bir bağlantı noktasında yalnızca geri döngüden erişilebilen bir HTTP uyandırma uç noktası açar.
  2. Söz konusu uç nokta ve işlem başına bir belirteç ile raft --profile <profile> agent bridge başlatır.
  3. Yerel köprüden yalnızca kimliği doğrulanmış, içeriksiz ve yeniden oynatma kimliğine sahip uyandırma ipuçlarını kabul eder.
  4. Her uyandırma yükünde eventId, attemptId, messageId, delivery_id, wake_id veya id değerlerinden birinin bulunmasını zorunlu kılar.
  5. Yeniden denenen uyandırma teslimlerini, Gateway yeniden başlatmaları da dâhil olmak üzere, köprü olay kimliğine göre 24 saat boyunca yinelenenlerden arındırır.
  6. Geçerli köprü için kararlı bir çalışma zamanı oturumu ve Raft CLI protokolü için boş bir etkinlik boşaltma grubu döndürür.
  7. Kabul edilen her uyandırma için seri hâle getirilmiş bir OpenClaw ajan turu başlatır.
Raft teslimatlarının yeniden denenmesini ve yeniden bağlanmayı köprü yönetir. OpenClaw turu, kopyalanmış bir Raft mesaj gövdesi değil, yalnızca bir uyandırma bildirimi alır. Bekleyen mesajları okumak ve yanıtını göndermek için CLI aracını kullanır:
Raft, anlık mesaj aktarımı değildir. OpenClaw, modelin nihai metnini köprü üzerinden otomatik olarak geri göndermez; bu nedenle ajan, bir uyandırmayı işledikten sonra Raft CLI aracını kullanmalıdır.

​
Doğrulama

OpenClaw’ın CLI aracını bulabildiğini ve yapılandırılmış bir profile sahip olduğunu kontrol edin:
Ardından Raft External Agent’a bir mesaj gönderin. Gateway günlüğünde önce Raft köprüsünün başlatıldığı, ardından gelen bir uyandırma gösterilmelidir. Ajan, bekleyen mesajlarını kontrol etmek için yapılandırılmış Raft profilini kullanmalıdır.

​
Sorun Giderme

Raft CLI aracını Gateway ana makinesine kurun ve hizmetin PATH konumunda raft kullanılabilir hâle getirin. raft --help ile doğrulayın, ardından Gateway’i yeniden başlatın.
Yapılandırılmış profilde oturum açıldığını ve profilin amaçlanan Raft External Agent’a ait olduğunu doğrulayın. CLI tanılamasını görmek için doğrudan raft --profile <profile> agent bridge çalıştırın.
Ajan Raft CLI aracını çağırmadığında bu beklenen bir durumdur. Uyandırma köprüsü mesaj gövdelerini veya otomatik nihai yanıtları taşımaz. Ajanın araç politikasını kontrol edin ve raft --profile <profile> message check ile message send çalıştırabildiğinden emin olun.

​
Kaynaklar