---
read_when:
    - Node подключен, но инструменты камеры/canvas/экрана/exec не работают
    - Вам нужна ментальная модель сопряжения узла в сравнении с подтверждениями
summary: Устранение неполадок сопряжения узлов, требований к переднему плану, разрешений и сбоев инструментов
title: Устранение неполадок Node
x-i18n:
    generated_at: "2026-06-28T23:10:13Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    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. **Утверждения выполнения**: может ли этот узел локально выполнить конкретную команду оболочки?

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

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

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

```bash
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)