CLI - approvals 命令

openclaw approvals

管理本地主机、Gateway 主机或节点主机的 exec approvals。

别名：openclaw exec-approvals

查看当前策略

openclaw approvals get                        # 本地 approvals
openclaw approvals get --gateway              # Gateway 主机
openclaw approvals get --node <id|name|ip>    # 指定节点

输出包含三层：

1. 请求的 tools.exec 策略
2. 主机 approvals 文件策略
3. 优先级规则合并后的生效结果

替换 approvals 文件

openclaw approvals set --file ./exec-approvals.json
openclaw approvals set --stdin <<'EOF'
{ version: 1, defaults: { security: "full", ask: "off" } }
EOF
openclaw approvals set --node <id|name|ip> --file ./exec-approvals.json
openclaw approvals set --gateway --file ./exec-approvals.json

支持 JSON5 格式。--file 和 --stdin 不能同时使用。

YOLO 模式（永不提示）

openclaw approvals set --stdin <<'EOF'
{
  version: 1,
  defaults: { security: "full", ask: "off", askFallback: "full" }
}
EOF
 
# 同步 config 侧配置
openclaw config set tools.exec.host gateway
openclaw config set tools.exec.security full
openclaw config set tools.exec.ask off

本地快捷方式：

openclaw exec-policy preset yolo

Allowlist 管理

openclaw approvals allowlist add "~/Projects/**/bin/rg"
openclaw approvals allowlist add --agent main --node <id|name|ip> "/usr/bin/uptime"
openclaw approvals allowlist add --agent "*" "/usr/bin/uname"
openclaw approvals allowlist remove "~/Projects/**/bin/rg"

• --agent 默认为 "*"（适用所有 agent）

exec-policy 命令

openclaw exec-policy 是本地专用命令，同步 tools.exec.* 配置和本地 approvals 文件：

openclaw exec-policy show                                          # 查看当前策略
openclaw exec-policy preset yolo                                   # 应用 YOLO 预设
openclaw exec-policy preset cautious
openclaw exec-policy set --host gateway --security full --ask off

注意：exec-policy 仅操作本地，不推送到 Gateway 或节点。

目标说明

标志	目标
无标志	本地磁盘 approvals 文件
--gateway	Gateway 主机 approvals 文件
--node <id|name|ip>	指定节点主机

approvals 文件路径：~/.openclaw/exec-approvals.json

相关链接

• cli-node — 无头节点主机
• cli-sandbox — 沙箱管理