---
read_when:
    - Node कनेक्टेड है, लेकिन camera/canvas/screen/exec टूल विफल हो रहे हैं
    - आपको node pairing बनाम approvals मानसिक मॉडल की आवश्यकता है
summary: नोड युग्मन, अग्रभूमि आवश्यकताओं, अनुमतियों और उपकरण विफलताओं का समस्या निवारण करें
title: Node समस्या निवारण
x-i18n:
    generated_at: "2026-06-28T23:25:37Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: d53f06367b63125f04b4b542c322e6e50e1f33153e0fbdd09e7a38772c69a438
    source_path: nodes/troubleshooting.md
    workflow: 16
---

किसी node के status में दिखने पर लेकिन node tools के असफल होने पर इस पृष्ठ का उपयोग करें।

## कमांड क्रम

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

फिर node-विशिष्ट जांच चलाएँ:

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

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

- Node जुड़ा हुआ है और role `node` के लिए paired है।
- `nodes describe` में वह capability शामिल है जिसे आप कॉल कर रहे हैं।
- Exec approvals अपेक्षित mode/allowlist दिखाते हैं।

## foreground आवश्यकताएँ

`canvas.*`, `camera.*`, और `screen.*` iOS/Android nodes पर केवल foreground में उपलब्ध हैं।

त्वरित जांच और सुधार:

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

यदि आपको `NODE_BACKGROUND_UNAVAILABLE` दिखता है, तो node app को foreground में लाएँ और फिर से प्रयास करें।

## अनुमतियों की मैट्रिक्स

| Capability                   | iOS                                     | Android                                      | macOS node app                | सामान्य failure code           |
| ---------------------------- | --------------------------------------- | -------------------------------------------- | ----------------------------- | ------------------------------ |
| `camera.snap`, `camera.clip` | Camera (clip audio के लिए mic सहित)           | Camera (clip audio के लिए mic सहित)                | Camera (clip audio के लिए mic सहित) | `*_PERMISSION_REQUIRED`        |
| `screen.record`              | Screen Recording (mic वैकल्पिक)       | Screen capture prompt (mic वैकल्पिक)       | Screen Recording              | `*_PERMISSION_REQUIRED`        |
| `location.get`               | While Using या Always (mode पर निर्भर) | mode के आधार पर Foreground/Background location | Location permission           | `LOCATION_PERMISSION_REQUIRED` |
| `system.run`                 | n/a (node host path)                    | n/a (node host path)                         | Exec approvals आवश्यक       | `SYSTEM_RUN_DENIED`            |

## Pairing बनाम approvals

ये अलग-अलग gates हैं:

1. **Device pairing**: क्या यह node gateway से connect हो सकता है?
2. **Gateway node command policy**: क्या RPC command ID को `gateway.nodes.allowCommands` / `denyCommands` और platform defaults द्वारा अनुमति है?
3. **Exec approvals**: क्या यह node किसी विशिष्ट shell command को locally चला सकता है?

त्वरित जांच:

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

यदि pairing अनुपस्थित है, तो पहले node device को approve करें।
यदि `nodes describe` में कोई command अनुपस्थित है, तो gateway node command policy और यह जांचें कि node ने connect होते समय वास्तव में वह command घोषित किया था या नहीं।
यदि pairing ठीक है लेकिन `system.run` विफल होता है, तो उस node पर exec approvals/allowlist ठीक करें।

Node pairing एक identity/trust gate है, per-command approval surface नहीं। `system.run` के लिए, per-node policy उस node की exec approvals file (`openclaw approvals get --node ...`) में रहती है, gateway pairing record में नहीं।

approval-backed `host=node` runs के लिए, gateway execution को तैयार canonical `systemRunPlan` से भी bind करता है। यदि कोई बाद का caller approved run forward होने से पहले command/cwd या session metadata बदलता है, तो gateway edited payload पर भरोसा करने के बजाय run को approval mismatch के रूप में reject करता है।

## सामान्य node error codes

- `NODE_BACKGROUND_UNAVAILABLE` → app backgrounded है; इसे foreground में लाएँ।
- `CAMERA_DISABLED` → node settings में camera toggle disabled है।
- `*_PERMISSION_REQUIRED` → OS permission अनुपस्थित/denied है।
- `LOCATION_DISABLED` → location mode off है।
- `LOCATION_PERMISSION_REQUIRED` → requested location mode granted नहीं है।
- `LOCATION_BACKGROUND_UNAVAILABLE` → app backgrounded है लेकिन केवल While Using permission मौजूद है।
- `SYSTEM_RUN_DENIED: approval required` → exec request को explicit approval चाहिए।
- `SYSTEM_RUN_DENIED: allowlist miss` → command allowlist mode द्वारा blocked है।
  Windows node hosts पर, `cmd.exe /c ...` जैसे shell-wrapper forms को allowlist mode में allowlist misses माना जाता है, जब तक ask flow के माध्यम से approved न हों।

## तेज़ recovery loop

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

यदि अभी भी अटके हैं:

- Device pairing को फिर से approve करें।
- Node app को फिर से खोलें (foreground).
- OS permissions फिर से grant करें।
- Exec approval policy को recreate/adjust करें।

## संबंधित

- [Nodes overview](/hi/nodes)
- [Camera nodes](/hi/nodes/camera)
- [Location command](/hi/nodes/location-command)
- [Exec approvals](/hi/tools/exec-approvals)
- [Gateway pairing](/hi/gateway/pairing)
- [Gateway troubleshooting](/hi/gateway/troubleshooting)
- [Channel troubleshooting](/hi/channels/troubleshooting)