OpenClaw MCP使用管理推荐指南

OpenClaw 集成 MCP 协议完整实操手册

概述

OpenClaw（前身为 Clawdbot）是一款开源的本地 AI 智能体框架，在 GitHub 上已累计获得超过 180K 星标。核心组件 MCP（Model Context Protocol）由 Anthropic 推出的开放标准协议，其核心理念清晰：通过统一接口，让 AI 模型无缝连接各类外部工具与数据源。换言之，配置 MCP 后，OpenClaw 便能直接操控本地文件系统、数据库、GitHub 仓库，以及 Google Drive、Slack 等 SaaS 服务。

打个比方，MCP 之于 OpenClaw 相当于“万能插槽”——过去每个工具需要单独编写插件（即 Skill），如今只要工具遵循 MCP 规范，即可即插即用。这套思路本质是将适配工作交给协议层处理，大幅削减重复开发精力。

环境准备

在正式配置 MCP 前，须确认本地环境满足以下前提条件：

• Node.js：推荐 v22 或更高版本，执行 node -v 确认版本
• npm：通常随 Node.js 一同安装，通过 npm -v 验证
• OpenClaw：确保已安装且可正常启动，运行 openclaw --version 检验
• mcporter（可选）：OpenClaw 用于连接和管理 MCP 服务器的辅助工具，后续章节详述

完成 OpenClaw 安装后，强烈建议先执行 openclaw doctor，该命令会全面检测系统健康状态，确认运行时环境无误，避免后续配置出现偏差。

连接 MCP 的三种方式

OpenClaw 提供多种途径接入 MCP 服务器，适配不同技术背景与使用场景。以下从推荐度最高的方式开始。

方式一：CLI 命令行添加（推荐）

官方首推此方式，操作极为简便。打开终端，执行以下格式的命令：

# 格式openclaw mcp add --transport <传输协议> <服务器名称> <启动命令># 示例：添加本地文件系统访问openclaw mcp add --transport stdio local-files npx -y @modelcontextprotocol/server-filesystem /Users/yourname/Documents

上述命令添加一个本地文件读取工具，其中 /Users/yourname/Documents 是授权 AI 访问的目录。注意：MCP 支持两种传输协议——stdio（本地进程通信，延迟极低）与 HTTP/SSE（远程服务器连接，支持多客户端）。选择取决于场景：本地开发首选 stdio，生产环境或团队协作则推荐 HTTP/SSE。

方式二：通过 mcporter 工具管理

mcporter 是 OpenClaw 生态中专门用于连接和管理 MCP 服务器的工具，安装方式如下：

npm install -g mcportermcporter --version

创建 mcporter 配置文件

mcporter 通过 mcporter.json 文件识别可用的 MCP 服务器。配置文件的具体路径因操作系统而异：

配置文件的示例内容如下：

{"mcpServers": {"my-tool": {"command": "npx","args": ["-y", "@some-mcp-package"],"env": {"API_KEY": "your_api_key_here"}}}}

在 openclaw.json 中启用 mcporter

接着编辑 ~/.openclaw/openclaw.json，在 skills 部分添加 mcporter 配置：

{"skills": {"entries": {"mcporter": {"enabled": true,"env": {"MCPORTER_CONFIG": "/Users/你的用户名/.mcporter/mcporter.json"}}}}}

注意：MCPORTER_CONFIG 环境变量必须填写绝对路径。若使用 Windows，路径中的反斜杠在 JSON 内需转义为 \\，否则解析会失败。

方式三：通过 openclaw-mcp-adapter 插件

openclaw-mcp-adapter 是一个插件，其作用是将 MCP 服务器提供的工具转换为 OpenClaw 的原生工具。安装方式如下：

openclaw plugins install mcp-adapter# 或从源码安装git clone https://github.com/androidStern/openclaw-mcp-adapter.gitopenclaw plugins install ./openclaw-mcp-adapter

安装完成后，在 ~/.openclaw/openclaw.json 中进行配置：

{"plugins": {"entries": {"openclaw-mcp-adapter": {"enabled": true,"config": {"servers": [{"name": "my-mcp-server","transport": "stdio","command": "npx","args": ["-y", "@some-mcp-package"]},{"name": "remote-server","transport": "http","url": "http://localhost:3000/mcp"}],"toolPrefix": true}}}}}

该插件的运行逻辑不复杂：网关启动后，会逐个连接所有已配置的 MCP 服务器，调用 listTools() 发现全部可用工具，然后将每个工具注册为 OpenClaw 的原生工具。当 AI 调用某一工具时，插件负责将调用请求转发至对应 MCP 服务器。若连接意外断开，下次工具调用时会自动重连，这一机制颇为贴心。

将 MCP 服务器转换为 OpenClaw Skill

