这篇解决什么：工作区文件夹，不是模型 API
搜「OpeClaw 本地文件」「工作区文件夹」的人，通常已经能打开客户端，但卡在：怎么把本机目录接进来、权限弹窗点完仍读不到、路径看起来对却提示无权访问。
本文只讲本地文件夹 / 工作区接入、系统与应用内权限、路径核对，以及读不到文件时的排查顺序。不写 Ollama / LM Studio 的 Base URL，也不讲 Skills 包怎么装——那些词各有专文。
具体菜单名、按钮文案与授权粒度，以你当前版本设置页与内置权限对话框为准；本文不编造未公开的「一键挂载全盘」能力。
接入前：先定工作区，再谈授权
把「工作区」想成你允许 OpeClaw 读写的边界目录，而不是随便塞一个桌面快捷方式。路径选错，后面所有「读不到文件」都会像软件坏了。
固定顺序：在本机先确认目标文件夹真实存在且你有读权限 → 打开 OpeClaw 里与工作区 / 本地文件夹 / 项目目录相关的设置入口（名称因版本而异）→ 用系统文件选择器选中该目录 → 出现内置权限对话框时逐项阅读后再允许。
发布状态与安装包来源先看下载页；半截更新或错版客户端会导致设置入口缺失或授权状态错乱，那时应先核版本，而不是反复重选同一路径。
- 目标目录在访达 / 资源管理器里能直接打开。
- 避免先授权到「下载」整层，再指望它自动找到嵌套很深的项目。
- 公司机若禁止应用访问用户文档，先问 IT，不要关杀毒凑合。
权限对话框怎么点：范围宁小勿大
OpeClaw 接入本地文件夹时，常见会弹出应用内授权提示，或联动系统级文件夹访问（macOS 隐私与安全性、Windows 受控文件夹访问等）。提示写什么，就按当前对话框操作；不要假设存在未展示的隐藏开关。
建议：只授权当前项目目录；需要读写子文件夹时再扩大一层；涉及密钥、凭证、生产配置的目录单独隔离，不要放进默认可写工作区。点「一律允许」或「完整磁盘」类选项前，确认版本说明或对话框原文确实要求，并能事后在系统设置里撤销。
若对话框一闪而过、设置里看不到已授权路径，先完全退出客户端再开，重新触发选择文件夹流程。仍空白时，对照更新失败文排查是否配置残留，而不是立刻重装整机。
路径核对：读不到文件时先查这几项
第一，路径是否被移动、重命名或同步盘「仅联机」占位——工作区仍指向旧绝对路径时，界面可能显示旧名，实际已 404。第二，大小写、空格、中文路径在部分脚本步骤里会放大差异，以文件选择器回填的路径为准，少手抄。
第三，符号链接 / 快捷方式：选中的是链接还是真实目录，以系统实际解析为准；链接断裂时表现为「有入口、无内容」。第四，文件被其他程序独占（Office、同步客户端）时，读取会失败，先关占用再试。
最小验证：在已授权目录下放一个无敏感内容的短文本，让工作流只读这一份。读得通，再扩到真实项目；一次指向整盘会让失败原因无法定位。
和 Skills / 本地模型 / 更新问题怎么分流
目录已授权、短文本能读，但扩展能力装不上或启用无效果 → 转 Skills 安装与启用人文，本文不再重复来源核对。
文件能读，模型却连不上、要配 Ollama / LM Studio → 转本地大模型配置文；401/429 走 API Key 文。不要在工作区设置里改 Base URL。
选文件夹入口消失、授权状态在更新后全部清空、或客户端半截更新 → 先看更新失败与干净重装；换机重装要带走 Provider 与配置目录 → 配置备份与换机迁移。场景边界与使用范围 → FAQ。发布包入口始终回下载页。
本地文件接入对照表（不新增结论）
下表只归纳上文顺序；不改变「先定工作区再授权」「不编造未公开挂载能力」，以及模型 API 与 Skills 仍走专文的分流。
| 现象 | 优先动作 | 常见误操作 |
|---|---|---|
| 找不到接入入口 | 对照当前版本设置页与下载页 | 用聊天群「万能挂载脚本」 |
| 权限弹窗后仍读不到 | 重选目录并核系统隐私权限 | 直接给完整磁盘后不再核对路径 |
| 路径显示在但内容空 | 查移动/同步占位/符号链接 | 以为是模型坏了去改 API Key |
| 只有某个 Skills 读失败 | 转 Skills 文查额外权限 | 在工作区里反复删建同一文件夹 |
| 更新后授权全丢 | 更新失败排查 → 再走接入流程 | 从不明镜像重装指望恢复路径 |
菜单名、对话框文案与可授权范围以当前客户端为准；本文不承诺未公开能力或人工客服时效。
本地文件夹与工作区常见问题
OpeClaw 读不到本地文件，是不是模型 API 配错了？
多数情况下不是。读不到文件优先查工作区路径是否仍存在、权限对话框是否已授权、以及目标是否在允许范围内。模型连不上或 401/429 另看本地大模型与 API Key 文。
授权本地文件夹会不会等于开放整块磁盘？
不应默认等于。按内置权限对话框逐项确认，只给当前任务需要的目录；菜单与授权范围以当前版本入口为准，不要为省事点「一律允许」后却无法回溯。
Skills 装好了但仍然读不到项目文件，先查哪边？
先确认工作区文件夹本身已选中且系统权限已放行；再查该 Skills 是否额外要求路径或脚本权限。Skills 安装与来源核对见 Skills 文，本文只管目录与读文件。
更新客户端后突然提示无法访问原文件夹怎么办？
先对照关于页版本与下载页发布状态，确认不是半截更新留下的异常配置；再重新走一遍文件夹选择与权限对话框。版本通道问题见更新失败排查，不要先换不明安装包。
换机后配置在，但工作区路径全失效怎么办？
配置目录通常只保存路径引用。新机器要重新选择真实文件夹并完成权限对话框；整份配置怎么备份迁移见配置备份专文，本文只管目录与读文件。