aionclaw读取本地文件失败的根源是工作目录、配置路径与系统权限错位;需依次确认配置路径、校验绝对路径有效性、检查系统权限,并将tos设为"full"解除沙盒限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在 AionClaw 中执行读取本地文件操作(如解析 Excel、加载 Markdown、读取日志)时,界面或日志里弹出“文件不存在”“找不到指定路径”“open: no such file or directory”这类报错,问题通常不出在文件本身被删了,而是 AionClaw 根本没去你认为的位置找——它运行时的工作目录、配置中声明的路径、系统权限三者错位了。
第一步:确认 AionClaw 实际从哪开始找文件
别猜路径,直接问它。打开终端(Windows 用 PowerShell 或 CMD,macOS/Linux 用 Terminal),输入:
openclaw config --show-path
这条命令会输出 AionClaw 当前正在读取的主配置路径,比如 【C:\Users\Alice\.openclaw\openclaw.json】 或 【/Users/Alice/.openclaw/openclaw.json】。如果连这个路径都报错“command not found”,说明 AionClaw 的二进制未加入系统 PATH,得先用完整路径调用,例如 C:\Program Files\AionClaw\openclaw.exe config --show-path。
第二步:检查配置里写的文件路径是否真实有效
用上一步得到的真实配置路径,打开对应的 openclaw.json 文件。搜索关键词 "input_path"、"data_dir" 或你任务中明确指定的路径字段(如 "csv_source")。注意:这里填的必须是**绝对路径**,不能写 ./data/report.csv 或 ~/Downloads/list.xlsx —— AionClaw 不做 shell 层路径展开,遇到波浪号或点斜杠会原样传给系统,结果就是“找不到”。
把配置中写的路径复制出来,在文件管理器里手动粘贴访问。如果打不开,说明路径写错了;如果能打开,继续下一步。
第三步:验证 AionClaw 进程是否有权访问该路径
即使路径存在且你能手动打开,AionClaw 也可能因权限被拦。Windows 用户重点检查:该文件是否在 OneDrive/腾讯微云/百度网盘同步目录下?这些客户端常对文件加锁,AionClaw 读取时会返回“access denied”而非“not found”,但日志有时会模糊显示为“file not exist”。macOS 用户注意是否启用了“完全磁盘访问”权限:前往「系统设置 → 隐私与安全性 → 完全磁盘访问」,确认 AionClaw 或其底层 openclaw 进程已勾选。Linux 用户执行:ls -l /your/file/path,确认当前运行 AionClaw 的用户对该文件有 read 权限,而不是只有 root 可读。
第四步:强制重置沙盒限制,解除路径封锁
打开 openclaw.json,查找 "tos" 字段。如果值是 "minimal",AionClaw 就被锁死在极简沙盒里,连用户桌面都不能出,更别说读取自定义路径。必须改成:
"tos": "full"
保存后,重启 AionClaw 网关:openclaw gateway restart。这一步不做,前面所有路径校验都白搭——它压根不会尝试去你写的路径里找文件。











