Workspace Files 是 OpenClaw 平台内置的文件系统操作技能，专为 AI 工作区沙箱环境设计，提供受控的目录浏览、文本文件读写及文件名模糊搜索能力。该技能通过强制路径隔离机制，将所有操作限制在 /home/cmart/.openclaw/workspace 目录内，有效阻断越界访问风险。
核心用法：
- 目录列表：
list-dir递归展示相对路径下的文件树结构 - 文本读取：
read-file获取 UTF-8 编码的文本内容，支持 Markdown、配置文档等格式 - 文本写入：
write-file创建或覆盖指定路径的文本文件，自动处理父目录创建 - 文件搜索：
search-files基于文件名模式匹配快速定位目标文件
显著优点：
1. 零配置沙箱：开箱即用，无需手动设置权限边界
2. 路径安全硬化：运行时强制校验相对路径，拒绝解析 .. 等逃逸序列
3. 轻量脚本封装：基于 Shell 脚本实现，便于审计与跨平台移植
4. AI 工作流原生：路径语义与 OpenClaw 项目结构深度对齐（如 01_AGENTS、07_OUTPUTS 标准目录）
潜在局限：
- 仅支持文本文件，二进制文件（图片、PDF、可执行程序）操作未定义
- 无内容加密或完整性校验机制
- 并发写入场景缺乏乐观锁或事务控制
- 搜索功能仅限文件名匹配，不支持全文检索
适合人群：
AI 代理开发者、自动化脚本编写者、需要在工作区内安全持久化配置与中间产物的技术用户。
常规风险：
- 恶意指令可通过
write-file覆盖关键配置文件（如SKILL.md），建议配合版本控制使用 - 长内容写入未做大小限制，存在内存膨胀隐患
- 沙箱边界依赖环境变量
{baseDir}正确配置，配置漂移可能导致意外行为