OpenClaw（龙虾）手机节点工具失败怎么办？

OpenClaw（龙虾）手机节点已经配对但 camera、Canvas、screen、exec 类工具失败，先检查节点是否在线、能力是否存在、系统权限是否授予。配对成功只代表节点能连上，不代表每个工具都有权限。

排查顺序

1. openclaw status 和 openclaw gateway status 确认网关正常。
2. openclaw nodes status 看节点是否在线。
3. openclaw nodes describe --node <idOrNameOrIp> 看能力列表。
4. openclaw logs --follow 查具体拒绝原因。

常见错误

• NODE_BACKGROUND_UNAVAILABLE：把节点 App 切到前台。
• *_PERMISSION_REQUIRED：系统相机、麦克风、屏幕等权限没给。
• SYSTEM_RUN_DENIED: approval required：node host 的 exec 操作在等审批。
• allowlist miss：命令不在允许列表里。

移动节点适合拍照、语音、Canvas 和设备侧操作，但不要把手机当无限权限远程终端。能在 Gateway 完成的命令，优先放 Gateway；必须在手机执行的，再单独开 node 权限。

官方开源地址：https://github.com/openclaw/openclaw。

如果权限刚授予仍然失败，重启节点 App 和 Gateway 再测一次。移动系统经常需要 App 重新进入前台后才真正刷新权限状态，尤其是相机、麦克风和屏幕相关能力。