适用场景：节点在状态中可见，但节点工具调用失败。
诊断命令梯队
# 第一步：基础状态检查
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包含你要调用的能力- Exec 审批显示预期的 mode/allowlist
前台要求
canvas.*、camera.*、screen.* 在 iOS/Android 节点上仅前台可用。
遇到 NODE_BACKGROUND_UNAVAILABLE：将节点应用切到前台后重试。
权限矩阵
| 能力 | iOS | Android | macOS | 典型错误码 |
|---|---|---|---|---|
camera.snap/clip | Camera（+mic） | Camera（+mic） | Camera（+mic） | *_PERMISSION_REQUIRED |
screen.record | Screen Recording | Screen capture | Screen Recording | *_PERMISSION_REQUIRED |
location.get | While Using/Always | 前台/后台 | Location | LOCATION_PERMISSION_REQUIRED |
system.run | n/a | n/a | Exec 审批 | SYSTEM_RUN_DENIED |
配对 vs 审批（三道门）
- 设备配对：节点能否连接到 Gateway？
- Gateway 节点命令策略：RPC 命令 ID 是否被
gateway.nodes.allowCommands/denyCommands允许？ - Exec 审批：节点能否在本地运行特定 shell 命令？
openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"常见错误码
| 错误码 | 解决方案 |
|---|---|
NODE_BACKGROUND_UNAVAILABLE | 将应用切到前台 |
CAMERA_DISABLED | 节点设置中开启摄像头 |
*_PERMISSION_REQUIRED | 授予 OS 权限 |
LOCATION_DISABLED | 开启位置模式 |
SYSTEM_RUN_DENIED: approval required | 添加 exec 审批 |
SYSTEM_RUN_DENIED: allowlist miss | 添加 allowlist 条目 |
快速恢复循环
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow仍卡住时：重新审批设备配对 → 重新打开节点应用（前台）→ 重新授予 OS 权限 → 重建 exec 审批策略。
相关页面
- nodes-index — Nodes 总览
- nodes-camera — 摄像头节点
- nodes-location-command — 位置命令