權限模式

權限模式決定代理程式在執行主機命令、寫入檔案，或向後端測試框架要求額外存取權之前，擁有多少權限。

權限模式與 tools.exec.host=auto 分開。tools.exec.host 選擇命令的執行位置。tools.exec.mode 選擇主機執行的 核准方式。

​

建議的預設值

對於需要實用主機存取權、但不希望每次未命中都提示人工處理的程式設計代理程式，請使用 auto：

openclaw config set tools.exec.mode auto
openclaw approvals get
openclaw gateway restart

接著驗證實際生效的原則：

openclaw exec-policy show

​

OpenClaw 主機執行模式

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 工作階段為非互動式，因此無法點選 TTY 權限提示。ACPX 會使用 plugins.entries.acpx.config 下獨立的測試框架層級設定：

設定	值	意義
permissionMode	approve-reads	僅自動核准讀取。
permissionMode	approve-all	自動核准寫入與 shell 命令。
permissionMode	deny-all	拒絕所有權限提示。
nonInteractivePermissions	fail	需要提示時中止。
nonInteractivePermissions	deny	拒絕提示，並在可能時繼續執行。

請將 ACPX 權限與 OpenClaw 執行核准分開設定：

openclaw config set plugins.entries.acpx.config.permissionMode approve-all
openclaw config set plugins.entries.acpx.config.nonInteractivePermissions fail
openclaw 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 get
openclaw exec-policy show

主機執行會採用 OpenClaw 設定與主機本機核准檔案中較嚴格的結果。ACPX 測試框架權限不會放寬主機執行核准，主機執行核准也不會放寬 ACPX 測試框架提示。

​

相關資訊

• 執行核准
• 執行核准－進階
• Codex 測試框架
• ACP 代理程式設定