需启用并配置openclaw的fs skill：一、用openclaw skills enable fs启用；二、在openclaw.json中配置fs.whitelist绝对路径白名单；三、自然语言或cli（如openclaw fs ls）调用操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功部署OpenClaw并希望它能直接读取、写入或管理本地文件（如打开文档、整理桌面、生成报告、批量重命名等），则需启用并正确配置其文件系统Skills。这些Skills并非默认激活，必须显式启用、授权路径权限，并在配置中声明可操作范围。以下是具体操作步骤：
一、确认文件系统Skills已内置并启用
OpenClaw自v2026.3起默认集成fs（File System）Skill，但处于禁用状态，以保障系统安全。启用前需验证该Skill是否存在且未被屏蔽。
1、打开终端或PowerShell，进入OpenClaw运行目录（通常为~/.openclaw或部署助手指定路径）。
2、执行命令查看已注册Skills列表：openclaw skills list。
3、在输出中查找fs条目，确认其状态为disabled或enabled。若显示not found，说明当前版本未加载该模块，需升级至openclaw@latest。
4、若状态为disabled，执行启用命令：openclaw skills enable fs。
二、配置文件系统访问白名单路径
为防止越权操作，OpenClaw强制要求通过fs.whitelist显式声明允许读写的绝对路径。未列入白名单的路径将被静默拒绝，且不抛出错误提示。
1、编辑主配置文件：~/.openclaw/openclaw.json。
2、在"skills"对象下添加或修改"fs"子项，结构如下：
3、确保"whitelist"为数组格式，每个路径必须是完整绝对路径，结尾不带斜杠：
"/Users/yourname/Documents", "/home/yourname/Downloads", "D:\Projects\openclaw-data"
4、保存文件后，重启OpenClaw服务使配置生效（执行openclaw restart或手动终止再运行openclaw start）。
三、在自然语言指令中调用文件系统操作
文件系统Skills支持标准POSIX语义指令，无需编写代码。所有操作均基于白名单路径内相对位置解析，且自动处理路径拼接与编码。
使用 Claude Code 从零搭建完整的 OpenClaw 个人 AI 助手，包括AWS 资源准备、OpenClaw 安装、Telegram 机器人创建、API 配置、Google Workspace 集成、安全加固及全部高级功能。交给 Claude Code 即可自动完成。
1、读取文本文件内容：“请读取Documents目录下的report.md内容并总结前三行”。
2、写入新文件：“在Downloads文件夹中创建一个名为notes.txt的文件，内容为‘今日会议要点：1. 项目排期；2. 模型切换测试’”。
3、列出目录文件：“列出D盘Projects文件夹下所有以.py结尾的文件”。
4、移动与重命名：“把Desktop上的‘旧配置备份.zip’移到Documents/Archive目录，并重命名为‘config-20260319.zip’”。
四、使用CLI命令行直接触发文件操作
除自然语言交互外，OpenClaw提供openclaw fs子命令集，适用于脚本集成或调试场景，绕过NLU解析环节，响应更确定。
1、查看白名单内某路径文件列表：openclaw fs ls ~/Documents。
2、读取指定文件（返回原始内容，无摘要）：openclaw fs cat ~/Downloads/config.json。
3、向文件追加一行内容：openclaw fs append ~/Notes/todo.md "- [ ] 部署飞书插件"。
4、复制文件（仅限白名单内路径之间）：openclaw fs cp ~/Desktop/resume.pdf ~/Documents/Archive/。
五、处理中文路径与特殊字符的注意事项
Windows与macOS对Unicode路径的支持存在差异，OpenClaw默认采用UTF-8编码解析路径。当遇到中文路径乱码或“文件不存在”报错时，需检查环境编码一致性。
1、Windows用户请确保系统区域设置中“Beta版：使用Unicode UTF-8提供全球语言支持”已勾选（控制面板→区域→管理→更改系统区域设置）。
2、macOS用户需确认终端Shell启动时未覆盖LANG变量，执行echo $LANG应返回类似zh_CN.UTF-8或en_US.UTF-8。
3、若仍失败，可临时改用Base64编码路径参数：openclaw fs cat "base64:5byg5LiJ57O7LmRvY3g="（对应“我的文档.docx”）。编码值可通过在线工具或echo -n "我的文档.docx" | base64生成。
