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

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

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Затем выполните проверки, специфичные для узла: 
openclaw nodes status
openclaw 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, выведите приложение узла на передний план и повторите попытку.

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

ВозможностьiOSAndroidПриложение узла 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. Утверждения выполнения: может ли этот узел локально выполнить конкретную команду оболочки?
Быстрые проверки: 
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 ..., считаются промахами списка разрешений в режиме списка разрешений, если они не утверждены через поток запроса.

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

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
Если проблема сохраняется:
  • Повторно утвердите сопряжение устройства.
  • Повторно откройте приложение узла (на переднем плане).
  • Повторно предоставьте разрешения ОС.
  • Пересоздайте/скорректируйте политику утверждений выполнения.

​
См. также