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

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

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

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

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

openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>

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

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

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

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

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

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

Если вы видите NODE_BACKGROUND_UNAVAILABLE, выведите приложение узла на передний план и повторите попытку.

Матрица разрешений

Сопряжение и утверждения

Это разные контрольные барьеры:

1. Сопряжение устройства: может ли этот узел подключиться к Gateway?
2. Политика команд узла Gateway: разрешен ли идентификатор команды RPC через gateway.nodes.allowCommands / denyCommands и платформенные значения по умолчанию?
3. Утверждения выполнения: может ли этот узел локально выполнить конкретную команду оболочки?

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

openclaw devices listopenclaw nodes statusopenclaw 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 ..., считаются промахами списка разрешений в режиме списка разрешений, если они не утверждены через поток запроса.

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

openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>openclaw logs --follow

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

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

См. также

• Обзор узлов
• Узлы камеры
• Команда геолокации
• Утверждения выполнения
• Сопряжение Gateway
• Устранение неполадок Gateway
• Устранение неполадок каналов