अध्याय 11 समस्या निवारण और अनुकूलन

OpenClaw का उपयोग करते समय विभिन्न समस्याओं का सामना करना अपरिहार्य है। यह अध्याय सामान्य समस्याओं के समाधान, प्रदर्शन ट्यूनिंग युक्तियाँ और सामुदायिक संसाधनों का सारांश देता है।

पढ़ने के सुझाव: खंड 1 "अक्सर पूछे जाने वाले प्रश्न त्वरित जांच" को सभी के लिए पढ़ने की अनुशंसा की जाती है ताकि आप समस्याओं का सामना करते समय तुरंत उनका पता लगा सकें। जब आप विशिष्ट समस्याओं का सामना करते हैं तो आप निम्नलिखित लॉग डायग्नोसिस, प्रदर्शन अनुकूलन और अन्य सामग्री पढ़ सकते हैं।

1. त्वरित अक्सर पूछे जाने वाले प्रश्न

1.1 स्थापना समस्याएँ

समस्या	कारण	समाधान
`npm install -g openclaw` विफलता	Node.js संस्करण बहुत कम है	Node.js 22+ में अपग्रेड करें
अनुमति त्रुटि	एनपीएम वैश्विक स्थापना के लिए अपर्याप्त अनुमतियाँ	`sudo` का उपयोग करें या npm उपसर्ग कॉन्फ़िगर करें
नेटवर्क टाइमआउट	एनपीएम स्रोत पहुंच योग्य नहीं है	Taobao स्रोत पर स्विच करें: `npm config set registry https://registry.npmmirror.com`

1.2 एपीआई कनेक्शन समस्या

समस्या	कारण	समाधान
`401 Unauthorized`	एपीआई कुंजी अमान्य है या समाप्त हो गई है	एपीआई कुंजी जांचें और अपडेट करें
`429 Too Many Requests`	एपीआई कॉल सीमा पूरी हो गई	समवर्ती कार्यों को कम करें, या एपीआई पैकेज को अपग्रेड करें
कनेक्शन टाइमआउट	नेटवर्क समस्याएँ (विशेषकर विदेशी एपीआई तक पहुँचते समय)	नेटवर्क प्रॉक्सी कॉन्फ़िगर करें (HTTP_PROXY पर्यावरण चर) या घरेलू प्रदाता पर स्विच करें (जैसे कि सिलिकॉन मोबाइल, अध्याय 1 देखें)
`503 Service Unavailable`	एपीआई सेवा अस्थायी रूप से अनुपलब्ध है	पुनर्प्राप्ति की प्रतीक्षा करना, या बैकअप मॉडल पर स्विच करना
सहायक को "भूलने की बीमारी" है (पहले दी गई जानकारी भूल जाता है)	लंबी बातचीत संदर्भ विंडो से अधिक हो जाती है, और मूल मेमोरी संपीड़न विवरण खो देता है	USER.md या MEMORY.md पर मुख्य जानकारी लिखें (विवरण के लिए 第九章 देखें); लंबी दूरी के परिदृश्य OpenViking मेमोरी प्लग-इन

1.3 चैनल पहुंच संबंधी समस्याएं

समस्या	कारण	समाधान
टेलीग्राम जवाब नहीं दे रहा है	बॉट टोकन त्रुटि या नेटवर्क समस्या	टोकन की जाँच करें और प्रॉक्सी कॉन्फ़िगरेशन की पुष्टि करें
Feishu संदेश प्रतिक्रिया नहीं देता	अनुमति सक्रिय नहीं है या युग्मन पूर्ण नहीं है	Feishu ओपन प्लेटफ़ॉर्म अनुमति सेटिंग्स की जाँच करें
QQ डिस्कनेक्ट हो गया	नेपकैट वेबसॉकेट डिस्कनेक्ट हो गया	NapCat की रनिंग स्थिति जांचें और दोबारा लॉग इन करें

1.4 कौशल मुद्दे

समस्या	कारण	समाधान
`clawhub install` विफलता	नेटवर्क समस्या या गलत कौशल नाम	नेटवर्क की जाँच करें और पुष्टि करें कि कौशल का नाम (स्लग) सही है
इंस्टालेशन के बाद कौशल उपलब्ध नहीं	गुम सिस्टम निर्भरताएँ	SKILL.md
एपीआई कुंजी कॉन्फ़िगरेशन के बाद भी त्रुटि रिपोर्ट की गई	openclaw.json प्रारूप त्रुटि	इंटरैक्टिव कॉन्फ़िगरेशन के लिए `openclaw config` का उपयोग करें

