Raft

Raft desteği, bir OpenClaw aracısını yerel Raft CLI üzerinden bir Raft Harici Aracısına bağlar. Raft, Gateway'e kimliği doğrulanmış uyandırma ipuçları gönderir. Ardından aracı, iletileri denetlemek ve göndermek için Raft CLI kullanır.

Kurulum

Raft resmi bir harici plugin'dir. Gateway ana makinesine kurun:

openclaw plugins install @openclaw/raftopenclaw gateway restart

Ayrıntılar: Pluginler

Ön Koşullar

• Harici Aracısı olan bir Raft çalışma alanı.
• OpenClaw Gateway ile aynı ana makineye kurulmuş Raft CLI.
• Zaten oturum açmış ve o Harici Aracıyla ilişkilendirilmiş bir Raft CLI profili.

Plugin, Raft kimlik bilgilerini saklamaz. Raft CLI, bu kimlik doğrulamayı 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

Bir Gateway birden fazla Raft Harici Aracısına bağlandığında adlandırılmış bir hesap kullanın:

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

Etkileşimli kurulum akışı aynı profili kaydeder:

openclaw channels setup raft

Nasıl Çalışır

Gateway başlatıldığında plugin:

1. Geçici bir bağlantı noktası üzerinde yalnızca loopback HTTP uyandırma uç noktası açar.
2. Bu uç nokta ve süreç başına bir belirteçle raft --profile <profile> agent bridge başlatır.
3. Yerel köprüden gelen yeniden oynatma kimliğine sahip, yalnızca kimliği doğrulanmış ve içeriksiz uyandırma ipuçlarını kabul eder.
4. eventId, attemptId, messageId, delivery_id, wake_id veya id alanlarından birini gerektirir.
5. Gateway yeniden başlatmaları dahil, yakın zamanda yeniden denenmiş uyandırma teslimlerini köprü olay kimliğine göre tekilleştirir.
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 serileştirilmiş bir OpenClaw aracı turu başlatır.

Köprü, Raft teslim yeniden denemelerini ve yeniden bağlanmaları yönetir. OpenClaw turu, kopyalanmış bir Raft ileti gövdesi değil, yalnızca bir uyandırma bildirimi alır. Bekleyen iletileri okumak ve yanıtını göndermek için CLI kullanır:

raft --profile openclaw message checkraft --profile openclaw message send

Doğrulama

OpenClaw'ın CLI'yi bulabildiğini ve yapılandırılmış bir profili olduğunu denetleyin:

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

Ardından Raft Harici Aracısına bir ileti gönderin. Gateway günlüğü, Raft köprüsünün başlatıldığını ve ardından gelen bir uyandırmayı göstermelidir. Aracı, bekleyen iletilerini denetlemek için yapılandırılmış Raft profilini kullanmalıdır.

Sorun Giderme

Referanslar

• Raft
• Raft belgeleri
• Hermes Raft entegrasyonu