【操作指南】OpenClaw v3.31 升级后:恢复完整 exe c 权限

#📝 前言
随着 OpenClaw 升级至 v3.31 版本,系统对 exec(执行命令)的权限逻辑进行了显著调整,旨在提升安全性。默认情况下,系统不再自动信任所有设备,而是采用了更保守的沙箱策略。
如果您需要保持原有的高自由度环境,或者正在运行依赖特定主机和权限链的自动化任务,您需要手动配置以恢复完整 exec 权限。
#⚠️ 变更背景 (v3.31)
在升级前请知悉新旧行为的差异,以便评估风险:
特性旧版本行为 (v3.30-)新版本行为 (v3.31+)影响说明默认 Hostgatewayauto (可能降级到 sandbox)部分命令可能无法访问网关级资源。设备权限配对即拥有 Node 权限需节点配对审批才可用 Node 命令新增的配对流程若未处理,Node 功能受限。事件触发广泛信任表面缩减的信任表面某些特定环境下的自动触发可能失败。
🔒 安全警告:以下操作将关闭权限确认弹窗并将执行级别设为
full。请确保您的 OpenClaw 运行在受信任的网络环境中。
#🚀 配置步骤详解
#前置准备
使用 ssh 登录飞牛,然后切换用户到 trim.openclaw
sudo -i
usermod -s /bin/bash trim.openclaw
su trim.openclaw
#第一步:检查当前 Exec 配置
首先,我们需要查看当前的策略状态。
openclaw config get tools.exec
预期输出将显示当前的 host、security 级别及是否开启询问(ask)。
#第二步:显式设置完整权限 (核心步骤)
我们将强制指定主机为 gateway,关闭沙箱限制,并关闭执行确认弹窗。
1. 强制使用 Gateway Host
openclaw config set tools.exec.host gateway
说明:确保命令不降级到 sandbox 环境。
2. 设置安全级别为 Full
openclaw config set tools.exec.security full
说明:给予脚本和执行者最高信任权限。
3. 关闭执行询问确认
openclaw config set tools.exec.ask off
说明:避免每次执行时弹出确认框,提升自动化效率。
#第三步:确保节点 (Node) 已配对审批
如果您需要运行基于 Node 的触发逻辑(如 node 命令),必须完成配对审批流程。
1. 查看当前节点状态
openclaw nodes status
2. 重新配对或确认审批 如果状态显示未配对或未授权,请执行以下命令:
openclaw nodes pair
注意:如果是物理设备连接,请确保在 OpenClaw UI 界面中完成了“允许”或“审批”操作。
#第四步:执行系统体检
配置完成后,运行诊断工具验证权限恢复情况。
openclaw doctor --non-interactive
成功标志:输出中包含
OK或类似的健康状态提示,且无Permission Denied错误。失败标志:如果报告 exec 权限异常,请检查第二步命令是否执行成功(可再次运行
config get验证)。
#第五步:重启网关服务 (使配置生效)
部分核心权限配置需要在网关服务重载后才会完全应用。
openclaw gateway restart
提示:此操作可能会短暂中断正在进行的自动化任务,建议在业务低峰期执行。
#✅ 验证清单 (Checklist)
在关闭本教程前,请确认以下事项:
tools.exec.host已设置为gatewaytools.exec.security已设置为fulltools.exec.ask已设置为off所有必要 Node 节点状态为
Active/Pairedopenclaw doctor体检通过网关服务已完成重启
#❓ 常见问题 (FAQ)
Q1: 执行完配置后,某些旧脚本仍然报错 "Access Denied"
A: 请确认脚本中引用的具体路径是否在 Gateway 范围内。如果是自定义插件,可能需要重新加载插件缓存 (
openclaw plugins reload)。
Q2: 为什么默认行为变成了 auto?
A: v3.31 引入了“零信任”架构的雏形。在检测到不确定环境时(如 Docker 容器化部署),系统会自动降级至
sandbox以防止横向移动攻击。恢复为gateway意味着您手动承担了这部分安全风险。
Q3: 我想保留弹窗确认,但想允许访问 Gateway?
A: 可以执行以下命令组合:
openclaw config set tools.exec.host gateway openclaw config set tools.exec.ask on # 保持 security full 或调整为 high,根据您的安全策略决定
利用好模型解决问题方便多了。养养龙虾也许真得不错。
作者声明本文无利益相关,欢迎值友理性交流,和谐讨论~
