Skip to main content
Raft menghubungkan agen OpenClaw ke Agen Eksternal Raft melalui CLI Raft lokal. Raft mengirimkan petunjuk pembangkitan terautentikasi ke Gateway; agen kemudian menggunakan CLI Raft untuk memeriksa dan mengirim pesan. Hanya percakapan langsung (tanpa grup).

​
Instalasi

Raft adalah plugin eksternal resmi. Instal di host Gateway:
Detail: Plugin

​
Prasyarat

  • Ruang kerja Raft dengan Agen Eksternal.
  • CLI Raft terinstal di host yang sama dengan Gateway OpenClaw dan tersedia di PATH layanan.
  • Profil CLI Raft yang sudah masuk dan dikaitkan dengan Agen Eksternal tersebut.
Plugin tidak menyimpan kredensial Raft; CLI Raft menyimpan autentikasi tersebut dalam profilnya sendiri.

​
Konfigurasi

Tetapkan profil dalam konfigurasi:
Untuk akun default, Anda dapat menetapkan RAFT_PROFILE di lingkungan Gateway sebagai gantinya:
Gunakan akun bernama ketika satu Gateway terhubung ke lebih dari satu Agen Eksternal Raft:
Penyiapan interaktif mencatat profil yang sama:

​
Cara kerjanya

Saat Gateway dimulai, plugin:
  1. Membuka endpoint HTTP pembangkitan khusus loopback pada porta sementara.
  2. Menjalankan raft --profile <profile> agent bridge dengan endpoint tersebut dan token per proses.
  3. Hanya menerima petunjuk pembangkitan terautentikasi tanpa konten yang memiliki identitas pemutaran ulang dari jembatan lokal.
  4. Mewajibkan salah satu dari eventId, attemptId, messageId, delivery_id, wake_id, atau id pada setiap muatan pembangkitan.
  5. Mendeduplikasi pengiriman ulang pembangkitan berdasarkan ID peristiwa jembatan selama 24 jam, termasuk setelah Gateway dimulai ulang.
  6. Mengembalikan sesi waktu proses yang stabil untuk jembatan saat ini dan kumpulan pengurasan aktivitas kosong untuk protokol CLI Raft.
  7. Memulai satu giliran agen OpenClaw yang diserialkan untuk setiap pembangkitan yang diterima.
Jembatan menangani percobaan ulang pengiriman dan penyambungan kembali Raft. Giliran OpenClaw hanya menerima pemberitahuan pembangkitan, bukan salinan isi pesan Raft. Agen menggunakan CLI untuk membaca pesan tertunda dan mengirim responsnya:
Raft bukan transportasi pesan dorong. OpenClaw tidak secara otomatis mengirim teks akhir model kembali melalui jembatan, sehingga agen harus menggunakan CLI Raft setelah memproses pembangkitan.

​
Verifikasi

Periksa apakah OpenClaw dapat menemukan CLI dan memiliki profil yang telah dikonfigurasi:
Kemudian kirim pesan ke Agen Eksternal Raft. Log Gateway seharusnya menunjukkan jembatan Raft dimulai, diikuti oleh pembangkitan masuk. Agen harus menggunakan profil Raft yang dikonfigurasi untuk memeriksa pesan tertundanya.

​
Pemecahan masalah

Instal CLI Raft di host Gateway dan pastikan raft tersedia di PATH layanan. Verifikasi dengan raft --help, lalu mulai ulang Gateway.
Pastikan profil yang dikonfigurasi sudah masuk dan merupakan milik Agen Eksternal Raft yang dituju. Jalankan raft --profile <profile> agent bridge secara langsung untuk melihat diagnostik CLI.
Hal ini wajar jika agen tidak menjalankan CLI Raft. Jembatan pembangkitan 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