CoreOfficial★ 18.2k
文件系统操作 — 读写、搜索与文件管理
让 AI 代理直接操作本地文件系统。用自然语言读写、创建、移动、搜索、管理文件和目录——安全沙箱化,仅限允许路径。
为什么这个技能不可或缺
文件系统技能是 OpenClaw 生态中最基础的 MCP 服务器。没有它,你的代理就读不了配置文件、写不了报告、整理不了下载目录,也管不了项目结构。几乎所有自动化工作流都离不开它。
- 读取任意文件:解析配置文件、日志、CSV、Markdown 和代码。代理能理解文件内容,还能回答关于内容的问题。
- 写入与编辑:创建新文件、追加日志、更新配置值、撰写报告——全部通过对话完成。
- 目录操作:创建文件夹结构、移动/重命名文件、递归列出目录树。
- 搜索:按文件名、扩展名或内容在整个允许的目录树中查找文件。
安全模型
文件系统 MCP 采用严格白名单模式。你需要明确指定代理可以访问哪些目录——其余一律拦截。这样可以防止误访问系统文件、SSH 密钥或其他敏感数据。
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y", "@modelcontextprotocol/server-filesystem",
"/Users/you/Documents",
"/Users/you/Projects"
]
}
}args 中列出的路径是代理唯一能访问的目录。增减路径即可控制访问范围。
热门用法
- "读一下我项目的 README.md,从清晰度和 SEO 角度提改进建议。"
- "在项目目录里找出所有 .env 文件,检查有没有硬编码的 API 密钥。"
- "整理我的下载文件夹:PDF 移到 Documents/PDFs,图片移到 Pictures,超过 30 天的文件删掉。"
- "创建一个新项目结构,包含 src/、tests/、docs/ 文件夹和一个基本的 package.json。"
- "监控我的 ~/logs/ 文件夹,任何日志文件出现 'ERROR' 或 'CRITICAL' 就提醒我。"
可用工具
| 工具 | 说明 |
|---|---|
| read_file | 读取完整文件内容 |
| write_file | 创建或覆盖文件 |
| edit_file | 对现有文件进行精准编辑 |
| list_directory | 列出所有文件和子目录 |
| search_files | 按名称模式递归搜索 |
| move_file | 移动或重命名文件/目录 |
| get_file_info | 获取元数据(大小、修改时间、权限) |
</ Add to your README
If you use this skill in your project, add the badge to your GitHub README:
[](https://clawdbot.space/en/skills/mcp-filesystem?ref=badge&utm_source=mcp-filesystem&utm_medium=readme&utm_campaign=skill-page)