Raft

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

इंस्टॉल करें

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

openclaw plugins install @openclaw/raftopenclaw gateway restart

विवरण: Plugins

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

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

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

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

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

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

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

RAFT_PROFILE=openclaw

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

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

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

openclaw channels add --channel raft

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

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 --profile openclaw message checkraft --profile openclaw message send

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

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

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

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

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

संदर्भ

• Raft
• Raft दस्तावेज़
• Hermes Raft एकीकरण