Tools
權限模式
權限模式決定代理程式在執行主機命令、寫入檔案，或向後端執行框架要求額外存取權之前，擁有多大的權限。
建議的預設值
對於需要實用主機存取權，但不希望每次未命中都要求人工確認的程式設計代理程式，請使用 auto：
openclaw config set tools.exec.mode autoopenclaw approvals getopenclaw gateway restart然後驗證實際生效的原則：
openclaw exec-policy showOpenClaw 主機執行模式
tools.exec.mode 是主機 exec 的標準化原則介面。每種模式都會解析為底層的 security（允許清單嚴格程度）與 ask（未命中時提示）組合：
| 模式 | security / ask | 行為 | 適用情況 |
|---|---|---|---|
deny |
deny / off |
完全封鎖主機執行。 | 不允許任何主機命令。 |
allowlist |
allowlist / off |
僅執行允許清單中的命令；未命中時直接拒絕，不顯示提示。 | 你有一組已知安全的命令。 |
ask |
allowlist / on-miss |
執行符合允許清單的命令；未命中時詢問人工。 | 每個新命令都應由人工審查。 |
auto |
allowlist / on-miss |
執行符合允許清單的命令；未命中時先送交自動審查，再回退至人工核准。 | 程式設計工作階段需要實用且受保護的存取權。 |
full |
full / off |
執行主機命令時不顯示提示。 | 此受信任的主機／工作階段應略過核准關卡。 |
ask 與 auto 使用相同的允許清單／詢問設定；auto 會另外啟用原生自動審查器，由其自行判斷未命中項目，只有在無法安全核准時，才轉交至已設定的人工核准管道。
如需完整的主機執行原則、本機核准檔案、允許清單結構描述、安全執行檔及轉送行為，請參閱執行核准。
Codex Guardian 對應關係
對於原生 Codex 應用程式伺服器工作階段，當本機 Codex 需求允許時，tools.exec.mode: "auto" 會讓 Codex 採用由 Guardian 審查的核准流程。通常產生的值如下：
| Codex 欄位 | 通常的值 |
|---|---|
approvalPolicy |
on-request |
approvalsReviewer |
auto_review |
sandbox |
workspace-write |
auto 模式會強制採用此原則，覆寫任何已設定的 Codex 沙箱／核准覆寫值，因此不會保留舊有的不安全組合，例如 approvalPolicy: "never" 搭配 sandbox: "danger-full-access"。tools.exec.mode: "deny" 與 "allowlist" 會完全封鎖 Codex 應用程式伺服器的本機執行。只有在你刻意希望採用無須核准的運作方式時，才使用 tools.exec.mode: "full"。
如需應用程式伺服器設定、驗證順序及原生 Codex 執行階段的詳細資訊，請參閱 Codex 執行框架。
ACPX 執行框架權限
ACPX 工作階段為非互動式，因此無法在終端介面權限提示上進行點選。ACPX 使用 plugins.entries.acpx.config 下獨立的執行框架層級設定：
| 設定 | 值 | 含義 |
|---|---|---|
permissionMode |
approve-reads |
僅自動核准讀取操作。 |
permissionMode |
approve-all |
自動核准寫入操作與殼層命令。 |
permissionMode |
deny-all |
拒絕所有權限提示。 |
nonInteractivePermissions |
fail |
需要提示時中止。 |
nonInteractivePermissions |
deny |
拒絕提示，並在可能的情況下繼續執行。 |
請將 ACPX 權限與 OpenClaw 執行核准分開設定：
openclaw config set plugins.entries.acpx.config.permissionMode approve-allopenclaw config set plugins.entries.acpx.config.nonInteractivePermissions failopenclaw gateway restart將 approve-all 作為 ACPX 在緊急情況下使用的無提示執行框架工作階段等效模式。如需設定詳細資訊與失敗模式，請參閱 ACP 代理程式設定。
選擇模式
| 目標 | 設定 |
|---|---|
| 完全封鎖主機命令 | tools.exec.mode: "deny" |
| 僅允許已知安全的命令執行 | tools.exec.mode: "allowlist" |
| 每種新命令形式都詢問人工 | tools.exec.mode: "ask" |
| 在詢問人工前使用 Codex/OpenClaw 自動審查 | tools.exec.mode: "auto" |
| 完全略過主機執行核准 | tools.exec.mode: "full" 加上相符的主機核准檔案 |
| 允許非互動式 ACPX 工作階段寫入／執行 | plugins.entries.acpx.config.permissionMode: "approve-all" |
如果變更模式後，命令仍然顯示提示或執行失敗，請檢查兩個層級：
openclaw approvals getopenclaw exec-policy show主機執行會採用 OpenClaw 設定與主機本機核准檔案兩者之中較嚴格的結果。ACPX 執行框架權限不會放寬主機執行核准，而主機執行核准也不會放寬 ACPX 執行框架提示。
