OpenClaw找不到文件主因是路径错误、配置未生成或权限不足;默认配置路径为Linux/macOS的~/.openclaw/openclaw.json、Windows的C:Users.openclawopenclaw.json、容器的/root/.openclaw;应优先执行openclaw config --show-path确认真实路径,再用openclaw init --force或openclaw setup生成配置,并检查tos字段是否设为"full"以解除沙盒限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw 找不到文件,多数不是程序坏了,而是它压根没去对的地方找——路径没配对、配置没生成、权限没放开,三者占了九成以上。
先确认文件到底存哪儿了
OpenClaw 默认不把配置文件扔在 Windows 的 AppData 或 macOS 的 Library 里,它在 Linux 风格路径下工作:
- Linux/macOS/WSL:优先查 ~/.openclaw/openclaw.json 或 ~/.config/openclaw/openclaw.json
- Windows 原生环境:查 C:Users\.openclawopenclaw.json
- 容器部署:默认挂载点通常是 /root/.openclaw 或 /app/config
别翻 Program Files 或 AppData 下的 openclaw 文件夹——那很可能是旧版残留或误装位置。直接在终端运行:
openclaw config --show-path
这条命令会真实输出当前 OpenClaw 正在读取的配置路径,比猜快十倍。
OpenClaw 技能 — 给定一个 GitHub 仓库 URL,自动解析出 owner/repo 名称,发现其中的 YAML/properties 配置文件及其配对的中文字段说明;在 `workspace/{repo}/` 目录下按同步日期(格式为 `YYYY-MM-DD`)创建时间戳子目录;写入 `.openclaw-config-state.json` 状态文件。每次用户提问前,先比对远程仓库当前 ref(如 `main` 或 `master`)的最新提交 SHA 与本地状态文件中记录的 SHA:
配置文件压根没生成?立刻初始化
首次安装后不运行初始化,openclaw.json 就不会自动出现。常见于 Docker 启动失败、跳过 setup 步骤、或用 --allow-unconfigured 临时绕过的情况。
- 进终端,执行:
openclaw init --force(强制重建基础结构) - 或者交互式配置:
openclaw setup(它会引导你填 API、路径、默认 agent 等) - 若在容器中操作,确保挂载卷已映射到
/root/.openclaw,否则配置一重启就丢
路径对了但还是“找不到”,检查权限模式
即使配置文件存在、路径正确,OpenClaw 也可能因权限锁死而无法访问任何本地文件——表现为打不开文件夹、读不了文档、浏览器启动失败,终端报 exec tool unavailable。
- 打开
openclaw.json,搜索 "tos" 字段 - 如果值是
"minimal",说明它被限制在沙盒里,什么系统操作都不能做 - 改成
"full",保存后重启 Gateway:openclaw gateway restart
改完记得验证:openclaw --list-providers 能返回列表,且 openclaw file search --name "test.md" 能扫出结果,才算真正打通路径。
跨环境特别注意(WSL / Docker / 双系统)
在 WSL 里执行 ls /mnt/c/Users/xxx/AppData/... 找不到文件?很正常——OpenClaw 在 WSL 中默认走 Linux 路径,不会主动读 Windows 的 AppData。
- 统一在 WSL 内完成安装和
openclaw setup,别混用 Windows 和 WSL 的二进制 - Docker 用户务必检查 volume 挂载:用
docker run -v openclaw-workspace:/root/.openclaw ...,而不是只挂/mnt/c/... - 双系统用户避免共用同一份
.openclaw目录——Linux 和 Windows 对隐藏文件、换行符、权限的处理不同,极易损坏配置









