當節點在狀態中可見，但節點工具失敗時，請使用此頁面。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包含你正在呼叫的能力。- Exec 核准顯示預期的模式/allowlist。
前景需求
canvas.*、camera.* 和 screen.* 在 iOS/Android 節點上僅限前景使用。
快速檢查與修正：
NODE_BACKGROUND_UNAVAILABLE，請將節點 app 帶到前景並重試。
權限矩陣
| 能力 | iOS | Android | macOS 節點 app | 典型失敗代碼 |
|---|---|---|---|---|
camera.snap, camera.clip | 相機（剪輯音訊需加麥克風） | 相機（剪輯音訊需加麥克風） | 相機（剪輯音訊需加麥克風） | *_PERMISSION_REQUIRED |
screen.record | 螢幕錄製（麥克風可選） | 螢幕擷取提示（麥克風可選） | 螢幕錄製 | *_PERMISSION_REQUIRED |
location.get | 使用期間或永遠允許（取決於模式） | 依模式使用前景/背景定位 | 定位權限 | LOCATION_PERMISSION_REQUIRED |
system.run | n/a（節點主機路徑） | n/a（節點主機路徑） | 需要 Exec 核准 | SYSTEM_RUN_DENIED |
配對與核准
這些是不同的關卡：- 裝置配對：此節點是否可以連線到 Gateway？
- Gateway 節點命令政策：RPC 命令 ID 是否被
gateway.nodes.allowCommands/denyCommands和平台預設值允許？ - Exec 核准：此節點是否可以在本機執行特定 shell 命令？
nodes describe 缺少某個命令，請檢查 Gateway 節點命令政策，以及節點在連線時是否真的宣告了該命令。
如果配對正常但 system.run 失敗，請修正該節點上的 Exec 核准/allowlist。
節點配對是身分/信任關卡，不是逐命令核准介面。對於 system.run，逐節點政策位於該節點的 Exec 核准檔案（openclaw approvals get --node ...），而不是 Gateway 配對記錄。
對於由核准支援的 host=node 執行，Gateway 也會將執行綁定到
已準備的正規 systemRunPlan。如果後續呼叫者在已核准的執行轉送前修改 command/cwd 或
session 中繼資料，Gateway 會因核准不符而拒絕該
執行，而不是信任已編輯的 payload。
常見節點錯誤碼
NODE_BACKGROUND_UNAVAILABLE→ app 在背景中；請將它帶到前景。CAMERA_DISABLED→ 節點設定中的相機切換已停用。*_PERMISSION_REQUIRED→ 缺少/拒絕 OS 權限。LOCATION_DISABLED→ 定位模式已關閉。LOCATION_PERMISSION_REQUIRED→ 請求的定位模式未獲授權。LOCATION_BACKGROUND_UNAVAILABLE→ app 在背景中，但只有使用期間權限。SYSTEM_RUN_DENIED: approval required→ Exec 請求需要明確核准。SYSTEM_RUN_DENIED: allowlist miss→ 命令遭 allowlist 模式阻擋。 在 Windows 節點主機上，像cmd.exe /c ...這類 shell-wrapper 形式，在 allowlist 模式中會被視為 allowlist miss，除非透過詢問流程核准。
快速復原迴圈
- 重新核准裝置配對。
- 重新開啟節點 app（前景）。
- 重新授予 OS 權限。
- 重新建立/調整 Exec 核准政策。