OpenClaw MCP 完整教程 — Model Context Protocol 配置与使用

什么是 MCP（Model Context Protocol）？

MCP（Model Context Protocol）是由 Anthropic 于 2024 年底推出的开放标准协议，旨在为AI模型提供一种统一的方式来连接外部工具、数据源和服务。你可以把 MCP 理解为"AI的USB接口" — 一个标准化的连接方式，让任何AI应用都能即插即用地使用各种工具。

在 MCP 出现之前，每个AI平台都有自己的工具集成方式 — Function Calling、Plugin、Tool Use 等，互不兼容。MCP 改变了这一局面：工具开发者只需要开发一个 MCP Server，就可以被所有支持 MCP 协议的AI平台使用，包括 Claude Desktop、Cursor、Windsurf、以及 OpenClaw。

MCP 协议的核心优势：

• 标准化 — 一次开发，多平台复用。不再为每个AI平台单独开发集成
• 安全隔离 — MCP Server 运行在独立进程中，与AI主进程完全隔离，即使工具崩溃也不影响AI
• 双向通信 — 不仅可以调用工具（Tools），还可以提供资源（Resources）和提示模板（Prompts）给AI
• 生态爆发 — Anthropic、GitHub、Slack 等公司纷纷发布官方 MCP Server，社区贡献更是数以千计
• 开源开放 — 协议规范完全开源，任何人都可以实现和扩展

MCP vs OpenClaw 传统Skills

OpenClaw 同时支持两种工具集成方式：传统Skills和 MCP Server。两者各有优势：

• 传统Skills — OpenClaw 原生的工具系统，运行在 OpenClaw 进程内部，延迟极低。ClawHub 上有 3,200+ 社区开发的Skills。适合简单的工具调用场景。
• MCP Server — 下一代标准，运行在独立进程中，隔离性更强。可以跨平台复用，生态增长迅速。适合复杂工具、需要安全隔离的场景。

结论：两者可以同时使用。OpenClaw 会自动整合所有可用工具（包括传统Skills和 MCP Server），AI会根据任务需要自动选择最合适的工具。你不需要在两者之间做选择 — 都启用即可。

MCP 在 OpenClaw 中的工作原理

当你在 OpenClaw 中添加 MCP Server 后，启动时会发生以下流程：

1. OpenClaw 启动 MCP Server 进程 — 根据配置文件中的命令（如 npx @anthropic/mcp-server-filesystem），OpenClaw 自动启动 MCP Server 作为子进程。
2. 协议握手 — OpenClaw 通过 stdio 或 SSE 与 MCP Server 建立连接，交换能力列表（支持哪些工具、资源、提示模板）。
3. 工具注册 — MCP Server 提供的所有工具会被注册到 OpenClaw 的工具列表中，AI可以像使用普通Skills一样调用它们。
4. 运行时调用 — 当AI决定使用某个MCP工具时，OpenClaw 将请求转发给对应的 MCP Server，等待结果返回后呈现给用户。

MCP Server 在 OpenClaw 中的配置位于 openclaw.json 的 tools 部分。以下是一个典型配置示例：

{
  "tools": {
    "mcp": [
      {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@anthropic/mcp-server-filesystem", "/data"],
        "env": {}
      },
      {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@anthropic/mcp-server-brave-search"],
        "env": {
          "BRAVE_API_KEY": "your-api-key"
        }
      }
    ]
  }
}

每个 MCP Server 条目包含：type（连接方式，通常为 stdio）、command（启动命令）、args（命令参数）和 env（环境变量，用于传递API密钥等）。

MCPorter — 一键安装 MCP Server

MCPorter 是一个便捷的 MCP Server 管理工具，可以帮你快速发现、安装和配置 MCP Server，省去手动编辑 JSON 配置的麻烦。

MCPorter 的主要功能：

• 搜索发现 — 浏览和搜索社区发布的 MCP Server，查看详细说明和评分
• 一键安装 — 选择目标平台（如 OpenClaw），自动生成配置并写入配置文件
• 依赖管理 — 自动处理 npm 包依赖，确保 MCP Server 正确安装
• 配置模板 — 提供常用 MCP Server 的推荐配置，减少试错成本

对于自建 OpenClaw 用户，MCPorter 大幅简化了 MCP Server 的安装流程。而使用 OpenClaw Launch 的用户则更加方便 — 在可视化界面中直接开关即可，无需使用 MCPorter。

常用 MCP Server 推荐

以下是最受欢迎和实用的 MCP Server，覆盖搜索、自动化、文件管理、数据库、代码和沟通等常见场景：

配置 MCP Server 步骤（自建用户）

如果你使用 Docker 自行部署 OpenClaw，按照以下步骤添加 MCP Server：

