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

🔍 डायग्नोस्टिक स्टेप्स (इसी क्रम में करें)

OpenClaw में कोई समस्या आए तो इस क्रम में जाँच करें:

openclaw status

openclaw gateway status

openclaw logs

openclaw doctor

openclaw channels status

🐛 आम एरर और हल

एरर: "openclaw: command not found"

कारण: सिस्टम openclaw कमांड ढूँढ नहीं पा रहा, PATH की समस्या है।

हल:

# openclaw कहाँ इंस्टॉल है चेक करें
npm list -g openclaw

# npm ग्लोबल डायरेक्टरी PATH में जोड़ें
export PATH="$(npm config get prefix)/bin:$PATH"

# परमानेंट करने के लिए shell कॉन्फ़िग में डालें
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

एरर: पोर्ट कॉन्फ़्लिक्ट (EADDRINUSE: address already in use :::18789)

कारण: पोर्ट 18789 पहले से किसी प्रोग्राम ने ले रखा है।

हल:

# कौन सा प्रोसेस पोर्ट यूज़ कर रहा है
lsof -i :18789

# पुराना OpenClaw प्रोसेस बंद करें
openclaw stop

# अगर दूसरा प्रोग्राम है, कॉन्फ़िग में पोर्ट बदलें
# ~/.openclaw/openclaw.json एडिट करें

एरर: 429 Too Many Requests (रेट लिमिट)

कारण: बहुत ज़्यादा तेज़ी से रिक्वेस्ट भेजी गईं।

हल:

• कुछ मिनट रुकें फिर ट्राई करें
• मैसेज भेजने की स्पीड कम करें
• API प्लान अपग्रेड करें
• कम रेट लिमिट वाले मॉडल प्रोवाइडर आज़माएँ

एरर: गेटवे शुरू नहीं हो रहा

कारण: Bot Token ग़लत, नेटवर्क प्रॉब्लम, या चैट प्लेटफ़ॉर्म API बदल गई।

हल:

# गेटवे लॉग्स चेक करें
openclaw gateway logs

# Bot Token वैलिड है या नहीं
openclaw channels verify

# गेटवे रीस्टार्ट करें
openclaw gateway restart

एरर: मैसेज नहीं भेज पा रहे

कारण: चैनल कॉन्फ़िग ग़लत, नेटवर्क, या Bot परमिशन कम।

हल:

• चैनल स्टेटस चेक करें: openclaw channels status
• Bot को प्लेटफ़ॉर्म पर मैसेज भेजने की परमिशन दी है या नहीं
• इंटरनेट कनेक्शन ठीक है या नहीं
• लॉग्स में स्पेसिफ़िक एरर देखें

एरर: कंट्रोल पैनल नहीं खुल रहा

कारण: OpenClaw सर्विस शायद चल नहीं रही, या पोर्ट ग़लत है।

हल:

# OpenClaw चल रहा है या नहीं
openclaw status

# नहीं चल रहा तो शुरू करें
openclaw start

# फिर कंट्रोल पैनल खोलें
openclaw dashboard

# या सीधे ब्राउज़र में
# http://127.0.0.1:18789/

🆘 फिर भी हल नहीं हुआ?

ऊपर के तरीक़ों से भी समस्या हल नहीं हुई तो:

• GitHub Issues पर सर्च करें या नया इश्यू बनाएँ
• OpenClaw के Discord कम्युनिटी में मदद लें
• पूछते समय openclaw doctor और openclaw logs का आउटपुट ज़रूर दें