Raft

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:

openclaw plugins install @openclaw/raftopenclaw gateway restart

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:

{  channels: {    raft: {      enabled: true,      profile: "openclaw",    },  },}

Varsayılan hesap için bunun yerine Gateway ortamında RAFT_PROFILE ayarlayabilirsiniz:

RAFT_PROFILE=openclaw

Tek bir Gateway birden fazla Raft External Agent'a bağlandığında adlandırılmış bir hesap kullanın:

{  channels: {    raft: {      accounts: {        support: {          profile: "support-agent",        },        engineering: {          profile: "engineering-agent",        },      },    },  },}

Etkileşimli kurulum aynı profili kaydeder:

openclaw channels add --channel raft

Ç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 --profile openclaw message checkraft --profile openclaw message send

Doğrulama

OpenClaw'ın CLI aracını bulabildiğini ve yapılandırılmış bir profile sahip olduğunu kontrol edin:

openclaw channels status --probeopenclaw plugins inspect raft --runtime --json

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

Kaynaklar

• Raft
• Raft belgeleri
• Hermes Raft entegrasyonu