权限配置 · 浏览器与文件篇

简洁实用的权限设置指南，重要必看

🌐 浏览器权限控制

{  "browser": {    // 基础开关 ----------    "enabled":true,      // true=启用 | false=禁用    // 安全策略 ----------    "ssrfPolicy": {      // 内网访问权限      "dangerouslyAllowPrivateNetwork":false,      // false: 禁止访问内网(127.0.0.1, 192.168.x.x)      // true: 允许访问内网(⚠️ 仅开发调试用)      // 域名白名单      "hostnameAllowlist": ["*.example.com", "api.github.com"]      // []              = 允许所有域名      // ["*.com"]       = 只允许.com域名      // ["localhost"]   = 只允许本地      // ["*"]           = 允许所有(同空数组)    },    // 显示模式 ----------    "headless":true,    // true : 无头模式(后台静默运行)    // false: 显示浏览器界面(方便调试)    // 浏览器配置 ----------    "profiles": {      "openclaw": { "cdpPort": 18800 },     // 隔离浏览器      "chrome": { "cdpUrl": "http://127.0.0.1:18792" }  // 控制现有Chrome    }  }}

📁 文件权限控制

{  "tools": {    // 权限模板 ----------    "profile": "minimal",    // minimal : 只读文件(最安全)    // coding  : 读写编辑文件(开发用)    // full    : 无限制(⚠️ 风险高)    // 权限范围 ----------    "allow": ["group:fs"],     // 授予文件系统权限    // "group:fs" = 文件系统权限组    "deny": [      "filesystem:delete",           // 禁止删除文件      "filesystem:write_to_system_dir"  // 禁止写入系统目录    ],    // 可选的禁止项:    // - filesystem:delete              - 删除文件    // - filesystem:write_to_system_dir - 写入系统目录    // - filesystem:read_from_system_dir - 读取系统目录    // 路径控制 ----------    "fileSystem": {      // 白名单(只允许访问这些路径)      "allowedPaths": [        "/home/ubuntu/projects",  // 项目目录        "/tmp/openclaw"           // 临时目录      ],      // [] = 不限制路径(基于profile)      // 黑名单(禁止访问敏感路径)      "blockedPaths": [        "/home/ubuntu/.ssh",      // SSH密钥        "/etc/passwd",            // 系统密码文件        "/home/ubuntu/.openclaw/secrets"  // 密钥目录      ],      // [] = 不屏蔽任何路径      // 大小限制 ----------      "maxFileSize": 10485760      // 单位: 字节      // 10485760 = 10MB      // 0 = 不限制大小    }  }}

⚙️ 如何修改配置

配置文件位置：

 打开主页面--配置--Authentication--改成raw模式

~/.openclaw/openclaw.json

修改后重启生效：

openclaw gateway restart

📝 常用配置速查

小贴士：如果不确定怎么设置，先用安全模式，需要更多权限再逐步放开。

如有问题，欢迎加群交流～