Skills-Safe编辑部判断可以安装，但必须配置访问路径白名单
Filesystem 技能比 bash 安全很多，但仍然有文件系统写权限。最常见的问题是没有配置路径限制，导致 AI 读取或修改了你本来不打算动的文件。10 分钟配好白名单，可以让这个技能用起来安心很多。
Filesystem：读写本地文件，安全边界要划清
让 AI 直接读写你的本地文件——实用，但你要知道它能访问哪些地方
开发效率难度：进阶
先说结论
Filesystem 技能比 bash 安全很多，但仍然有文件系统写权限。最常见的问题是没有配置路径限制，导致 AI 读取或修改了你本来不打算动的文件。10 分钟配好白名单，可以让这个技能用起来安心很多。
你是不是目标用户
✓ 适合谁
- •需要 AI 读取本地文档、配置文件、日志来辅助分析的开发者
- •写作、整理笔记时希望AI直接操作文件的人（写入、重命名、整理目录结构）
- •数据处理场景：让 AI 读取 CSV/JSON，处理后写回本地
- •知道自己想开放哪些目录、愿意花几分钟配置白名单的人
✗ 不适合谁
- •期望"让 AI 可以访问我所有文件"而不设任何限制的人
- •本地有重要的未备份文件的情况下（先备份再装）
- •用于处理含密码、API Key、个人敏感信息文件的场景
- •完全不了解自己机器目录结构的人（AI 操作了你也不知道动了哪里）
最值得先试的场景
风险提示
文件系统写入Shell 执行文件操作影响项目结构Shell 执行需审查命令
- **文件系统写入**：可在白名单路径内创建、修改、删除文件
- **敏感信息暴露**：如果白名单路径包含含密钥的文件，AI 可能读取然后泄露在对话中
- **无法撤销的覆盖**：没有内置版本控制，覆盖即永久（除非你有备份）
- **路径混乱导致误操作**：在根目录下操作风险远高于在指定工作目录下
- 配置白名单前不要开始使用
- 对重要目录设置 `readOnly: true`
- 写操作前养成让 AI 先 preview 改动内容的习惯
该技能静态分析未发现明显高风险信号。 权限标签：文件系统写入、Shell 执行。 开发工具类技能可能直接修改代码文件或执行构建命令，使用前确认权限范围。
文件操作影响项目结构Shell 执行需审查命令
装之前先问自己
如果你决定装
### 安装
```bash
npx clawhub@latest install filesystem
```
### 关键配置：路径白名单
安装后**第一件事**是配置允许访问的目录：
```json
{
"filesystem": {
"allowedPaths": [
"~/Documents/work-notes",
"~/projects/my-app/docs"
],
"readOnly": false
}
}
```
从最小范围开始，按需扩展。
### 第一次正确使用
1. "读取 `~/Documents/work-notes/today.md` 的内容" — 确认读取正常
2. "在 `~/Documents/work-notes/` 创建 `test.md`，内容是 hello" — 确认写入正常
3. 删除 test.md，然后再决定是否扩展范围
如果你现在还不适合它
- →**[Bash](/guides/bash)**：需要更复杂的文件操作（批量处理、权限修改）时用 bash
- →**[GitHub](/guides/github)**：如果目标文件在 Git 仓库中，用 GitHub MCP 更有版本保护
同类技能推荐
同属「开发效率」分类的其他技能：