नोड समस्या‑निवारण¶

जब किसी नोड की स्थिति में वह दिखाई दे रहा हो लेकिन नोड टूल विफल हो रहे हों, तब इस पृष्ठ का उपयोग करें।

कमांड सीढ़ी¶

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

फिर नोड‑विशिष्ट जाँचें चलाएँ:

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>

स्वस्थ संकेत:

• नोड कनेक्टेड है और भूमिका node के लिए पेयर्ड है।
• nodes describe में वह क्षमता शामिल है जिसे आप कॉल कर रहे हैं।
• Exec अनुमोदन अपेक्षित मोड/allowlist दिखाते हैं।

फ़ोरग्राउंड आवश्यकताएँ¶

iOS/Android नोड्स पर canvas.*, camera.*, और screen.* केवल फ़ोरग्राउंड में काम करते हैं।

त्वरित जाँच और समाधान:

openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow

यदि आपको NODE_BACKGROUND_UNAVAILABLE दिखाई दे, तो नोड ऐप को फ़ोरग्राउंड में लाएँ और पुनः प्रयास करें।

अनुमतियाँ मैट्रिक्स¶

पेयरिंग बनाम अनुमोदन¶

ये अलग‑अलग गेट हैं:

1. डिवाइस पेयरिंग: क्या यह नोड Gateway से कनेक्ट हो सकता है?
2. Exec अनुमोदन: क्या यह नोड किसी विशिष्ट शेल कमांड को चला सकता है?

त्वरित जाँचें:

openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"

यदि pairing ठीक है लेकिन system.run विफल होता है, तो exec approvals/allowlist ठीक करें। Triggers को normalize किया जाता है (trim किए जाते हैं, खाली entries हटाई जाती हैं)।

सामान्य नोड त्रुटि कोड¶

• NODE_BACKGROUND_UNAVAILABLE → ऐप बैकग्राउंड में है; इसे फ़ोरग्राउंड में लाएँ।
• CAMERA_DISABLED → नोड सेटिंग्स में कैमरा टॉगल अक्षम है।
• *_PERMISSION_REQUIRED → OS अनुमति अनुपलब्ध/अस्वीकृत।
• LOCATION_DISABLED → लोकेशन मोड बंद है।
• LOCATION_PERMISSION_REQUIRED → अनुरोधित लोकेशन मोड प्रदान नहीं किया गया।
• LOCATION_BACKGROUND_UNAVAILABLE → ऐप बैकग्राउंड में है लेकिन केवल “उपयोग के दौरान” अनुमति मौजूद है।
• SYSTEM_RUN_DENIED: approval required → exec अनुरोध के लिए स्पष्ट अनुमोदन आवश्यक है।
• SYSTEM_RUN_DENIED: allowlist miss → कमांड allowlist मोड द्वारा अवरुद्ध है।

त्वरित पुनर्प्राप्ति लूप¶

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow

यदि फिर भी अटके हों:

• डिवाइस पेयरिंग को पुनः‑अनुमोदित करें।
• नोड ऐप को पुनः खोलें (फ़ोरग्राउंड)।
• OS अनुमतियाँ पुनः प्रदान करें।
• exec अनुमोदन नीति को पुनः बनाएँ/समायोजित करें।

संबंधित:

• /nodes/index
• /nodes/camera
• /nodes/location-command
• /tools/exec-approvals
• /gateway/pairing