社区还提供了一个便捷工具，一行命令即可将任何 HTTP MCP 服务器转化为完整的 OpenClaw Skill：

npx @filiksos/mcptoskill@latest https://mcp.example.com/mcp

该命令自动完成以下步骤：

• 连接目标 MCP 服务器，发现所有工具
• 生成包含描述和触发短语的 SKILL.md 文件
• 创建通过 curl 调用 MCP 服务器的 Shell 脚本
• 支持 JSON 与 SSE 两种响应格式
• 自动安装到 ~/.openclaw/skills/ 目录并在配置中启用

简言之，这条命令将原本手动的多个步骤完全自动化，对不熟悉配置文件结构的用户而言，可省去大量琐碎操作。

OpenClaw 作为 MCP 服务器

OpenClaw 不仅可作为客户端连接 MCP 服务器，其本身也能充当 MCP 服务器，供其他 AI 系统调用其能力。这一反向应用场景在实际工作中更为常见。

连接到 Claude Desktop

通过 Docker 部署 openclaw-mcp 桥接服务器：

services:mcp-bridge:image: ghcr.io/freema/openclaw-mcp:latestcontainer_name: openclaw-mcpports:- "3000:3000"environment:- OPENCLAW_URL=http://host.docker.internal:18789- OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}- AUTH_ENABLED=true- MCP_CLIENT_ID=openclaw- MCP_CLIENT_SECRET=${MCP_CLIENT_SECRET}- CORS_ORIGINS=https://claude.ai

然后在 Claude Desktop 的配置中添加上对应的 MCP 服务器信息：

{"mcpServers": {"openclaw": {"command": "npx","args": ["openclaw-mcp"]}}}

连接到 Cursor / Windsurf 等 IDE

在 IDE 配置文件中添加类似配置：

{"mcp.servers": {"openclaw": {"command": "node","args": ["/absolute/path/to/openclaw-mcp-server/dist/index.js"],"env": {"OPENCLAW_GATEWAY_TOKEN": "your-token-here"}}}}

这样一来，在 IDE 中就能直接调用 OpenClaw 的能力，打通 AI 开发工具与本地智能体框架的通道。

配置文件路径汇总

网关管理

OpenClaw 的 MCP 工具正常工作依赖网关（Gateway）进程。以下是常用管理命令：

# 启动网关openclaw gateway# 查看网关状态openclaw gateway status# 重启网关（重新加载所有 Skill 和配置）openclaw gateway restart# 检查系统健康状态openclaw doctor# 查看网关日志openclaw gateway logs

关键提醒：每次修改 openclaw.json 或 mcporter.json 后，必须重启 OpenClaw，新配置才会生效。此步骤常被忽略，导致配置半天却发现不生效。

验证与调试

验证 MCP 连接

配置完成后，可通过以下步骤确认 MCP 是否正确生效：

1. 状态查询：运行 openclaw status，检查 MCP 服务器是否处于 running 状态
2. 工具列表：运行 mcporter list，查看所有已连接的 MCP 服务器及其对应工具
3. 交互验证：在 OpenClaw 对话框中发送相关指令，例如“列出我授权目录下的前 5 个文件名”，观察 AI 能否正确调用工具
4. Skill 列表：运行 clawdbot skills list，查看所有已加载的 Skill 及其状态

常见问题排查

连接第三方 MCP 平台

MCP360

MCP360 提供超过 100 个生产级工具的统一访问端点，集成步骤清晰：

1. 在 mcp360.ai 注册账号并生成 API Token
2. 安装 MCPorter：npm install -g mcporter
3. 将 MCP360 注册为 MCP 服务器，提供端点 URL 和 Token
4. 运行 mcporter config list 确认注册成功
5. 运行 mcporter list 验证工具可正常访问

Latenode

Latenode 是可视化工作流引擎，支持超过 1000 个应用集成，集成方式与 MCP360 类似：

1. 在 Latenode 中创建 Scenario，添加 MCP Trigger 节点
2. 配置 Tool Name、Tool Description 和输入参数
3. 复制 Latenode 的 Server URL
4. 在 OpenClaw 中添加新的 MCP 服务器，粘贴该 URL
5. 若启用了认证，提供 API Key

ClawPad 桌面应用

ClawPad 是一款内嵌 OpenClaw 运行时的桌面应用，最大亮点是提供图形界面，可一键安装 MCP 扩展。通过 Extension Store，可直接搜索、安装并启动各类 MCP 服务器（如 Filesystem MCP、Git MCP、Gmail MCP 等），整个过程无需手动编辑配置文件。对于不习惯命令行的用户，这无疑是最友好的选择。

MCP 传输协议对比

选择何种协议，归根结底取决于实际需求：本地开发及安全性敏感的场景，优选题 stdio；需要跨设备共享或团队协作的生产环境，则 HTTP/SSE 才是正解。