विस्तार: लॉग डायग्नोसिस

2. लॉग डायग्नोसिस

2.1 लॉग देखें

bash

# 查看实时日志（持续输出）
openclaw logs --follow

# 查看最近 100 条日志
openclaw logs --limit 100

# 以 JSON 格式输出（方便用 jq 等数据处理工具过滤，新手可忽略此选项）
openclaw logs --limit 100 --json

# 纯文本输出（无颜色）
openclaw logs --limit 50 --plain

2.2 लॉग स्तर

jsonc

// openclaw.json 中的 logging 配置
{
  "logging": {
    "level": "info",
    "file": true,
    "maxSize": "50mb",
    "maxFiles": 10
  }
}

आप विकास और डिबगिंग के दौरान डिबग स्तर को अस्थायी रूप से चालू कर सकते हैं:

bash

openclaw config set logging.level debug
openclaw gateway restart

विस्तार: प्रदर्शन अनुकूलन

3. प्रदर्शन अनुकूलन

3.1 प्रतिक्रिया गति

सक्रिय कौशल में कमी: प्रति कौशल लगभग 200-500 टोकन द्वारा संदर्भ जोड़ा गया। 10 कौशल 3000-5000 टोकन जोड़ सकते हैं।

bash

# 查看当前活跃技能数量
clawhub list --active

# 禁用不常用的技能
clawhub uninstall rarely-used-skill

तेज़ मॉडल का उपयोग करें: साधारण कार्यों के लिए हाइकु ओपस की तुलना में 5-10 गुना तेज़ है।

कैशिंग सक्षम करें:

json

{
  "cache": {
    "enabled": true,
    "ttl": 3600,
    "maxSize": "100mb"
  }
}

3.2 मेमोरी अनुकूलन

bash

# 查看 OpenClaw 内存使用
openclaw status --verbose

# 清理对话历史缓存
openclaw cleanup --conversations --older-than 7d

# 清理技能缓存
openclaw cleanup --skill-cache

3.3 टोकन अनुकूलन

bash

# 查看每次调用的 Token 消耗
openclaw usage --detail

# 按技能统计
openclaw usage --by-skill --period month

विस्तार: डेटा बैकअप और पुनर्प्राप्ति

4. डेटा बैकअप और रिकवरी

4.1 किस चीज़ का बैकअप लेने की आवश्यकता है

~/.openclaw/
├── openclaw.json        # 配置文件（API Key、渠道设置）
├── workspace/           # 工作区（详见第九章第 7 节）
│   ├── IDENTITY.md      # 助理身份（名字、风格）
│   ├── SOUL.md          # 人格设定和行为准则
│   ├── USER.md          # 你的个人信息和偏好
│   ├── AGENTS.md        # 工作流程和操作规范
│   ├── TOOLS.md         # 环境专属信息（服务器、设备等）
│   ├── MEMORY.md        # 长期记忆
│   ├── HEARTBEAT.md     # 定期巡检清单
│   ├── BOOT.md          # 网关启动时执行的任务
│   ├── BOOTSTRAP.md     # 首次运行初始化（完成后自动删除）
│   └── memory/          # 每日工作日志
├── skills/              # 已安装技能及配置
├── cron/                # 定时任务
└── conversations/       # 对话历史

4.2 बैकअप कमांड

bash

# 完整备份
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

# 只备份配置和工作区（不含对话历史）
tar -czf openclaw-config-$(date +%Y%m%d).tar.gz \
  ~/.openclaw/openclaw.json \
  ~/.openclaw/workspace/ \
  ~/.openclaw/skills/ \
  ~/.openclaw/cron/

4.3 पुनर्प्राप्ति

bash

# 恢复备份
tar -xzf openclaw-backup-20260307.tar.gz -C ~/

# 重启服务
openclaw gateway restart

विस्तार: अपग्रेड गाइड

5. अपग्रेड गाइड

5.1 ओपनक्लॉ को अपग्रेड करें

bash

# 查看当前版本
openclaw --version

# 升级到最新版
npm update -g openclaw

# Docker 用户
docker pull ghcr.io/openclaw/openclaw:latest
docker compose up -d

5.2 अपग्रेड नोट्स

