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

如何为 OpenClaw 设置文件系统 MCP

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

功能概览

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

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

先决条件

适合谁 / 不适合谁

适合谁

  • 需要让 OpenClaw 读取项目文件、文档或日志的人
  • 能明确限定工作目录，并愿意先从只读/小范围开始验证的人

不适合谁

  • 想把整个磁盘、主目录或密钥目录直接开放给 AI 的场景
  • 缺少备份、审计或权限边界的生产环境

基础设置

允许访问单个工作目录：

单目录配置 json 
{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "./workdir"]
  }
}

复制后下一步

先用配置检查器验证 Filesystem JSON，再回到 OpenClaw 运行验证提示词。

检查配置 提交配置审查 运行验证命令 浏览相关 MCP

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

多目录设置

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

多路径配置 json 
{
  "filesystem": {
    "command": "npx",
    "args": [
      "-y", "@modelcontextprotocol/server-filesystem",
      "./projects",
      "./documents",
      "/tmp/openclaw-scratch"
    ]
  }
}

路径规则

验证设置

复制配置后，先创建允许目录，再检查 OpenClaw 是否加载 MCP。

验证命令 bash 
mkdir -p workdir
openclaw status
  1. 运行 openclaw status — filesystem MCP 应显示为 "running"
  2. 测试：“列出当前目录中的文件”
  3. 测试：“读取 README.md 的内容”
  4. 测试：“创建一个名为 test.txt 的文件，内容为 'Hello World'”

常见错误

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

常见问题

为什么 OpenClaw 提示 Path not allowed？

请求路径不在配置允许的目录内。只把确实需要的项目目录加入 args，不要为了省事开放整个 home 或根目录。

如何修复 permission denied / EACCES？

这通常是操作系统权限、文件所有权、锁定目录或企业策略导致。请使用当前用户拥有的目录，或在 OpenClaw 外调整文件权限。

哪些路径边界更安全？

优先使用相对路径或专用工作目录，例如 ./openclaw-workspace。避免 /、C:/、~、~/.ssh、~/.aws 和生产密钥目录。

安全检查清单

⚠️ 重要安全提示

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

推荐设置

示例提示词

与其他 MCP 集成

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

相关 MCP