Gateway समस्या-निवारण
This page is the deep runbook. Start at /help/troubleshooting if you want the fast triage flow first.कमांड सीढ़ी
इन कमांड्स को पहले, इसी क्रम में चलाएँ:openclaw gateway statusमेंRuntime: runningऔरRPC probe: okदिखाई देते हैं।openclaw doctorकिसी भी ब्लॉकिंग विन्यास/सेवा समस्या की रिपोर्ट नहीं करता।openclaw channels status --probeकनेक्टेड/तैयार चैनल दिखाता है।
कोई उत्तर नहीं
यदि चैनल चालू हैं लेकिन कोई उत्तर नहीं आ रहा, तो किसी भी चीज़ को पुनः कनेक्ट करने से पहले रूटिंग और नीति की जाँच करें।- DM प्रेषकों के लिए पेयरिंग लंबित।
- समूह मेंशन गेटिंग (
requireMention,mentionPatterns)। - चैनल/समूह अनुमति-सूची (allowlist) में असंगति।
drop guild message (mention required→ मेंशन होने तक समूह संदेश अनदेखा।pairing request→ प्रेषक को अनुमोदन चाहिए।blocked/allowlist→ प्रेषक/चैनल नीति द्वारा फ़िल्टर किया गया।
डैशबोर्ड नियंत्रण UI कनेक्टिविटी
जब डैशबोर्ड/कंट्रोल UI कनेक्ट नहीं होता, तो URL, प्रमाणीकरण मोड और सुरक्षित संदर्भ की मान्यताओं की जाँच करें।- सही प्रोब URL और डैशबोर्ड URL।
- क्लाइंट और Gateway के बीच प्रमाणीकरण मोड/टोकन का असंगत होना।
- जहाँ डिवाइस पहचान आवश्यक है वहाँ HTTP का उपयोग।
device identity required→ असुरक्षित संदर्भ या डिवाइस प्रमाणीकरण अनुपस्थित।unauthorized/ पुनःकनेक्ट लूप → टोकन/पासवर्ड असंगति।gateway connect failed:→ गलत होस्ट/पोर्ट/URL लक्ष्य।
Gateway सेवा चल नहीं रही
जब सेवा इंस्टॉल है लेकिन प्रक्रिया चालू नहीं रहती, तब इसका उपयोग करें।- निकास संकेतों के साथ
Runtime: stopped। - सेवा विन्यास असंगति (
Config (cli)बनामConfig (service))। - पोर्ट/लिस्नर टकराव।
Gateway start blocked: set gateway.mode=local→ local gateway मोड सक्षम नहीं है। समाधान: अपने config मेंgateway.mode="local"सेट करें (याopenclaw configureचलाएँ)। यदि आप समर्पितopenclawउपयोगकर्ता के साथ Podman के माध्यम से OpenClaw चला रहे हैं, तो config~openclaw/.openclaw/openclaw.jsonपर स्थित होती है।refusing to bind gateway ... without auth→ non-loopback bind without token/password.another gateway instance is already listening/EADDRINUSE→ पोर्ट टकराव।
चैनल कनेक्टेड है लेकिन संदेश प्रवाह नहीं
यदि चैनल की स्थिति कनेक्टेड है लेकिन संदेश प्रवाह बंद है, तो नीति, अनुमतियाँ और चैनल-विशिष्ट डिलीवरी नियमों पर ध्यान दें।- DM नीति (
pairing,allowlist,open,disabled)। - समूह allowlist और मेंशन आवश्यकताएँ।
- चैनल API अनुमतियाँ/स्कोप्स का अभाव।
mention required→ समूह मेंशन नीति द्वारा संदेश अनदेखा।pairing/ लंबित अनुमोदन ट्रेस → प्रेषक अनुमोदित नहीं है।missing_scope,not_in_channel,Forbidden,401/403→ चैनल प्रमाणीकरण/अनुमति समस्या।
क्रॉन और हार्टबीट डिलीवरी
यदि क्रॉन या हार्टबीट नहीं चला या डिलीवर नहीं हुआ, तो पहले शेड्यूलर की स्थिति जाँचें, फिर डिलीवरी लक्ष्य।- क्रॉन सक्षम है और अगला वेक मौजूद है।
- जॉब रन इतिहास की स्थिति (
ok,skipped,error)। - हार्टबीट स्किप कारण (
quiet-hours,requests-in-flight,alerts-disabled)।
cron: scheduler disabled; jobs will not run automatically→ क्रॉन अक्षम।cron: timer tick failed→ शेड्यूलर टिक विफल; फ़ाइल/लॉग/रनटाइम त्रुटियाँ जाँचें।heartbeat skippedके साथreason=quiet-hours→ सक्रिय घंटों की विंडो से बाहर।heartbeat: unknown accountId→ हार्टबीट डिलीवरी लक्ष्य के लिए अमान्य अकाउंट आईडी।
नोड पेयर्ड है लेकिन टूल विफल
यदि कोई नोड पेयर्ड है लेकिन टूल्स विफल हैं, तो फ़ोरग्राउंड, अनुमतियाँ और अनुमोदन स्थिति को अलग करें।- अपेक्षित क्षमताओं के साथ नोड ऑनलाइन।
- कैमरा/माइक/लोकेशन/स्क्रीन के लिए OS अनुमति अनुदान।
- Exec अनुमोदन और allowlist स्थिति।
NODE_BACKGROUND_UNAVAILABLE→ नोड ऐप फ़ोरग्राउंड में होना चाहिए।*_PERMISSION_REQUIRED/LOCATION_PERMISSION_REQUIRED→ OS अनुमति अनुपस्थित।SYSTEM_RUN_DENIED: approval required→ exec अनुमोदन लंबित।SYSTEM_RUN_DENIED: allowlist miss→ allowlist द्वारा कमांड अवरुद्ध।
ब्राउज़र टूल विफल
जब Gateway स्वयं स्वस्थ हो लेकिन ब्राउज़र टूल क्रियाएँ विफल हों, तब इसका उपयोग करें।- वैध ब्राउज़र executable पथ।
- CDP प्रोफ़ाइल की पहुँचयोग्यता।
profile="chrome"के लिए एक्सटेंशन रिले टैब अटैचमेंट।
Failed to start Chrome CDP on port→ ब्राउज़र प्रक्रिया लॉन्च होने में विफल।browser.executablePath not found→ विन्यस्त पथ अमान्य है।Chrome extension relay is running, but no tab is connected→ एक्सटेंशन रिले संलग्न नहीं।Browser attachOnly is enabled ... not reachable→ attach-only profile has no reachable target.
यदि आपने अपग्रेड किया और अचानक कुछ टूट गया
अधिकांश पोस्ट-अपग्रेड समस्याएँ विन्यास ड्रिफ्ट या अब लागू किए जा रहे अधिक सख्त डिफ़ॉल्ट्स के कारण होती हैं।1. प्रमाणीकरण और URL ओवरराइड व्यवहार बदला
- यदि
gateway.mode=remote, तो CLI कॉल्स रिमोट को लक्षित कर सकती हैं जबकि आपकी स्थानीय सेवा ठीक है। - स्पष्ट
--urlकॉल्स संग्रहीत क्रेडेंशियल्स पर फ़ॉलबैक नहीं करतीं।
gateway connect failed:→ गलत URL लक्ष्य।unauthorized→ एंडपॉइंट पहुँचयोग्य है लेकिन प्रमाणीकरण गलत है।
2. बाइंड और प्रमाणीकरण गार्डरेल्स अधिक सख्त हैं
- non-loopback बाइंड्स (
lan,tailnet,custom) के लिए प्रमाणीकरण विन्यस्त होना चाहिए। - पुराने कुंजियाँ जैसे
gateway.token,gateway.auth.tokenको प्रतिस्थापित नहीं करतीं।
refusing to bind gateway ... without auth→ bind+auth mismatch.- रनटाइम चलते समय
RPC probe: failed→ Gateway जीवित है लेकिन वर्तमान प्रमाणीकरण/URL के साथ पहुँच से बाहर है।
3. पेयरिंग और डिवाइस पहचान स्थिति बदली
- डैशबोर्ड/नोड्स के लिए लंबित डिवाइस अनुमोदन।
- नीति या पहचान परिवर्तनों के बाद लंबित DM पेयरिंग अनुमोदन।
device identity required→ डिवाइस प्रमाणीकरण संतुष्ट नहीं।pairing required→ प्रेषक/डिवाइस को अनुमोदित करना आवश्यक है।