Sal Sal

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

Kurulum

Raft, resmî 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'ın OpenClaw Gateway ile aynı ana makineye ve hizmetin PATH ortam değişkeninde bulunacak şekilde kurulmuş olması.
• Oturum açılmış ve ilgili External Agent ile ilişkilendirilmiş bir Raft CLI profili.

Plugin, Raft kimlik bilgilerini saklamaz; Raft CLI bu kimlik doğrulama bilgilerini kendi profilinde tutar.

Yapılandırma

Yapılandırmada profili ayarlayın:

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

Varsayılan hesap için bunun yerine Gateway ortamında RAFT_PROFILE değişkenini ayarlayabilirsiniz:

RAFT_PROFILE=openclaw

Tek bir Gateway birden fazla Raft External Agent'a bağlandığında adlandırılmış hesaplar 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 şekli

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

1. Geçici bir bağlantı noktasında yalnızca local loopback üzerinden erişilebilen bir HTTP uyandırma uç noktası açar.
2. Bu uç nokta ve işleme özgü bir belirteçle raft --profile <profile> agent bridge komutunu başlatır.
3. Yerel köprüden gelen yalnızca kimliği doğrulanmış, içeriksiz ve yeniden oynatma kimliğine sahip uyandırma bildirimlerini kabul eder.
4. Her uyandırma yükünde eventId, attemptId, messageId, delivery_id, wake_id veya id alanlarından birinin bulunmasını zorunlu kılar.
5. Yeniden denenen uyandırma teslimatlarını, Gateway yeniden başlatmaları da dâhil olmak üzere, köprü olay kimliğine göre 24 saat boyunca 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 seri hâle getirilmiş bir OpenClaw ajan turu başlatır.

Raft teslimat yeniden denemelerinin ve yeniden bağlantıların yönetimi köprüye aittir. 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'ı kullanır:

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

Doğrulama

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

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ırmanın alındığı görülmelidir. 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