अपग्रेड करने से पहले ~/.openclaw/ डायरेक्टरी का बैकअप लें
महत्वपूर्ण परिवर्तनों के लिए रिलीज़ नोट्स देखें
प्रमुख संस्करण अपग्रेड के बाद कुछ कौशलों को पुन: कॉन्फ़िगर करने की आवश्यकता हो सकती है

6. सामुदायिक संसाधन

6.1 आधिकारिक संसाधन

संसाधन	पता
आधिकारिक दस्तावेज़ीकरण	https://openclaw.ai/docs
GitHub रिपोजिटरी	https://github.com/openclaw/openclaw
क्लॉहब कौशल बाजार	https://github.com/openclaw/clawhub
कलह समुदाय	https://discord.gg/openclaw

6.2 चीनी समुदाय

संसाधन	पता
इस ट्यूटोरियल का ऑनलाइन संस्करण	https://datawhalechina.github.io/hello-claw
डाटाव्हेल समुदाय	https://github.com/datawhalechina

6.3 सहायता प्राप्त करें

समस्याएँ आने पर समस्या निवारण चरण:

पहले इस अध्याय के "त्वरित FAQ" की जाँच करें।
GitHub मुद्दे खोजें
डिसॉर्डर समुदाय में प्रश्न पूछें
GitHub अंक सबमिट करें (लॉग और पुनरुत्पादन चरण संलग्न करें)

"अडॉप्ट ए क्लॉ" को पूरा करने पर बधाई! अब आपने OpenClaw की स्थापना और कॉन्फ़िगरेशन, मोबाइल एक्सेस, स्वचालित कार्य, कौशल प्रणाली, बाहरी सेवा एकीकरण, उत्पादन परिनियोजन, मल्टी-मॉडल अनुकूलन और व्यावहारिक अनुप्रयोग परिदृश्यों में महारत हासिल कर ली है।

यदि आप OpenClaw के आंतरिक पहलुओं के बारे में अधिक जानना चाहते हैं, या स्क्रैच से अपना स्वयं का AI एजेंट बनाना चाहते हैं, तो भाग दो, "बिल्डिंग क्लॉ" पढ़ना जारी रखें।

अगला चरण: 第二部分：构建 Claw

अध्याय 11 समस्या निवारण और अनुकूलन ​

1. त्वरित अक्सर पूछे जाने वाले प्रश्न ​

1.1 स्थापना समस्याएँ ​

1.2 एपीआई कनेक्शन समस्या ​

1.3 चैनल पहुंच संबंधी समस्याएं ​

1.4 कौशल मुद्दे ​

2. लॉग डायग्नोसिस ​

2.1 लॉग देखें ​

2.2 लॉग स्तर ​

3. प्रदर्शन अनुकूलन ​

3.1 प्रतिक्रिया गति ​

3.2 मेमोरी अनुकूलन ​

3.3 टोकन अनुकूलन ​

4. डेटा बैकअप और रिकवरी ​

4.1 किस चीज़ का बैकअप लेने की आवश्यकता है ​

4.2 बैकअप कमांड ​

4.3 पुनर्प्राप्ति ​

5. अपग्रेड गाइड ​

5.1 ओपनक्लॉ को अपग्रेड करें ​

5.2 अपग्रेड नोट्स ​

6. सामुदायिक संसाधन ​

6.1 आधिकारिक संसाधन ​

6.2 चीनी समुदाय ​

6.3 सहायता प्राप्त करें ​

अध्याय 11 समस्या निवारण और अनुकूलन

1. त्वरित अक्सर पूछे जाने वाले प्रश्न

1.1 स्थापना समस्याएँ

1.2 एपीआई कनेक्शन समस्या

1.3 चैनल पहुंच संबंधी समस्याएं

1.4 कौशल मुद्दे

2. लॉग डायग्नोसिस

2.1 लॉग देखें

2.2 लॉग स्तर

3. प्रदर्शन अनुकूलन

3.1 प्रतिक्रिया गति

3.2 मेमोरी अनुकूलन

3.3 टोकन अनुकूलन

4. डेटा बैकअप और रिकवरी

4.1 किस चीज़ का बैकअप लेने की आवश्यकता है

4.2 बैकअप कमांड

4.3 पुनर्प्राप्ति

5. अपग्रेड गाइड

5.1 ओपनक्लॉ को अपग्रेड करें

5.2 अपग्रेड नोट्स

6. सामुदायिक संसाधन

6.1 आधिकारिक संसाधन

6.2 चीनी समुदाय

6.3 सहायता प्राप्त करें