--- read_when: - Node подключён, но инструменты камеры, холста, экрана и выполнения команд не работают - Вам нужно понимать концептуальную модель сопряжения Node и подтверждений summary: Устранение неполадок с сопряжением узлов, требованиями к работе на переднем плане, разрешениями и сбоями инструментов title: Устранение неполадок Node x-i18n: generated_at: "2026-07-13T18:23:14Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 24 provider: openai source_hash: 53d082dcd2f4bb022eb683d72d193dbb6800b5a81a8f5ab9506d82feaa0dbc49 source_path: nodes/troubleshooting.md workflow: 16 --- Используйте эту страницу, если Node отображается в статусе, но инструменты Node не работают. ## Последовательность команд ```bash openclaw status openclaw gateway status openclaw logs --follow openclaw doctor openclaw channels status --probe ``` Затем выполните проверки для конкретного Node: ```bash openclaw nodes status openclaw nodes describe --node openclaw approvals get --node ``` Признаки нормальной работы: - Node подключен и сопряжён для роли `node`. - `nodes describe` содержит вызываемую вами возможность. - Разрешения на выполнение показывают ожидаемый режим и список разрешённых команд. ## Требования к работе на переднем плане `canvas.*`, `camera.*` и `screen.*` работают только на переднем плане на Node с iOS/Android. Быстрая проверка и исправление: ```bash openclaw nodes describe --node openclaw nodes canvas snapshot --node openclaw logs --follow ``` Если вы видите `NODE_BACKGROUND_UNAVAILABLE`, переведите приложение Node на передний план и повторите попытку. ## Матрица разрешений | Возможность | iOS | Android | Приложение Node для macOS | Типичный код ошибки | | ---------------------------- | --------------------------------------- | -------------------------------------------- | -------------------------------- | --------------------------------------------- | | `camera.snap`, `camera.clip` | Камера (+ микрофон для звука клипа) | Камера (+ микрофон для звука клипа) | Камера (+ микрофон для звука клипа) | `*_PERMISSION_REQUIRED` | | `screen.record` | Запись экрана (+ микрофон необязательно) | Запрос на захват экрана (+ микрофон необязательно) | Запись экрана | `*_PERMISSION_REQUIRED` | | `computer.act` | неприменимо | неприменимо | Универсальный доступ + запись экрана | `COMPUTER_DISABLED`, `ACCESSIBILITY_REQUIRED` | | `location.get` | При использовании или всегда (зависит от режима) | Геолокация на переднем/заднем плане в зависимости от режима | Разрешение на геолокацию | `LOCATION_PERMISSION_REQUIRED` | | `system.run` | неприменимо (путь хоста Node) | неприменимо (путь хоста Node) | Требуются разрешения на выполнение | `SYSTEM_RUN_DENIED` | ## Сопряжение и разрешения Успешность команды Node контролируют три независимых механизма: 1. **Сопряжение устройства**: может ли этот Node подключиться к Gateway? 2. **Политика команд Node в Gateway**: разрешён ли идентификатор команды RPC в `gateway.nodes.allowCommands` / `denyCommands` и настройках платформы по умолчанию? 3. **Разрешения на выполнение**: может ли этот Node локально выполнить конкретную команду оболочки? Сопряжение Node — это проверка идентичности и доверия, а не механизм разрешения отдельных команд. Для `system.run` политика конкретного Node хранится в файле разрешений на выполнение этого Node (`openclaw approvals get --node ...`), а не в записи сопряжения Gateway. Быстрые проверки: ```bash openclaw devices list openclaw nodes status openclaw approvals get --node openclaw approvals allowlist add --node "/usr/bin/uname" ``` - Сопряжение отсутствует: сначала одобрите устройство Node. - В `nodes describe` отсутствует команда: проверьте политику команд Node в Gateway и действительно ли Node объявил эту команду при подключении. - Сопряжение выполнено, но `system.run` завершается ошибкой: исправьте разрешения на выполнение или список разрешённых команд на этом Node. Для запусков `host=node`, требующих одобрения, Gateway также привязывает выполнение к подготовленному каноническому `systemRunPlan`. Если последующий вызывающий код изменит команду, рабочий каталог или метаданные сеанса до передачи одобренного запуска, Gateway отклонит запуск из-за несоответствия одобрению, а не станет доверять изменённой полезной нагрузке. ## Распространённые коды ошибок Node | Код | Значение | | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `NODE_BACKGROUND_UNAVAILABLE` | Приложение работает в фоновом режиме; переведите его на передний план. | | `CAMERA_DISABLED` | Переключатель камеры отключён в настройках Node. | | `*_PERMISSION_REQUIRED` | Разрешение ОС отсутствует или отклонено. | | `LOCATION_DISABLED` | Режим геолокации отключён. | | `LOCATION_PERMISSION_REQUIRED` | Запрошенный режим геолокации не разрешён. | | `LOCATION_BACKGROUND_UNAVAILABLE` | Приложение работает в фоновом режиме, но предоставлено только разрешение «При использовании». | | `COMPUTER_DISABLED` | Включите **Allow Computer Control** в приложении для macOS, затем одобрите обновление сопряжения. | | `ACCESSIBILITY_REQUIRED` | Предоставьте текущему пакету приложения OpenClaw универсальный доступ в системных настройках macOS. | | `SYSTEM_RUN_DENIED: approval required` | Запрос на выполнение требует явного одобрения. | | `SYSTEM_RUN_DENIED: allowlist miss` | Команда заблокирована режимом списка разрешённых команд. На хостах Node с Windows формы с оболочкой-обёрткой, такие как `cmd.exe /c ...`, считаются не входящими в список разрешённых команд, если они не одобрены через процесс запроса. | ## Быстрый цикл восстановления ```bash openclaw nodes status openclaw nodes describe --node openclaw approvals get --node openclaw logs --follow ``` Если проблема сохраняется: - Повторно одобрите сопряжение устройства. - Повторно откройте приложение Node на переднем плане. - Повторно предоставьте разрешения ОС. - Создайте заново или скорректируйте политику разрешений на выполнение. Для управления компьютером также убедитесь, что агент с поддержкой компьютерного зрения предоставляет инструмент `computer`, команда `screen.snapshot` успешно выполняется при наличии разрешения на запись экрана, а `/phone status` показывает требуемую временную или постоянную авторизацию Gateway. Запись `gateway.nodes.denyCommands` всегда имеет приоритет над `allowCommands`. ## Связанные материалы - [Обзор Node](/ru/nodes) - [Node с камерой](/ru/nodes/camera) - [Команда геолокации](/ru/nodes/location-command) - [Управление компьютером](/nodes/computer-use) - [Разрешения на выполнение](/ru/tools/exec-approvals) - [Сопряжение Gateway](/ru/gateway/pairing) - [Устранение неполадок Gateway](/ru/gateway/troubleshooting) - [Устранение неполадок каналов](/ru/channels/troubleshooting)