Nodes and media

Усунення несправностей Node

Використовуйте цю сторінку, коли Node видно у статусі, але інструменти Node не працюють.

Сходи команд

bash

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

Потім виконайте перевірки, специфічні для Node:

bash

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

Ознаки справного стану:

Node підключено та спарено для ролі node.
nodes describe містить capability, яку ви викликаєте.
Погодження exec показують очікуваний режим/allowlist.

Вимоги переднього плану

canvas.*, camera.* і screen.* працюють лише на передньому плані на iOS/Android Node.

Швидка перевірка та виправлення:

bash

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

Якщо ви бачите NODE_BACKGROUND_UNAVAILABLE, переведіть застосунок Node на передній план і повторіть спробу.

Матриця дозволів

Capability	iOS	Android	застосунок Node для macOS	Типовий код помилки
`camera.snap`, `camera.clip`	Камера (+ мікрофон для аудіо кліпу)	Камера (+ мікрофон для аудіо кліпу)	Камера (+ мікрофон для аудіо кліпу)	`*_PERMISSION_REQUIRED`
`screen.record`	Запис екрана (+ мікрофон необов’язково)	Запит на захоплення екрана (+ мікрофон необов’язково)	Запис екрана	`*_PERMISSION_REQUIRED`
`location.get`	Під час використання або завжди (залежить від режиму)	Геолокація переднього/фонового плану залежно від режиму	Дозвіл на геолокацію	`LOCATION_PERMISSION_REQUIRED`
`system.run`	н/д (шлях хоста Node)	н/д (шлях хоста Node)	Потрібні погодження exec	`SYSTEM_RUN_DENIED`

Спарення проти погоджень

Це різні шлюзи:

Спарення пристрою: чи може цей Node підключитися до Gateway?
Політика команд Gateway для Node: чи дозволено ID команди RPC через gateway.nodes.allowCommands / denyCommands і стандартні налаштування платформи?
Погодження exec: чи може цей Node локально виконати конкретну команду shell?

Швидкі перевірки:

bash

openclaw devices listopenclaw nodes statusopenclaw approvals get --node <idOrNameOrIp>openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"

Якщо спарення відсутнє, спочатку погодьте пристрій Node. Якщо в nodes describe бракує команди, перевірте політику команд Gateway для Node і чи Node справді оголосив цю команду під час підключення. Якщо спарення справне, але system.run завершується з помилкою, виправте погодження exec/allowlist на цьому Node.

Спарення Node — це шлюз ідентичності/довіри, а не поверхня погодження для кожної команди. Для system.run політика конкретного Node зберігається у файлі погоджень exec цього Node (openclaw approvals get --node ...), а не в записі спарення Gateway.

Для запусків host=node, підкріплених погодженням, Gateway також прив’язує виконання до підготовленого канонічного systemRunPlan. Якщо пізніший викликач змінює команду/cwd або метадані сесії до пересилання погодженого запуску, Gateway відхиляє запуск як невідповідність погодження, замість того щоб довіряти зміненому payload.

Поширені коди помилок Node

NODE_BACKGROUND_UNAVAILABLE → застосунок у фоновому режимі; переведіть його на передній план.
CAMERA_DISABLED → перемикач камери вимкнено в налаштуваннях Node.
*_PERMISSION_REQUIRED → дозвіл ОС відсутній/відхилений.
LOCATION_DISABLED → режим геолокації вимкнено.
LOCATION_PERMISSION_REQUIRED → запитаний режим геолокації не надано.
LOCATION_BACKGROUND_UNAVAILABLE → застосунок у фоновому режимі, але є лише дозвіл «Під час використання».
SYSTEM_RUN_DENIED: approval required → запит exec потребує явного погодження.
SYSTEM_RUN_DENIED: allowlist miss → команду заблоковано режимом allowlist. На хостах Windows Node форми shell-wrapper на кшталт cmd.exe /c ... розглядаються як промахи allowlist у режимі allowlist, якщо їх не погоджено через ask flow.

Швидкий цикл відновлення

bash

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

Якщо проблема лишається:

Повторно погодьте спарення пристрою.
Повторно відкрийте застосунок Node (передній план).
Повторно надайте дозволи ОС.
Відтворіть/налаштуйте політику погоджень exec.

Пов’язане

Was this useful?