Skip to main content
Raft स्थानीय Raft CLI के माध्यम से एक OpenClaw एजेंट को Raft External Agent से जोड़ता है। Raft Gateway को प्रमाणीकृत वेक संकेत भेजता है; इसके बाद एजेंट संदेशों की जाँच करने और उन्हें भेजने के लिए Raft CLI का उपयोग करता है। केवल प्रत्यक्ष चैट (कोई समूह नहीं)।

इंस्टॉल करें

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

पूर्वापेक्षाएँ

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

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

कॉन्फ़िगरेशन में प्रोफ़ाइल सेट करें:
डिफ़ॉल्ट खाते के लिए, इसके बजाय Gateway परिवेश में RAFT_PROFILE सेट किया जा सकता है:
जब एक Gateway एक से अधिक Raft External Agent से जुड़ता है, तो नामित खाते का उपयोग करें:
इंटरैक्टिव सेटअप उसी प्रोफ़ाइल को रिकॉर्ड करता है:

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

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

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

जाँचें कि OpenClaw CLI को खोज सकता है और उसमें एक कॉन्फ़िगर की गई प्रोफ़ाइल है:
फिर Raft External Agent को एक संदेश भेजें। Gateway लॉग में पहले Raft ब्रिज का प्रारंभ होना और उसके बाद एक इनबाउंड वेक दिखाई देना चाहिए। एजेंट को अपने लंबित संदेशों की जाँच करने के लिए कॉन्फ़िगर की गई Raft प्रोफ़ाइल का उपयोग करना चाहिए।

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

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

संदर्भ