人工智能大模型LLM 網(wǎng)關(guān)AI Agent即時通訊【免費(fèi)下載鏈接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi項目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token點擊查看免費(fèi)下載導(dǎo)讀本文聚焦 OpenClaw 中「節(jié)點Node可見但節(jié)點工具canvas、camera、screen、exec 等調(diào)用失敗」這一經(jīng)典場景以官方節(jié)點故障排查文檔為主體系統(tǒng)講解診斷命令階梯、前臺運(yùn)行約束、權(quán)限矩陣、配對與審批的兩層心智模型、常見錯誤碼及快速恢復(fù)循環(huán)。讀者將掌握從openclaw status起步、逐層定位到具體錯誤碼并最終通過「設(shè)備配對 執(zhí)行審批 OS 權(quán)限」三軸修復(fù)問題的完整實戰(zhàn)能力同時理解這些規(guī)則背后的網(wǎng)關(guān)協(xié)議與節(jié)點宿主實現(xiàn)原理。適用場景與核心心智模型本文對應(yīng)的排查入口非常明確當(dāng)節(jié)點在openclaw status中可見connected/paired但canvas.*、camera.*、screen.*、system.run等節(jié)點工具調(diào)用失敗時應(yīng)優(yōu)先使用本文的排查路徑。相關(guān)的基礎(chǔ)設(shè)施與命令面定義在 docs/nodes/index.md 中一個**節(jié)點node**是連接 Gateway WebSocket與操作者同一端口的伴隨設(shè)備macOS/iOS/Android/headless以role: node身份連接并通過node.invoke暴露命令面如canvas.*、camera.*、device.*、notifications.*、system.*。在動手排查前先建立兩個關(guān)鍵心智模型節(jié)點是外設(shè)不是網(wǎng)關(guān)節(jié)點不運(yùn)行網(wǎng)關(guān)服務(wù)Telegram/WhatsApp 等消息落在網(wǎng)關(guān)上而非節(jié)點上節(jié)點只是被網(wǎng)關(guān)調(diào)用的能力提供方。兩層獨(dú)立的門禁設(shè)備能否連接網(wǎng)關(guān)配對與設(shè)備能否執(zhí)行某條 shell 命令審批是兩套完全不同的門禁后面會詳細(xì)展開。命令階梯Command ladder從全局到節(jié)點官方排查文檔給出的標(biāo)準(zhǔn)起點是一組從全局到節(jié)點的命令階梯openclaw status openclaw gateway status openclaw logs --follow openclaw doctor openclaw channels status --probeopenclaw status與openclaw gateway status確認(rèn)網(wǎng)關(guān)整體健康節(jié)點工具的調(diào)用都經(jīng)由網(wǎng)關(guān)轉(zhuǎn)發(fā)網(wǎng)關(guān)異常會讓一切節(jié)點調(diào)用失敗。openclaw logs --follow實時觀察調(diào)用失敗時的錯誤碼與內(nèi)部日志是后續(xù)所有步驟的眼睛。openclaw doctor系統(tǒng)性體檢可發(fā)現(xiàn)配置、狀態(tài)與權(quán)限方面的隱患對應(yīng) docs/gateway/doctor.md。openclaw channels status --probe探測渠道憑據(jù)--probe在 cli/channels-cli.ts 中定義為Probe channel credentials用于排除渠道層面的干擾。隨后進(jìn)入節(jié)點專屬檢查openclaw nodes status openclaw nodes describe --node idOrNameOrIp openclaw approvals get --node idOrNameOrIp健康信號Healthy signals應(yīng)同時滿足節(jié)點已連接且以node角色完成配對paired for rolenode。nodes describe的輸出包含你正在調(diào)用的能力capability。執(zhí)行審批Exec approvals顯示預(yù)期的模式security/ask與 allowlist。關(guān)于nodes describe的字段語義可參考 cli/nodes-cli/register.status.tsdescribe通過node.describeRPC 獲取節(jié)點信息輸出 ID、Name、IP、Device、Model、Perms、Version、PATH、Status、Caps 等字段并單獨(dú)列出該節(jié)點上報的 Commands 列表obj.commands。如果你要調(diào)用的命令不在 Commands 列表里即使節(jié)點已配對連接調(diào)用也會失敗——這正是能力未上報類問題的判斷依據(jù)。前臺運(yùn)行要求Foreground requirementscanvas.*、camera.*、screen.*在 iOS/Android 節(jié)點上僅在前臺foreground可用后臺調(diào)用一律失敗。這是移動操作系統(tǒng)對攝像頭、屏幕錄制等敏感能力的硬性限制?？焖贆z查與修復(fù)openclaw nodes describe --node idOrNameOrIp openclaw nodes canvas snapshot --node idOrNameOrIp openclaw logs --follow如果日志中出現(xiàn)NODE_BACKGROUND_UNAVAILABLE把節(jié)點 App 切到前臺后重試即可。源碼佐證在 docs/nodes/camera.md 中明確說明Likecanvas.*, the iOS node only allowscamera.*commands in theforeground. Background invocations returnNODE_BACKGROUND_UNAVAILABLE.docs/nodes/location-command.md 也指出 Android 在后臺會拒絕location.get。可以推斷這類錯誤碼由節(jié)點端按平臺分別實現(xiàn)因此排查時務(wù)必確認(rèn)具體平臺的行為差異。權(quán)限矩陣Permissions matrix不同能力在不同平臺上要求的 OS 權(quán)限不同官方文檔給出了完整的對照矩陣CapabilityiOSAndroidmacOS node app典型失敗碼camera.snap,camera.clipCameraclip 音頻需要 MicCameraclip 音頻需要 MicCameraclip 音頻需要 Mic*_PERMISSION_REQUIREDscreen.recordScreen RecordingMic 可選Screen capture promptMic 可選Screen Recording*_PERMISSION_REQUIREDlocation.getWhile Using 或 Always依模式而定依模式的前臺/后臺定位Location permissionLOCATION_PERMISSION_REQUIREDsystem.runn/a節(jié)點宿主路徑n/a節(jié)點宿主路徑需要 Exec approvalsSYSTEM_RUN_DENIED關(guān)鍵解讀system.run在 iOS/Android 節(jié)點上是n/a不適用因為移動端并不直接暴露通用 shell 執(zhí)行它只在 macOS 節(jié)點 App 與 headless 節(jié)點宿主上存在且由Exec approvals而非 OS 權(quán)限門禁。相機(jī)、屏幕錄制失敗時錯誤碼往往以_PERMISSION_REQUIRED結(jié)尾例如CAMERA_PERMISSION_REQUIRED、RECORD_AUDIO_PERMISSION_REQUIRED——這說明是 OS 層授權(quán)缺失需要去系統(tǒng)設(shè)置補(bǔ)授權(quán)而不是改 OpenClaw 配置。Android 在相機(jī)與錄音權(quán)限缺失時會在可能時彈出系統(tǒng)授權(quán)框若被拒絕則以*_PERMISSION_REQUIRED失敗見 docs/nodes/camera.md。配對 vs 審批兩層獨(dú)立的門禁官方文檔用一個兩步模型幫助理解節(jié)點排障的本質(zhì)設(shè)備配對Device pairing該節(jié)點能否連接到網(wǎng)關(guān)執(zhí)行審批Exec approvals該節(jié)點能否執(zhí)行某條具體的 shell 命令快速檢查命令openclaw devices list openclaw nodes status openclaw approvals get --node idOrNameOrIp openclaw approvals allowlist add --node idOrNameOrIp /usr/bin/uname如果配對缺失 → 先批準(zhǔn)節(jié)點設(shè)備如果配對正常但system.run失敗 → 修復(fù)執(zhí)行審批/allowlist。配對Pairing的底層機(jī)制從 docs/gateway/pairing.md 可知WS 節(jié)點在connect握手期間攜帶設(shè)備身份網(wǎng)關(guān)為role: node創(chuàng)建設(shè)備配對請求待審批請求5 分鐘自動過期批準(zhǔn)后網(wǎng)關(guān)簽發(fā)全新 tokentoken 會在重新配對時輪換節(jié)點用 token 重連后即為 paired。配對狀態(tài)存儲于網(wǎng)關(guān)狀態(tài)目錄~/.openclaw/nodes/paired.json與~/.openclaw/nodes/pending.json。CLI 形態(tài)openclaw devices list openclaw devices approve requestId openclaw devices reject requestId openclaw nodes pending openclaw nodes approve requestId openclaw nodes reject requestId openclaw nodes rename --node id|name|ip --name Living Room iPad注意區(qū)分nodes status將節(jié)點標(biāo)記為paired的前提是設(shè)備配對的角色包含node而node.pair.*CLI 為openclaw nodes pending/approve/reject是獨(dú)立的網(wǎng)關(guān)側(cè)節(jié)點配對存儲并不門禁 WS connect 握手見 docs/nodes/index.md。排查時如果看到已配對但連不上要檢查是否走錯了配對通道。執(zhí)行審批Exec approvals的底層機(jī)制執(zhí)行審批是伴隨 App / 節(jié)點宿主的護(hù)欄guardrail用于讓沙箱內(nèi)的 Agent 在真實主機(jī)gateway或node上執(zhí)行命令——只有策略 allowlist 可選用戶審批三方一致時命令才被放行。關(guān)鍵點詳見 docs/tools/exec-approvals.md生效位置審批在執(zhí)行宿主本地強(qiáng)制生效——網(wǎng)關(guān)宿主是openclaw進(jìn)程節(jié)點宿主是 macOS 伴隨 App 或 headless 節(jié)點宿主數(shù)據(jù)落在宿主本地的~/.openclaw/exec-approvals.json。策略旋鈕securityexec.securitydeny全部攔截/allowlist僅允許白名單命令/full放行一切。askexec.askoff永不提示/on-miss僅白名單未命中時提示/always每條命令都提示。askFallback審批 UI 不可達(dá)時的兜底deny攔截/allowlist僅白名單命中/full放行。有效策略取更嚴(yán)格者tools.exec.*與 approvals 默認(rèn)值中較嚴(yán)格的一方生效approvals 字段缺省時回落到tools.exec值。allowlist 按 Agent 劃分模式是大小寫不敏感的 glob 匹配應(yīng)解析到二進(jìn)制路徑僅 basename 的條目會被忽略例如~/Projects/**/bin/rg、/opt/homebrew/bin/rg。源碼實現(xiàn)證據(jù)審批決策邏輯位于 node-host/exec-policy.ts 的evaluateSystemRunPolicy。它按security deny返回SYSTEM_RUN_DISABLED: securitydeny→requiresAsk !approvedByAsk返回SYSTEM_RUN_DENIED: approval required→allowlist未命中返回SYSTEM_RUN_DENIED: allowlist miss的順序裁決shell 包裝bash|sh|zsh -c/-lc在 allowlist 模式下被判定為shellWrapperBlockedWindows 上的cmd.exe /c變體被額外標(biāo)記為windowsShellWrapperBlocked并在 node-host/exec-policy.ts 的formatSystemRunAllowlistMissMessage中給出帶說明的報錯信息。CLI 側(cè)openclaw nodes run對應(yīng) cli/nodes-cli/register.invoke.ts會先調(diào)用system.run.prepare生成規(guī)范化的systemRunPlan通過exec.approvals.node.get讀取節(jié)點宿主審批快照再按需經(jīng)exec.approval.request發(fā)起審批請求審批結(jié)果allow-once / allow-always / deny隨node.invoke的approved、approvalDecision、runId等參數(shù)一并下發(fā)。審批請求在批準(zhǔn)后綁定規(guī)范執(zhí)行上下文規(guī)范 cwd、可固定的可執(zhí)行文件路徑、解釋器式腳本操作數(shù)——若審批后腳本內(nèi)容漂移運(yùn)行會被拒絕而非執(zhí)行漂移內(nèi)容。常見節(jié)點錯誤碼官方文檔給出的錯誤碼速查表如下錯誤碼含義與修復(fù)NODE_BACKGROUND_UNAVAILABLEApp 處于后臺將其切到前臺再重試CAMERA_DISABLED節(jié)點設(shè)置中相機(jī)開關(guān)被關(guān)閉iOS/Android 的camera.enabled默認(rèn)開啟關(guān)閉后camera.*返回此碼*_PERMISSION_REQUIREDOS 權(quán)限缺失或被拒絕去系統(tǒng)設(shè)置補(bǔ)授權(quán)LOCATION_DISABLED定位模式開關(guān)為 offLOCATION_PERMISSION_REQUIRED請求的定位模式未獲授權(quán)LOCATION_BACKGROUND_UNAVAILABLEApp 在后臺但僅有 While Using 權(quán)限SYSTEM_RUN_DENIED: approval requiredexec 請求需要顯式審批SYSTEM_RUN_DENIED: allowlist miss命令被 allowlist 模式攔截補(bǔ)充說明CAMERA_DISABLED與開關(guān)的關(guān)系iOS/Android 節(jié)點設(shè)置中camera.enabled默認(rèn)開啟缺失鍵視為啟用macOS 伴隨 App 的openclaw.cameraEnabled默認(rèn)關(guān)閉。關(guān)閉狀態(tài)下camera.*返回CAMERA_DISABLED見 docs/nodes/camera.md。定位錯誤碼的完整集合還包括LOCATION_TIMEOUT超時未定位與LOCATION_UNAVAILABLE系統(tǒng)故障/無定位提供方以及l(fā)ocation.get的精度參數(shù)desiredAccuracy: coarse|balanced|precise與響應(yīng)中的accuracyMeters、isPrecise、source等字段見 docs/nodes/location-command.md。Windows 節(jié)點宿主的 allowlist 特例在 allowlist 模式下cmd.exe /c ...這類 shell 包裝形式會被視為 allowlist miss除非通過 ask 流程顯式批準(zhǔn)文檔原文同時被 node-host/exec-policy.ts 的報錯文案證實Windows shell wrappers like cmd.exe /c require approval; approve once/always or run with --ask on-miss|always。shell 包裝的通用規(guī)則同樣適用于sh/bash/zsh -c。allowlist 模式下 shell 鏈接與重定向、||、;僅當(dāng)每個頂層段都滿足 allowlist 時才放行重定向在 allowlist 模式下不支持命令替換$()/ 反引號在 allowlist 解析時被拒絕詳見 docs/tools/exec-approvals.md?？焖倩謴?fù)循環(huán)Fast recovery loop當(dāng)節(jié)點工具仍然失敗時官方文檔給出標(biāo)準(zhǔn)恢復(fù)循環(huán)openclaw nodes status openclaw nodes describe --node idOrNameOrIp openclaw approvals get --node idOrNameOrIp openclaw logs --follow如果仍然卡住依次執(zhí)行四步修復(fù)重新批準(zhǔn)設(shè)備配對Re-approve device pairing——通過openclaw devices approve requestId必要時先openclaw devices list查看待批準(zhǔn)請求。重新打開節(jié)點 App保持前臺Re-open node app——解決NODE_BACKGROUND_UNAVAILABLE類問題。重新授予 OS 權(quán)限Re-grant OS permissions——解決*_PERMISSION_REQUIRED、LOCATION_PERMISSION_REQUIRED類問題。重建/調(diào)整執(zhí)行審批策略Recreate/adjust exec approval policy——通過openclaw approvals編輯security、ask、askFallback與 allowlist或直接編輯節(jié)點宿主的~/.openclaw/exec-approvals.json。審批策略調(diào)整的實操入口CLIopenclaw approvals支持 get/set/allowlist 子命令見 cli/exec-approvals-cli.ts 的get、set、allowlist注冊并可針對網(wǎng)關(guān)或指定節(jié)點操作openclaw approvals get --node idOrNameOrIp openclaw approvals set --node idOrNameOrIp --security allowlist openclaw approvals allowlist add --node idOrNameOrIp /usr/bin/uname openclaw approvals allowlist add --node idOrNameOrIp /usr/bin/sw_vers openclaw approvals allowlist rm --node idOrNameOrIp /usr/bin/unameControl UI在Control UI → Nodes → Exec approvals卡片中編輯默認(rèn)值、按 Agent 的覆蓋與 allowlist目標(biāo)選擇器可選擇 Gateway本地審批或某個節(jié)點。節(jié)點必須上報system.execApprovals.get/set才能被 UI/CLI 編輯macOS App 與 headless 節(jié)點宿主均支持iOS/Android 不支持。直接編輯文件若節(jié)點未上報 exec approvals 命令面可直接編輯其本地~/.openclaw/exec-approvals.json。該文件 schema 示例來自 docs/tools/exec-approvals.md{ version: 1, socket: { path: ~/.openclaw/exec-approvals.sock, token: base64url-token }, defaults: { security: deny, ask: on-miss, askFallback: deny, autoAllowSkills: false }, agents: { main: { security: allowlist, ask: on-miss, askFallback: deny, autoAllowSkills: true, allowlist: [ { id: B0C8C0B3-2C2D-4F8A-9A3C-5A4B3C2D1E0F, pattern: ~/Projects/**/bin/rg, lastUsedAt: 1737150000000, lastUsedCommand: rg -n TODO, lastResolvedPath: /Users/user/Projects/.../bin/rg } ] } } }注意每個 allowlist 條目還跟蹤lastUsedAt、lastUsedCommand、lastResolvedPath便于 UI 展示上次使用信息也方便清理長期未使用的條目。把 exec 指向指定節(jié)點如果網(wǎng)關(guān)配置了多個節(jié)點可以顯式綁定 exec 目標(biāo)詳見 docs/nodes/index.mdopenclaw config set tools.exec.host node openclaw config set tools.exec.security allowlist openclaw config set tools.exec.node id-or-name會話內(nèi)也可以用斜杠命令覆蓋/exec hostnode securityallowlist nodeid-or-name設(shè)置后任何hostnode的 exec 調(diào)用都會在指定節(jié)點宿主上運(yùn)行受該節(jié)點的 allowlist/審批約束。若要讓 exec 默認(rèn)不綁特定節(jié)點可openclaw config unset tools.exec.node。深度排障提示從源碼結(jié)構(gòu)可以推斷的要點未知平臺的保守默認(rèn)從 docs/nodes/index.md 可知未識別platform/deviceFamily的節(jié)點使用保守默認(rèn) allowlist排除system.run與system.which若確需在未知平臺使用這些命令需通過gateway.nodes.allowCommands顯式添加。這類節(jié)點system.run失敗時先檢查是否是平臺識別問題而非權(quán)限問題。環(huán)境變量衛(wèi)生節(jié)點宿主會忽略PATH覆蓋并剝離危險啟動/shell 鍵DYLD_*、LD_*、NODE_OPTIONS、PYTHON*、PERL*、RUBYOPT、SHELLOPTS、PS4shell 包裝的命令行--env覆蓋被縮減為顯式允許列表TERM、LANG、LC_*、COLORTERM、NO_COLOR、FORCE_COLOR。若你的命令因環(huán)境變量缺失而失敗應(yīng)配置節(jié)點宿主服務(wù)環(huán)境而非通過--env PATH...傳入。allow-always 的包裝器解包allowlist 模式下允許始終決策會對已知分發(fā)包裝器env、nice、nohup、stdbuf、timeout持久化內(nèi)部可執(zhí)行文件路徑而非包裝器路徑無法安全解包時不自動持久化 allowlist 條目node-host/exec-policy.ts 與 docs/nodes/index.md 一致。系統(tǒng)事件關(guān)聯(lián)審批門控的 exec 復(fù)用審批 id 作為runId出現(xiàn)在系統(tǒng)事件Exec running/Exec finished/Exec denied中配合openclaw logs --follow可精確關(guān)聯(lián)哪次審批對應(yīng)哪次執(zhí)行。相關(guān)文檔導(dǎo)航節(jié)點總覽與命令面docs/nodes/index.md相機(jī)捕獲細(xì)節(jié)docs/nodes/camera.md定位命令與權(quán)限模式docs/nodes/location-command.md執(zhí)行審批完整策略與 allowlistdocs/tools/exec-approvals.md網(wǎng)關(guān)側(cè)設(shè)備配對機(jī)制docs/gateway/pairing.md審批決策與報錯文案實現(xiàn)node-host/exec-policy.ts節(jié)點狀態(tài)/描述 CLI 實現(xiàn)cli/nodes-cli/register.status.ts節(jié)點命令調(diào)用與審批聯(lián)動實現(xiàn)cli/nodes-cli/register.invoke.ts贊分享人工智能大模型LLM 網(wǎng)關(guān)AI Agent即時通訊【免費(fèi)下載鏈接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi項目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token點擊查看免費(fèi)下載相關(guān)推薦ComfyUI IPAdapter Plus完整指南從安裝到高級工作流故障排查ComfyUI IPAdapter Plus完整指南從安裝到高級工作流故障排查 ComfyUI IPAdapter Plus是ComfyUI中功能最強(qiáng)大的圖像人工智能計算機(jī)視覺媒體生成AI 插件Woodpecker CI 排障實戰(zhàn)克隆失敗與 SELinux 權(quán)限問題的系統(tǒng)化排查方案Woodpecker CI 排障實戰(zhàn)克隆失敗與 SELinux 權(quán)限問題的系統(tǒng)化排查方案 本文是 Woodpecker CI/CD 引擎的故障排查指南聚焦兩CI/CDDevOpsmirrord Operator 故障排查完全指南從連接失敗到會話中斷的排障手冊mirrord Operator 故障排查完全指南從連接失敗到會話中斷的排障手冊 本文以 mirrord 倉庫內(nèi) mirrord operator/refer開發(fā)工具云原生CLI上一篇docker-selenium 4.48.0 發(fā)布記錄Edge 116 鏡像標(biāo)簽生成全解析與 Tagging 規(guī)范下一篇TorchVision 量化 ResNeXt 模型使用指南基于 QuantizableResNet 的 8-bit 推理實戰(zhàn)創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考