Skip to main content
बिना अनुमान लगाए चैनल कनेक्टिविटी सत्यापित करने के लिए संक्षिप्त मार्गदर्शिका।

​
त्वरित जाँच

  • openclaw status - स्थानीय सारांश: Gateway की पहुँच/मोड, अपडेट संकेत, लिंक किए गए चैनल प्रमाणीकरण की आयु, सत्र + हाल की गतिविधि।
  • openclaw status --all - पूर्ण स्थानीय निदान (केवल-पढ़ने योग्य, रंगीन, डीबगिंग के लिए सुरक्षित रूप से पेस्ट किया जा सकता है)।
  • openclaw status --deep - लाइव जाँच के लिए चल रहे Gateway से अनुरोध करता है (probe:true के साथ health), जिसमें समर्थित होने पर प्रत्येक खाते के चैनल की जाँच शामिल है।
  • openclaw status --usage - मॉडल प्रदाता के उपयोग/कोटा स्नैपशॉट दिखाता है।
  • openclaw health - चल रहे Gateway से उसका स्वास्थ्य स्नैपशॉट माँगता है (केवल WS; CLI से सीधे चैनल सॉकेट नहीं)।
  • openclaw health --verbose (उपनाम --debug) - लाइव स्वास्थ्य जाँच बाध्य करता है और Gateway कनेक्शन का विवरण प्रिंट करता है।
  • openclaw health --json - मशीन-पठनीय स्वास्थ्य स्नैपशॉट आउटपुट।
  • एजेंट को सक्रिय किए बिना स्थिति उत्तर पाने के लिए किसी भी चैनल में /status को स्वतंत्र चैट कमांड के रूप में भेजें।
  • लॉग: openclaw logs --follow (या openclaw --profile <profile> logs --follow) चलाएँ और web-heartbeat, web-reconnect, web-auto-reply, web-inbound के अनुसार फ़िल्टर करें।
Discord और अन्य चैट प्रदाताओं के लिए, सत्र पंक्तियाँ सॉकेट के सक्रिय होने का संकेत नहीं हैं। openclaw sessions, Gateway sessions.list, और एजेंट का sessions_list टूल संग्रहीत वार्तालाप स्थिति पढ़ते हैं। कोई प्रदाता फिर से कनेक्ट हो सकता है और किसी नई सत्र पंक्ति के बनने से पहले चैनल की स्थिति स्वस्थ दिखा सकता है। लाइव कनेक्टिविटी जाँच के लिए ऊपर दिए गए चैनल स्थिति और स्वास्थ्य कमांड का उपयोग करें।

​
विस्तृत निदान

  • डिस्क पर क्रेडेंशियल: ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json (mtime हाल का होना चाहिए)।
  • सत्र संग्रह: ls -l ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite। संख्या और हाल के प्राप्तकर्ता status के माध्यम से दिखाए जाते हैं।
  • फिर से लिंक करने का प्रवाह: जब लॉग में स्थिति कोड 409-515 या loggedOut दिखाई दें, तो openclaw channels logout && openclaw channels login --verbose। पेयरिंग के बाद स्थिति 515 आने पर QR लॉगिन प्रवाह एक बार स्वतः पुनः आरंभ होता है।
  • निदान डिफ़ॉल्ट रूप से सक्षम हैं (diagnostics.enabled: false उन्हें अक्षम करता है)। मेमोरी इवेंट RSS/हीप बाइट संख्या और सीमा/वृद्धि दबाव दर्ज करते हैं। जब प्रक्रिया चल रही हो लेकिन अत्यधिक भार में हो, तब सक्रियता चेतावनियाँ इवेंट-लूप विलंब/उपयोग, CPU-कोर अनुपात और सक्रिय/प्रतीक्षारत/कतारबद्ध सत्रों की संख्या दर्ज करती हैं। अत्यधिक बड़े पेलोड इवेंट आकार और सीमाओं के साथ यह दर्ज करते हैं कि क्या अस्वीकार/संक्षिप्त/खंडित किया गया, लेकिन संदेश का टेक्स्ट, अटैचमेंट की सामग्री, Webhook बॉडी, कच्ची अनुरोध/प्रतिक्रिया बॉडी, टोकन, कुकी या गुप्त मान कभी दर्ज नहीं करते।
  • वही Heartbeat सीमित स्थिरता रिकॉर्डर को संचालित करता है: openclaw gateway stability (या diagnostics.stability Gateway RPC)। घातक Gateway निकास, शटडाउन टाइमआउट और पुनः आरंभ की स्टार्टअप विफलताएँ नवीनतम स्नैपशॉट को ~/.openclaw/logs/stability/ के अंतर्गत सहेजती हैं। नवीनतम बंडल का निरीक्षण openclaw gateway stability --bundle latest से करें।
  • बग रिपोर्ट के लिए, openclaw gateway diagnostics export चलाएँ और जनरेट की गई zip संलग्न करें: एक Markdown सारांश, नवीनतम स्थिरता बंडल, स्वच्छ किए गए लॉग मेटाडेटा, स्वच्छ किए गए Gateway स्थिति/स्वास्थ्य स्नैपशॉट और कॉन्फ़िगरेशन संरचना। चैट टेक्स्ट, Webhook बॉडी, टूल आउटपुट, क्रेडेंशियल, कुकी, खाता/संदेश पहचानकर्ता और गुप्त मान हटा दिए जाते हैं या संशोधित किए जाते हैं। निदान निर्यात देखें।

