Developer and self-hosted

बेड़ा

Raft समर्थन किसी OpenClaw एजेंट को स्थानीय Raft CLI के माध्यम से Raft बाहरी एजेंट से जोड़ता है। Raft Gateway को प्रमाणित वेक संकेत भेजता है। फिर एजेंट संदेशों की जांच करने और भेजने के लिए Raft CLI का उपयोग करता है।

इंस्टॉल करें

Raft एक आधिकारिक बाहरी Plugin है। इसे Gateway होस्ट पर इंस्टॉल करें:

bash

openclaw plugins install @openclaw/raftopenclaw gateway restart

विवरण: Plugins

आवश्यकताएँ

एक Raft वर्कस्पेस जिसमें बाहरी एजेंट हो।
OpenClaw Gateway वाले उसी होस्ट पर Raft CLI इंस्टॉल हो।
एक Raft CLI प्रोफ़ाइल जो पहले से साइन इन हो और उस बाहरी एजेंट से जुड़ी हो।

Plugin Raft क्रेडेंशियल संग्रहीत नहीं करता। Raft CLI उस प्रमाणीकरण को अपनी प्रोफ़ाइल में रखता है।

कॉन्फ़िगर करें

कॉन्फ़िग में प्रोफ़ाइल सेट करें:

json5

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

डिफ़ॉल्ट खाते के लिए, आप इसके बजाय Gateway परिवेश में RAFT_PROFILE सेट कर सकते हैं:

bash

RAFT_PROFILE=openclaw

जब एक Gateway एक से अधिक Raft बाहरी एजेंट से जुड़ता है, तो नामित खाते का उपयोग करें:

json5

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

इंटरैक्टिव सेटअप फ़्लो वही प्रोफ़ाइल रिकॉर्ड करता है:

bash

openclaw channels setup raft

यह कैसे काम करता है

जब Gateway शुरू होता है, तो Plugin:

एक अस्थायी पोर्ट पर केवल loopback वाला HTTP वेक एंडपॉइंट खोलता है।
उस एंडपॉइंट और प्रति-प्रक्रिया टोकन के साथ raft --profile <profile> agent bridge शुरू करता है।
स्थानीय ब्रिज से केवल प्रमाणित, सामग्री-रहित वेक संकेत स्वीकार करता है जिनमें रीप्ले पहचान हो।
eventId, attemptId, messageId, delivery_id, wake_id, या id में से एक की आवश्यकता रखता है।
ब्रिज इवेंट आईडी के आधार पर हाल की दोबारा कोशिश की गई वेक डिलीवरी को डीडुप्लिकेट करता है, Gateway पुनरारंभों के पार भी।
मौजूदा ब्रिज के लिए एक स्थिर रनटाइम सेशन और Raft CLI प्रोटोकॉल के लिए एक खाली गतिविधि-ड्रेन बैच लौटाता है।
हर स्वीकार किए गए वेक के लिए एक क्रमबद्ध OpenClaw एजेंट टर्न शुरू करता है।

ब्रिज Raft डिलीवरी की दोबारा कोशिशों और पुनःकनेक्शन का स्वामी होता है। OpenClaw टर्न को केवल वेक सूचना मिलती है, कॉपी किया गया Raft संदेश बॉडी नहीं। यह लंबित संदेश पढ़ने और अपनी प्रतिक्रिया भेजने के लिए CLI का उपयोग करता है:

bash

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

सत्यापित करें

जांचें कि OpenClaw CLI ढूंढ सकता है और उसके पास कॉन्फ़िगर की गई प्रोफ़ाइल है:

bash

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

फिर Raft बाहरी एजेंट को संदेश भेजें। Gateway लॉग में Raft ब्रिज शुरू होते हुए, उसके बाद इनबाउंड वेक दिखना चाहिए। एजेंट को अपने लंबित संदेशों की जांच के लिए कॉन्फ़िगर की गई Raft प्रोफ़ाइल का उपयोग करना चाहिए।

समस्या निवारण

Raft CLI मौजूद नहीं है

Gateway होस्ट पर Raft CLI इंस्टॉल करें और raft को सेवा के PATH पर उपलब्ध कराएं। इसे raft --help से सत्यापित करें, फिर Gateway को पुनरारंभ करें।

ब्रिज तुरंत बंद हो जाता है

सत्यापित करें कि कॉन्फ़िगर की गई प्रोफ़ाइल साइन इन है और इच्छित Raft बाहरी एजेंट से संबंधित है। CLI डायग्नोस्टिक देखने के लिए raft --profile <profile> agent bridge सीधे चलाएं।

वेक आता है लेकिन कोई Raft प्रतिक्रिया नहीं भेजी जाती

जब एजेंट Raft CLI को invoke नहीं करता, तो यह अपेक्षित है। वेक ब्रिज संदेश बॉडी या स्वचालित अंतिम उत्तर नहीं ले जाता। एजेंट की टूल नीति जांचें और सुनिश्चित करें कि वह raft --profile <profile> message check और message send चला सकता है।

संदर्भ

Was this useful?

बेड़ा

इंस्टॉल करें

आवश्यकताएँ

कॉन्फ़िगर करें

यह कैसे काम करता है

सत्यापित करें

समस्या निवारण

संदर्भ

On this page

Molty