aionclaw通过路径白名单、沙箱绑定和用户隔离三重机制实现严格权限控制:仅允许访问显式授权的业务目录,完全阻断对私人路径的读写。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让AionClaw在处理工作文件时,完全无法触达你的私人资料(如 ~/Documents/私密笔记、~/Pictures/家庭照片、~/Downloads/未归档资料),又不破坏它对合同、报表、邮件等业务目录的正常读写权限。这不能靠“让它小心点”,而必须通过路径白名单+沙箱绑定+用户账户隔离三重硬约束实现。
第一步:锁定AionClaw可访问的唯一根目录
编辑 ~/.aionclaw/permissions.json,删除所有通配路径(特别是 "/" 或 "/home/user" 这类宽泛条目)。只保留明确授权的业务路径,例如:
{"read": ["/home/user/work/contracts", "/home/user/work/reports"], "write": ["/home/user/work/export", "/tmp/aionclaw_cache"]}
【必须删除默认的 "/" 条目,否则白名单形同虚设】
第二步:强制启用沙箱模式并绑定独立用户
在终端执行:
sudo useradd -m -s /bin/bash aionclaw-sandbox
sudo chown -R aionclaw-sandbox:aionclaw-sandbox /home/user/work/
然后修改 ~/.aionclaw/config.yaml,将 sandbox.enabled 设为 true,并设置 sandbox.user: "aionclaw-sandbox"
这一步让AionClaw的所有操作都以 aionclaw-sandbox 用户身份运行,它连你主目录的执行权限都没有,更别说读取 ~/Private 或 ~/.ssh 了。
第三步:用符号链接把工作区“搬进”沙箱视野
不要把私人资料挪到工作目录下,而是反向操作:在 /home/aionclaw-sandbox/ 下创建指向业务目录的软链:
sudo -u aionclaw-sandbox ln -sf /home/user/work/contracts /home/aionclaw-sandbox/work/contracts
这样AionClaw看到的只是 /home/aionclaw-sandbox/work/,而这个路径下除了你主动挂进去的业务目录,什么都没有。它根本不知道你主目录里还有个 ~/Downloads。
第四步:验证越权访问是否被拦截
① 启动AionClaw后,在Web UI中输入指令:“列出 ~/Documents 目录下的所有文件”
② 立即检查 ~/.aionclaw/logs/security.log,确认出现 “DENIED filesystem access to /home/user/Documents” 记录
③ 执行 openclaw monitor --list-permissions,核对输出中 read 权限仅包含你手动添加的那几个 work 子路径
如果第②步没记录,或第③步显示权限范围过大,说明白名单未生效,需退回第一步重新检查 permissions.json 格式与缩进。











