MCP 配置指南 · #1 核心必备

如何为 OpenClaw 设置文件系统 MCP

最基础的 MCP：让 OpenClaw 安全地读取、写入和管理文件——严格限制在您选择的目录范围内。

功能概览

文件系统 MCP 支持以下功能：

读取文件和目录列表
写入和创建新文件
移动、复制和删除文件
按名称或内容搜索文件

安全性： 访问权限严格限制在您指定的路径内。OpenClaw 无法访问这些目录之外的内容。

先决条件

已安装并运行 OpenClaw
Node.js 18+

基础设置

允许访问单个工作目录：

单目录配置 json

{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "./workdir"]
  }
}

将 ./workdir 替换为您的项目文件夹路径。

多目录设置

授予多个位置的访问权限：

多路径配置 json

{
  "filesystem": {
    "command": "npx",
    "args": [
      "-y", "@modelcontextprotocol/server-filesystem",
      "./projects",
      "./documents",
      "/tmp/openclaw-scratch"
    ]
  }
}

路径规则

相对路径 基于 OpenClaw 的工作目录解析
绝对路径 按预期工作（如 /home/user/docs）
~ 扩展 可能不起作用——请使用完整路径
Windows： 使用正斜杠或转义的反斜杠（如 C:/Users/...）

验证设置

运行 openclaw status — filesystem MCP 应显示为 "running"
测试：“列出当前目录中的文件”
测试：“读取 README.md 的内容”
测试：“创建一个名为 test.txt 的文件，内容为 'Hello World'”

常见错误

错误	原因	修复方法
`Path not allowed`	请求的路径在允许的目录之外	将路径添加到配置参数中，或使用允许的路径
`ENOENT`	文件或目录不存在	检查路径拼写，创建父目录
`EACCES`	操作系统级别的权限被拒绝	检查文件权限，使用适当的用户运行 OpenClaw
`Directory not found`	配置路径不存在	先创建目录，或修复路径

安全最佳实践

⚠️ 重要安全提示

切勿允许 / 或 C:\ — 始终限定在特定目录
避免使用 ~（主目录），除非您信任所有操作
使用专用的临时目录存放 AI 生成的文件
定期审计 OpenClaw 写入的内容

示例提示词

“读取 src/main.ts 并解释它的作用”
“创建一个名为 notes.md 的新文件，记录今天的会议纪要”
“查找项目中包含 'TODO' 的所有文件”
“将 old-config.json 重命名为 backup-config.json”
“删除 logs 目录中的所有 .log 文件”

与其他 MCP 集成

文件系统 MCP 搭配以下工具效果更佳：

GitHub MCP — 克隆仓库，然后在本地编辑
顺序思考 — 在修改文件前进行推理
Puppeteer — 将网页截图保存到磁盘