OpenClaw工具调用返回Permission Denied

症状

• 执行read/write/exec等工具时返回Permission Denied
• 无法读取或修改配置文件
• 无法执行系统命令

快速诊断（30秒内）

检查1：当前用户权限

# 查看当前用户
whoami

# 查看文件权限
ls -la ~/.openclaw/workspace/

检查2：Workspace所有权

# 检查Workspace所属用户
ls -ld ~/.openclaw/workspace

# 检查Agent工作目录
pwd

检查3：沙盒配置

# 查看沙盒配置
cat ~/.openclaw/openclaw.json | grep -A 3 'sandbox'

问题确认

• 如果文件属主不是当前用户，需要调整权限
• 如果Workspace路径错误，需要修正配置
• 如果沙盒启用且限制严格，需要调整策略

解决方案

方案1：修正文件权限（推荐，2分钟）

# 1. 修正Workspace所有权
sudo chown -R $(whoami) ~/.openclaw/workspace

# 2. 修正权限
chmod -R u+rw ~/.openclaw/workspace

# 3. 验证
ls -la ~/.openclaw/workspace/

方案2：修正Workspace配置（3分钟）

编辑~/.openclaw/openclaw.json：

{
  "agents": {
    "defaults": {
      "workspace": "/path/to/correct/workspace"
    }
  }
}

重启Gateway：

openclaw gateway restart

方案3：禁用沙盒限制（紧急，1分钟）

编辑~/.openclaw/openclaw.json：

{
  "agents": {
    "defaults": {
      "sandbox": false
    }
  }
}

重启生效：

openclaw gateway restart

预防措施

配置项

• 确保Workspace属主与Agent运行用户一致
• 定期检查文件权限
• 谨慎启用沙盒，评估权限需求

最佳实践

• 使用ls -la检查权限后再操作
• 重要文件操作前备份
• 避免在系统目录直接操作

相关错误

• OpenClaw Agent重启后丢失上下文
• OpenClaw文件读取返回ENOENT
• OpenClaw代码执行超时

参考资料

• OpenClaw官方文档 - 工具使用
• OpenClaw官方文档 - 沙盒配置
• OpenClaw GitHub - 权限问题