​
स्वास्थ्य मॉनिटर कॉन्फ़िगरेशन

  • channels.<provider>.healthMonitor.enabled: वैश्विक निगरानी सक्षम रखते हुए किसी विशिष्ट चैनल के लिए स्वास्थ्य-मॉनिटर पुनः आरंभ अक्षम करें।
  • channels.<provider>.accounts.<accountId>.healthMonitor.enabled: बहु-खाता ओवरराइड, जिसे चैनल-स्तरीय सेटिंग पर प्राथमिकता मिलती है।
  • ये प्रति-चैनल ओवरराइड उन अंतर्निहित चैनलों पर लागू होते हैं जो वर्तमान में इन्हें उपलब्ध कराते हैं: Discord, Google Chat, iMessage, IRC, Microsoft Teams, Signal, Slack, Telegram और WhatsApp।

​
अपटाइम निगरानी

बाहरी अपटाइम निगरानी सेवाओं को /v1/chat/completions के बजाय समर्पित /health एंडपॉइंट का उपयोग करना चाहिए।
  • इसका उपयोग करें: GET /health - तत्काल प्रतिक्रिया, कोई सत्र नहीं बनता, कोई LLM कॉल नहीं, {"ok":true,"status":"live"} लौटाता है
  • इसका उपयोग न करें: स्वास्थ्य जाँच के लिए /v1/chat/completions - प्रत्येक अनुरोध Skills स्नैपशॉट, संदर्भ संयोजन और LLM कॉल के साथ एक पूर्ण एजेंट सत्र बनाता है
जब कोई x-openclaw-session-key हेडर या user फ़ील्ड प्रदान नहीं किया जाता, तो /v1/chat/completions प्रत्येक अनुरोध के लिए एक नया यादृच्छिक सत्र जनरेट करता है। प्रत्येक 15 मिनट में पिंग करने वाली निगरानी सेवाएँ प्रतिदिन लगभग 96 सत्र बनाती हैं, जिनमें से प्रत्येक 4-22KB की खपत करता है। समय के साथ इससे सत्र संग्रह अनावश्यक रूप से बढ़ता है और संदर्भ विंडो ओवरफ़्लो हो सकती है।

​
निगरानी सेवा सेटअप के उदाहरण

  • BetterStack: स्वास्थ्य जाँच URL को https://<your-gateway-host>:<port>/health पर सेट करें
  • UptimeRobot: URL https://<your-gateway-host>:<port>/health के साथ एक नया HTTP मॉनिटर जोड़ें
  • सामान्य: Gateway के स्वस्थ होने पर /health पर किया गया कोई भी HTTP GET, {"ok":true} के साथ 200 लौटाता है

​
कुछ विफल होने पर

  • logged out या स्थिति 409-515 -> openclaw channels logout और फिर openclaw channels login से पुनः लिंक करें।
  • Gateway पहुँच योग्य नहीं है -> इसे आरंभ करें: openclaw gateway --port 18789 (यदि पोर्ट व्यस्त है, तो --force का उपयोग करें)।
  • इनबाउंड संदेश नहीं आ रहे हैं -> पुष्टि करें कि लिंक किया गया फ़ोन ऑनलाइन है और प्रेषक को अनुमति है (channels.whatsapp.allowFrom); समूह चैट के लिए सुनिश्चित करें कि अनुमति-सूची + उल्लेख नियम मेल खाते हैं (channels.whatsapp.groups, agents.entries.*.groupChat.mentionPatterns)।

​
समर्पित “health” कमांड

openclaw health चल रहे Gateway से उसका स्वास्थ्य स्नैपशॉट माँगता है (CLI से सीधे चैनल सॉकेट नहीं)। डिफ़ॉल्ट रूप से यह नया कैश किया गया Gateway स्नैपशॉट लौटाता है और Gateway पृष्ठभूमि में उस कैश को रीफ़्रेश करता है; इसके बजाय --verbose लाइव जाँच बाध्य करता है। कमांड उपलब्ध होने पर लिंक किए गए क्रेडेंशियल/प्रमाणीकरण की आयु, प्रति-चैनल जाँच सारांश, सत्र-संग्रह सारांश और जाँच अवधि की रिपोर्ट करता है। यदि Gateway पहुँच योग्य नहीं है या जाँच विफल होती है/समय समाप्त हो जाता है, तो यह गैर-शून्य स्थिति के साथ समाप्त होता है। विकल्प:
  • --json: मशीन-पठनीय JSON आउटपुट
  • --timeout <ms>: डिफ़ॉल्ट 10s जाँच टाइमआउट को ओवरराइड करें
  • --verbose: लाइव जाँच बाध्य करें और Gateway कनेक्शन का विवरण प्रिंट करें
  • --debug: --verbose का उपनाम
स्वास्थ्य स्नैपशॉट में शामिल हैं: ok (बूलियन), ts (टाइमस्टैम्प), durationMs (जाँच समय), प्रति-चैनल स्थिति, एजेंट उपलब्धता और सत्र-संग्रह सारांश।

​
संबंधित