Використовуйте цю сторінку, коли Node видно у статусі, але інструменти Node не працюють.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Сходи команд
- Node підключено та спарено для ролі
node. nodes describeмістить capability, яку ви викликаєте.- Погодження exec показують очікуваний режим/allowlist.
Вимоги переднього плану
canvas.*, camera.* і screen.* працюють лише на передньому плані на iOS/Android Node.
Швидка перевірка та виправлення:
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?
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.
Швидкий цикл відновлення
- Повторно погодьте спарення пристрою.
- Повторно відкрийте застосунок Node (передній план).
- Повторно надайте дозволи ОС.
- Відтворіть/налаштуйте політику погоджень exec.