1. 选择 MCP Server — 在 MCP Server 官方仓库、MCPorter 或 npm 上找到你需要的 MCP Server。记下包名（如 @anthropic/mcp-server-filesystem）。
2. 编辑 openclaw.json — 打开 ~/.openclaw/openclaw.json 配置文件，在 tools.mcp 数组中添加新条目：

   {
     "type": "stdio",
     "command": "npx",
     "args": ["-y", "@anthropic/mcp-server-filesystem", "/allowed/path"],
     "env": {}
   }

   如果 MCP Server 需要 API 密钥，在 env 中添加。

3. 重启 OpenClaw — 保存配置后重启容器：docker restart openclaw。OpenClaw 会在启动时自动拉取 npm 包并启动 MCP Server 进程。
4. 验证安装 — 在对话中让AI使用新工具。例如添加 Filesystem 后，让AI"列出 /data 目录下的文件"。如果AI能正确返回结果，说明配置成功。

Tavily Search 配置详解

Tavily 是一个专为AI Agent设计的搜索引擎API，是目前最流行的 MCP 搜索方案之一。相比传统搜索API，Tavily 返回的结果更加结构化，更适合AI处理。

获取 Tavily API 密钥

1. 访问 tavily.com 注册账号
2. 在控制面板中找到你的 API Key
3. 免费套餐每月提供 1,000 次搜索，对个人使用足够

在 OpenClaw 中配置 Tavily

方式一：通过 MCP Server（推荐）

{
  "tools": {
    "mcp": [
      {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@anthropic/mcp-server-tavily"],
        "env": {
          "TAVILY_API_KEY": "tvly-your-api-key"
        }
      }
    ]
  }
}

方式二：通过 OpenClaw 内置搜索Skills

OpenClaw 也内置了 Tavily 搜索Skills，可以在 plugins.entries 中启用 web_search 并配置 Tavily 作为搜索提供商。两种方式效果相同，MCP 方式隔离性更好。

使用 OpenClaw Launch 的用户无需手动配置 — 在设置页面填入 Tavily API Key，搜索功能会自动启用。

OpenClaw Launch + MCP

OpenClaw Launch 提供完整的 MCP 托管支持，让你无需手动编辑配置文件即可使用 MCP Server：

• 可视化配置 — 在Web界面中浏览可用的 MCP Server，点击开关启用或禁用
• API 密钥管理 — 安全地存储和管理 MCP Server 所需的 API 密钥
• 自动安装 — 启用 MCP Server 后自动处理依赖安装和进程管理
• 热加载 — 大部分 MCP 配置变更无需重启实例，几秒钟后即可生效
• 预装热门服务器 — 常用 MCP Server（搜索、文件管理等）已预配置，一键启用即可

如果你不想处理服务器运维和 JSON 配置的复杂性，OpenClaw Launch 是最简单的 MCP 使用方式。

常见问题

MCP Server 是免费的吗？

MCP 协议本身是开源免费的，大多数 MCP Server 也是开源免费的。但部分 MCP Server 依赖第三方API（如 Tavily 搜索需要 API Key），这些API可能有付费计划。通常它们都提供免费额度，个人用户足够使用。

一个 OpenClaw 实例可以同时运行多少个 MCP Server？

没有硬性限制。实际上，每个 MCP Server 都是一个独立进程，会占用一定的内存（通常 50-200MB）。建议根据服务器配置启用 3-8 个 MCP Server。过多的 MCP Server 会增加内存消耗和AI的工具选择复杂度。

MCP Server 会影响AI的响应速度吗？

MCP Server 本身不会降低AI的响应速度。只有当AI决定调用某个MCP工具时，才会增加额外的延迟（取决于工具本身的执行时间）。例如，搜索工具通常需要 1-3 秒，文件操作几乎瞬间完成。未被调用的 MCP Server 不会产生任何性能影响。

可以使用自定义的 MCP Server 吗？

当然可以。任何遵循 MCP 协议的服务器都可以在 OpenClaw 中使用。你可以使用 TypeScript、Python 或任何语言开发自己的 MCP Server，然后添加到 OpenClaw 配置中。Anthropic 提供了 MCP SDK 帮助你快速开发。

MCP 和 Function Calling 有什么区别？

Function Calling 是各AI平台（OpenAI、Anthropic 等）内置的工具调用机制，每个平台实现不同。MCP 是一个跨平台的标准协议，在 Function Calling 之上提供了统一的工具发现、调用和管理接口。简单来说：Function Calling 是底层能力，MCP 是上层标准。

如何排查 MCP Server 启动失败？

常见问题及解决方法：检查 npm 包名是否正确；确认 Node.js 版本 >= 18；检查环境变量（API Key 等）是否正确设置；查看 OpenClaw 日志中的错误信息。在 OpenClaw Launch 上，MCP Server 的状态和日志可以在实例详情页查看。