> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Устранение неполадок Node

Используйте эту страницу, когда узел отображается в статусе, но инструменты узла не работают.

## Лестница команд

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
```

Затем выполните проверки, специфичные для узла:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
```

Признаки исправного состояния:

* Узел подключен и сопряжен для роли `node`.
* `nodes describe` включает вызываемую вами возможность.
* Утверждения выполнения показывают ожидаемый режим/список разрешений.

## Требования переднего плана

`canvas.*`, `camera.*` и `screen.*` работают только на переднем плане на узлах iOS/Android.

Быстрая проверка и исправление:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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. **Утверждения выполнения**: может ли этот узел локально выполнить конкретную команду оболочки?

Быстрые проверки:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 формы с оболочкой-оберткой, такие как `cmd.exe /c ...`, считаются промахами списка разрешений в
  режиме списка разрешений, если они не утверждены через поток запроса.

## Быстрый цикл восстановления

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
```

Если проблема сохраняется:

* Повторно утвердите сопряжение устройства.
* Повторно откройте приложение узла (на переднем плане).
* Повторно предоставьте разрешения ОС.
* Пересоздайте/скорректируйте политику утверждений выполнения.

## См. также

* [Обзор узлов](/ru/nodes)
* [Узлы камеры](/ru/nodes/camera)
* [Команда геолокации](/ru/nodes/location-command)
* [Утверждения выполнения](/ru/tools/exec-approvals)
* [Сопряжение Gateway](/ru/gateway/pairing)
* [Устранение неполадок Gateway](/ru/gateway/troubleshooting)
* [Устранение неполадок каналов](/ru/channels/troubleshooting)