什么是Filesystem Access (GreaterPeter)
Filesystem Access (GreaterPeter) 是一个专为开发环境设计的本地文件系统交互工具，它提供了安全、受控的文件读写与目录列表功能。该工具的核心设计原则是限制操作范围，默认仅允许在 OpenClaw workspace 工作区内进行文件访问，从而有效防止越权操作和误删重要数据。通过这种沙箱化的访问机制，开发者可以在不暴露系统完整权限的前提下，灵活地处理项目相关的文件资源。无论是查看日志文件、生成 Markdown 格式的技术报告，还是保存临时脚本或配置文件，该工具都能在不影响系统其他部分的情况下完成任务。其行为边界清晰，非常适合需要频繁与本地文件交互但又不希望承担安全风险的开发场景。
核心功能特点
- 支持在工作区目录内安全读取文本和二进制文件内容
- 提供对子目录和文件的递归列表功能，便于浏览项目结构
- 所有写入操作严格限定在 workspace 范围内，禁止越界访问
- 自动过滤敏感路径，避免意外修改系统或用户关键文件
适用场景
在日常开发流程中，Filesystem Access 特别适用于需要快速查看或编辑项目相关文件的场景。例如，当开发者遇到程序异常时，可以通过该工具直接读取应用生成的日志文件，定位错误发生的具体位置和时间点，而无需手动打开终端或使用外部编辑器。另一个典型用途是在自动化脚本中动态生成技术文档，比如将代码片段、运行结果输出到 Markdown 文件中，形成结构清晰的报告供团队审阅。此外，在配置管理方面，该工具可用于保存和更新项目所需的配置文件，确保每次部署前参数正确无误。由于其严格的路径限制，即使脚本存在逻辑漏洞，也不会波及工作区之外的其他文件或系统目录，极大提升了操作安全性。因此，它特别适合用于 CI/CD 流水线中的日志收集、测试结果归档以及轻量级配置管理等任务。