入门指南 · 配置优先

OpenClaw MCP 快速入门：先跑通，再加权限

这页的目标不是把所有 MCP 都一次性装完，而是用最小配置确认 OpenClaw 能启动 MCP server、能访问一个受限目录，并知道卡住时该检查哪里。

Last reviewed: 2026-04. 生产环境使用前，请再对照最新 OpenClaw 官方文档确认。

适合谁 / 不适合谁

适合

  • 第一次配置 OpenClaw + MCP
  • 想安全开放一个本地项目文件夹
  • 遇到 invalid JSON、server failed to start、权限报错

不适合

  • 想部署企业级权限系统
  • 想绕过 OAuth 或平台安全策略
  • 还不清楚哪些文件可以让 AI 访问

Before you paste this config

先创建一个专门的工作目录，不要直接开放 home、根目录、桌面全量文件或包含密钥的目录。配置里不要写 API key、token、cookie 或私钥。

最小可用配置

先只开 filesystem，一个相对目录就够。下面的配置会把访问范围限制在当前运行目录下的 openclaw-workspace。

最小 filesystem 配置 json 
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./openclaw-workspace"]
    }
  }
}

更安全的配置方式

把真实项目和临时输出拆开，避免 AI 把草稿、下载文件和代码混在一起。最危险的权限是开放根目录、home 目录、SSH/AWS 凭据目录或任何生产密钥目录。

更安全的 filesystem 配置 json 
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "./openclaw-workspace",
        "./openclaw-scratch"
      ]
    }
  }
}

验证命令

先创建目录，再检查 MCP server 是否能被 OpenClaw 看到。

验证 MCP server bash 
mkdir -p openclaw-workspace openclaw-scratch
openclaw status

Expected result: OpenClaw 应能显示 filesystem server 已加载；随后你可以让它列出 openclaw-workspace 目录。如果它要求访问其他路径，应被拒绝。

⚡️ 一键配置

Magic Setup - 零配置安装

复制这段指令粘贴给 openclaw，30 秒自动安装 4 个核心 MCP 服务器。

magic-setup.txt 
@OpenClaw（openclaw，原 OpenClaw）请帮我快速配置 MCP 环境，并在安装过程中使用中文回复我。

请按以下步骤操作：

1. [检查环境]: 验证是否已安装 Node.js (v18+)。如果缺失，请先指导我安装。

2. [安装核心 MCP 服务器]: 使用 npx 安装这些无需额外配置的核心服务器：
   • @modelcontextprotocol/server-filesystem（文件访问，限定到我的桌面/文档）
   • @modelcontextprotocol/server-memory（长期记忆）
   • @modelcontextprotocol/server-fetch（网页抓取）
   • @modelcontextprotocol/server-sequential-thinking（深度推理）

3. [验证安装]: 安装完成后，请测试一下：读取我的桌面文件列表。

请逐步执行。如果遇到"command not found"错误，请告诉我。
✅ 无需配置
⏱️ 30 秒安装
🎯 覆盖 80% 场景
✓ Verified for Claude 3.5 Sonnet
❓ 安装失败？ 🔑 需要更多 MCP？

常见错误

command not found

症状：OpenClaw 或 npx 找不到命令。原因：OpenClaw/Node 没装好，或 PATH 没加载。修复：重开终端，确认 node -v、npx -v 和 openclaw status 可运行。连续失败时提交配置审查。

invalid JSON

症状：启动前直接报 JSON parse error。原因：逗号、引号、转义字符或注释写错。修复：先用 JSON 校验器检查，只保留 mcpServers 片段。看不出位置时提交审查。

server failed to start

症状：filesystem server 不运行。原因：npx 下载失败、包名写错或网络被拦。修复：单独运行验证命令，确认 npm registry 可用。

path not allowed

症状：读文件时被拒绝。原因：请求路径不在 args 允许列表内。修复：只把需要的项目目录加入 args，不要直接开放 home/root。

When to ask for review

如果你已经删除敏感信息，但仍然无法判断是 JSON、路径、Node/npm、还是 OpenClaw 配置位置的问题，就把配置片段和报错发来审查。

下一步

跑通最小配置后，再去 Top 10 列表选择 GitHub、搜索或浏览器类 MCP。 Top 10 列表.