Langsung ke konten utama
Dukungan Raft menghubungkan agen OpenClaw ke Raft External Agent melalui CLI Raft lokal. Raft mengirimkan petunjuk bangun terautentikasi ke Gateway. Agen kemudian menggunakan CLI Raft untuk memeriksa dan mengirim pesan.

​
Instal

Raft adalah plugin eksternal resmi. Instal di host Gateway: 
openclaw plugins install @openclaw/raft
openclaw gateway restart
Detail: Plugin

​
Prasyarat

  • Workspace Raft dengan External Agent.
  • CLI Raft terinstal pada host yang sama dengan Gateway OpenClaw.
  • Profil CLI Raft yang sudah masuk dan terkait dengan External Agent tersebut.
Plugin tidak menyimpan kredensial Raft. CLI Raft menyimpan autentikasi tersebut di profilnya sendiri.

​
Konfigurasi

Atur profil dalam konfigurasi: 
{
  channels: {
    raft: {
      enabled: true,
      profile: "openclaw",
    },
  },
}
Untuk akun default, Anda dapat mengatur RAFT_PROFILE di lingkungan Gateway sebagai gantinya: 
RAFT_PROFILE=openclaw
Gunakan akun bernama ketika satu Gateway terhubung ke lebih dari satu Raft External Agent: 
{
  channels: {
    raft: {
      accounts: {
        support: {
          profile: "support-agent",
        },
        engineering: {
          profile: "engineering-agent",
        },
      },
    },
  },
}
Alur penyiapan interaktif merekam profil yang sama: 
openclaw channels setup raft

​
Cara Kerjanya

Saat Gateway dimulai, plugin:
  1. Membuka endpoint bangun HTTP hanya-loopback pada port sementara.
  2. Memulai raft --profile <profile> agent bridge dengan endpoint tersebut dan token per proses.
  3. Hanya menerima petunjuk bangun terautentikasi tanpa konten dengan identitas replay dari bridge lokal.
  4. Memerlukan salah satu dari eventId, attemptId, messageId, delivery_id, wake_id, atau id.
  5. Mendeduplikasi pengiriman bangun ulang terbaru berdasarkan ID peristiwa bridge, termasuk lintas restart Gateway.
  6. Mengembalikan sesi runtime yang stabil untuk bridge saat ini dan batch pengurasan aktivitas kosong untuk protokol CLI Raft.
  7. Memulai satu giliran agen OpenClaw terserialisasi untuk setiap bangun yang diterima.
Bridge memiliki percobaan ulang pengiriman Raft dan koneksi ulang. Giliran OpenClaw menerima hanya pemberitahuan bangun, bukan salinan isi pesan Raft. Ia menggunakan CLI untuk membaca pesan tertunda dan mengirim responsnya: 
raft --profile openclaw message check
raft --profile openclaw message send
Raft bukan transport pesan push normal. OpenClaw tidak secara otomatis mengirim teks akhir model kembali melalui bridge, jadi agen harus menggunakan CLI Raft setelah memproses bangun.

​
Verifikasi

Periksa bahwa OpenClaw dapat menemukan CLI dan memiliki profil yang dikonfigurasi: 
openclaw channels status --probe
openclaw plugins inspect raft --runtime --json
Lalu kirim pesan ke Raft External Agent. Log Gateway seharusnya menampilkan bridge Raft dimulai, diikuti bangun masuk. Agen seharusnya menggunakan profil Raft yang dikonfigurasi untuk memeriksa pesan tertundanya.

​
Pemecahan Masalah

Instal CLI Raft di host Gateway dan buat raft tersedia di PATH layanan. Verifikasi dengan raft --help, lalu restart Gateway.
Verifikasi profil yang dikonfigurasi sudah masuk dan milik Raft External Agent yang dimaksud. Jalankan raft --profile <profile> agent bridge secara langsung untuk melihat diagnostik CLI.
Ini diharapkan ketika agen tidak memanggil CLI Raft. Bridge bangun tidak membawa isi pesan atau balasan akhir otomatis. Periksa kebijakan alat agen dan pastikan agen dapat menjalankan raft --profile <profile> message check dan message send.

​
Referensi