---
read_when:
    - Node متصل لكن أدوات camera/canvas/screen/exec تفشل
    - تحتاج إلى النموذج الذهني لإقران Node مقابل الموافقات
summary: استكشاف أخطاء إقران Node ومتطلبات التشغيل في المقدمة والأذونات وإخفاقات الأدوات وإصلاحها
title: استكشاف أخطاء Node وإصلاحها
x-i18n:
    generated_at: "2026-05-10T19:46:51Z"
    model: gpt-5.5
    provider: openai
    source_hash: d53f06367b63125f04b4b542c322e6e50e1f33153e0fbdd09e7a38772c69a438
    source_path: nodes/troubleshooting.md
    workflow: 16
---

استخدم هذه الصفحة عندما تكون العقدة ظاهرة في الحالة لكن أدوات العقدة تفشل.

## تسلسل الأوامر

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

ثم شغّل فحوصات خاصة بالعقدة:

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

إشارات السلامة:

- العقدة متصلة ومقترنة للدور `node`.
- يتضمن `nodes describe` الإمكانية التي تستدعيها.
- تُظهر موافقات التنفيذ الوضع/قائمة السماح المتوقعة.

## متطلبات الواجهة الأمامية

`canvas.*` و`camera.*` و`screen.*` تعمل في الواجهة الأمامية فقط على عقد iOS/Android.

فحص وإصلاح سريعان:

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

إذا رأيت `NODE_BACKGROUND_UNAVAILABLE`، انقل تطبيق العقدة إلى الواجهة الأمامية وأعد المحاولة.

## مصفوفة الأذونات

| الإمكانية                   | iOS                                     | Android                                      | تطبيق العقدة على macOS                | رمز الفشل المعتاد           |
| ---------------------------- | --------------------------------------- | -------------------------------------------- | ----------------------------- | ------------------------------ |
| `camera.snap`, `camera.clip` | الكاميرا (+ الميكروفون لصوت المقطع)           | الكاميرا (+ الميكروفون لصوت المقطع)                | الكاميرا (+ الميكروفون لصوت المقطع) | `*_PERMISSION_REQUIRED`        |
| `screen.record`              | تسجيل الشاشة (+ الميكروفون اختياري)       | مطالبة التقاط الشاشة (+ الميكروفون اختياري)       | تسجيل الشاشة              | `*_PERMISSION_REQUIRED`        |
| `location.get`               | أثناء الاستخدام أو دائمًا (يعتمد على الوضع) | موقع الواجهة الأمامية/الخلفية حسب الوضع | إذن الموقع           | `LOCATION_PERMISSION_REQUIRED` |
| `system.run`                 | غير منطبق (مسار مضيف العقدة)                    | غير منطبق (مسار مضيف العقدة)                         | موافقات التنفيذ مطلوبة       | `SYSTEM_RUN_DENIED`            |

## الاقتران مقابل الموافقات

هذه بوابات مختلفة:

1. **اقتران الجهاز**: هل يمكن لهذه العقدة الاتصال بـ Gateway؟
2. **سياسة أوامر عقدة Gateway**: هل معرّف أمر RPC مسموح به عبر `gateway.nodes.allowCommands` / `denyCommands` وافتراضيات المنصة؟
3. **موافقات التنفيذ**: هل يمكن لهذه العقدة تشغيل أمر shell محدد محليًا؟

فحوصات سريعة:

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

إذا كان الاقتران مفقودًا، فوافق على جهاز العقدة أولًا.
إذا كان `nodes describe` يفتقد أمرًا، فتحقق من سياسة أوامر عقدة Gateway وما إذا كانت العقدة قد أعلنت هذا الأمر فعليًا عند الاتصال.
إذا كان الاقتران سليمًا لكن `system.run` يفشل، فأصلح موافقات التنفيذ/قائمة السماح على تلك العقدة.

اقتران العقدة هو بوابة هوية/ثقة، وليس سطح موافقة لكل أمر. بالنسبة إلى `system.run`، تعيش سياسة كل عقدة في ملف موافقات التنفيذ الخاص بتلك العقدة (`openclaw approvals get --node ...`)، وليس في سجل اقتران Gateway.

بالنسبة إلى عمليات تشغيل `host=node` المدعومة بالموافقة، يربط Gateway أيضًا التنفيذ
بـ `systemRunPlan` القانوني المُحضّر. إذا عدّل مستدعٍ لاحق الأمر/cwd أو
بيانات الجلسة الوصفية قبل تمرير التشغيل الموافق عليه، يرفض Gateway
التشغيل باعتباره عدم تطابق في الموافقة بدلًا من الوثوق بالحمولة المعدّلة.

## رموز أخطاء العقد الشائعة

- `NODE_BACKGROUND_UNAVAILABLE` → التطبيق في الخلفية؛ انقله إلى الواجهة الأمامية.
- `CAMERA_DISABLED` → مفتاح تبديل الكاميرا معطّل في إعدادات العقدة.
- `*_PERMISSION_REQUIRED` → إذن نظام التشغيل مفقود/مرفوض.
- `LOCATION_DISABLED` → وضع الموقع متوقف.
- `LOCATION_PERMISSION_REQUIRED` → وضع الموقع المطلوب غير ممنوح.
- `LOCATION_BACKGROUND_UNAVAILABLE` → التطبيق في الخلفية لكن لا يوجد إلا إذن أثناء الاستخدام.
- `SYSTEM_RUN_DENIED: approval required` → طلب التنفيذ يحتاج إلى موافقة صريحة.
- `SYSTEM_RUN_DENIED: allowlist miss` → الأمر محظور بسبب وضع قائمة السماح.
  على مضيفات عقد Windows، تُعامل صيغ مغلّف shell مثل `cmd.exe /c ...` كحالات عدم مطابقة لقائمة السماح في
  وضع قائمة السماح ما لم تُعتمد عبر تدفق الطلب.

## حلقة الاسترداد السريعة

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

إذا بقيت عالقًا:

- أعد الموافقة على اقتران الجهاز.
- أعد فتح تطبيق العقدة (في الواجهة الأمامية).
- أعد منح أذونات نظام التشغيل.
- أعد إنشاء/اضبط سياسة موافقة التنفيذ.

## ذات صلة

- [نظرة عامة على العقد](/ar/nodes)
- [عقد الكاميرا](/ar/nodes/camera)
- [أمر الموقع](/ar/nodes/location-command)
- [موافقات التنفيذ](/ar/tools/exec-approvals)
- [اقتران Gateway](/ar/gateway/pairing)
- [استكشاف أخطاء Gateway وإصلاحها](/ar/gateway/troubleshooting)
- [استكشاف أخطاء القنوات وإصلاحها](/ar/channels/troubleshooting)