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

​
इंस्टॉल करें

Raft एक आधिकारिक बाहरी Plugin है। इसे Gateway होस्ट पर इंस्टॉल करें: 
openclaw plugins install @openclaw/raft
openclaw gateway restart
विवरण: Plugins

​
आवश्यकताएँ

  • एक Raft वर्कस्पेस जिसमें बाहरी एजेंट हो।
  • OpenClaw Gateway वाले उसी होस्ट पर Raft CLI इंस्टॉल हो।
  • एक Raft CLI प्रोफ़ाइल जो पहले से साइन इन हो और उस बाहरी एजेंट से जुड़ी हो।
Plugin Raft क्रेडेंशियल संग्रहीत नहीं करता। Raft CLI उस प्रमाणीकरण को अपनी प्रोफ़ाइल में रखता है।

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

कॉन्फ़िग में प्रोफ़ाइल सेट करें: 
{
  channels: {
    raft: {
      enabled: true,
      profile: "openclaw",
    },
  },
}
डिफ़ॉल्ट खाते के लिए, आप इसके बजाय Gateway परिवेश में RAFT_PROFILE सेट कर सकते हैं: 
RAFT_PROFILE=openclaw
जब एक Gateway एक से अधिक Raft बाहरी एजेंट से जुड़ता है, तो नामित खाते का उपयोग करें: 
{
  channels: {
    raft: {
      accounts: {
        support: {
          profile: "support-agent",
        },
        engineering: {
          profile: "engineering-agent",
        },
      },
    },
  },
}
इंटरैक्टिव सेटअप फ़्लो वही प्रोफ़ाइल रिकॉर्ड करता है: 
openclaw channels setup raft

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

जब Gateway शुरू होता है, तो Plugin:
  1. एक अस्थायी पोर्ट पर केवल loopback वाला HTTP वेक एंडपॉइंट खोलता है।
  2. उस एंडपॉइंट और प्रति-प्रक्रिया टोकन के साथ raft --profile <profile> agent bridge शुरू करता है।
  3. स्थानीय ब्रिज से केवल प्रमाणित, सामग्री-रहित वेक संकेत स्वीकार करता है जिनमें रीप्ले पहचान हो।
  4. eventId, attemptId, messageId, delivery_id, wake_id, या id में से एक की आवश्यकता रखता है।
  5. ब्रिज इवेंट आईडी के आधार पर हाल की दोबारा कोशिश की गई वेक डिलीवरी को डीडुप्लिकेट करता है, Gateway पुनरारंभों के पार भी।
  6. मौजूदा ब्रिज के लिए एक स्थिर रनटाइम सेशन और Raft CLI प्रोटोकॉल के लिए एक खाली गतिविधि-ड्रेन बैच लौटाता है।
  7. हर स्वीकार किए गए वेक के लिए एक क्रमबद्ध OpenClaw एजेंट टर्न शुरू करता है।
ब्रिज Raft डिलीवरी की दोबारा कोशिशों और पुनःकनेक्शन का स्वामी होता है। OpenClaw टर्न को केवल वेक सूचना मिलती है, कॉपी किया गया Raft संदेश बॉडी नहीं। यह लंबित संदेश पढ़ने और अपनी प्रतिक्रिया भेजने के लिए CLI का उपयोग करता है: 
raft --profile openclaw message check
raft --profile openclaw message send
Raft कोई सामान्य पुश-संदेश ट्रांसपोर्ट नहीं है। OpenClaw मॉडल का अंतिम टेक्स्ट अपने आप ब्रिज के माध्यम से वापस नहीं भेजता, इसलिए एजेंट को वेक प्रोसेस करने के बाद Raft CLI का उपयोग करना होगा।

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

जांचें कि OpenClaw CLI ढूंढ सकता है और उसके पास कॉन्फ़िगर की गई प्रोफ़ाइल है: 
openclaw channels status --probe
openclaw plugins inspect raft --runtime --json
फिर Raft बाहरी एजेंट को संदेश भेजें। Gateway लॉग में Raft ब्रिज शुरू होते हुए, उसके बाद इनबाउंड वेक दिखना चाहिए। एजेंट को अपने लंबित संदेशों की जांच के लिए कॉन्फ़िगर की गई Raft प्रोफ़ाइल का उपयोग करना चाहिए।

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

Gateway होस्ट पर Raft CLI इंस्टॉल करें और raft को सेवा के PATH पर उपलब्ध कराएं। इसे raft --help से सत्यापित करें, फिर Gateway को पुनरारंभ करें।
सत्यापित करें कि कॉन्फ़िगर की गई प्रोफ़ाइल साइन इन है और इच्छित Raft बाहरी एजेंट से संबंधित है। CLI डायग्नोस्टिक देखने के लिए raft --profile <profile> agent bridge सीधे चलाएं।
जब एजेंट Raft CLI को invoke नहीं करता, तो यह अपेक्षित है। वेक ब्रिज संदेश बॉडी या स्वचालित अंतिम उत्तर नहीं ले जाता। एजेंट की टूल नीति जांचें और सुनिश्चित करें कि वह raft --profile <profile> message check और message send चला सकता है।

​
संदर्भ