English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Developer and self-hosted

Rakit

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:

bash
openclaw plugins install @openclaw/raftopenclaw 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:

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

Untuk akun default, Anda dapat mengatur RAFT_PROFILE di lingkungan Gateway sebagai gantinya:

bash
RAFT_PROFILE=openclaw

Gunakan akun bernama ketika satu Gateway terhubung ke lebih dari satu Raft External Agent:

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

Alur penyiapan interaktif merekam profil yang sama:

bash
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:

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

Verifikasi

Periksa bahwa OpenClaw dapat menemukan CLI dan memiliki profil yang dikonfigurasi:

bash
openclaw channels status --probeopenclaw 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

CLI Raft tidak ditemukan

Instal CLI Raft di host Gateway dan buat raft tersedia di PATH layanan. Verifikasi dengan raft --help, lalu restart Gateway.

Bridge langsung keluar

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.

Bangun tiba tetapi tidak ada respons Raft yang dikirim

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

Was this useful?
On this page

On this page