OpenClaw如何使用MCP?OpenClaw使用MCP教程分享

要使用OpenClaw的MCP(Model Context Protocol) 功能,核心是通过mcporter工具(OpenClaw官方内置Skill)实现MCP Server的适配与调用,从而让OpenClaw连接外部服务(如搜索、地图、数据库等)。以下是完整实战流程,结合2026年最新资料整理:

一、前置准备:安装OpenClaw与依赖

首先确保OpenClaw已正确安装,且环境满足要求(以Windows系统为例):

验证安装:

openclaw --version

显示2026.x.x及以上版本即为成功

二、核心步骤:安装与配置mcporter

mcporter是OpenClaw官方提供的MCP协议适配工具,用于将第三方MCP Server转换为OpenClaw可识别的Skill。

1、安装mcporter:

通过OpenClaw的clawhub命令一键安装:

clawhub install mcporter

安装成功后,mcporter会被放置在~/.openclaw/workspace/skills/mcporter目录下。

2、配置MCP Server:

以高德地图MCP(常用生活服务)为例,配置步骤如下:

  • 获取高德API Key:
    登录高德开放平台,创建应用并申请Web服务API Key(需实名认证)。

  • 添加MCP Server配置:
    执行以下命令,将高德MCP Server添加到mcporter:

mcporter config add amap-maps \
  --url "https://mcp.amap.com/mcp?key=你的高德API Key"
  • 验证配置:
    执行mcporter list,若显示amap-maps(状态为healthy),则配置成功。

三、实战:在OpenClaw中调用MCP服务

配置完成后,可通过自然语言指令让OpenClaw调用MCP服务(以“查询杭州天气并规划路线”为例):

1、启动OpenClaw网关:

openclaw gateway start

2、生成访问令牌(首次使用需执行):

openclaw token generate

令牌会保存在~/.openclaw/openclaw.json中,后续访问Web控制台时需使用(如http://localhost:18789/?token=你的Token)。

3、调用MCP服务:

在OpenClaw的TUI(终端界面) 或Web控制台中输入指令:

帮我查询杭州今天的天气,并规划从杭州东站到西湖景区的公交路线。

OpenClaw会自动通过mcporter调用高德MCP Server的weather(天气查询)和route(路线规划)工具,返回结果如下:

  • 天气:杭州今日多云,气温18-25℃,微风;
  • 路线:从杭州东站乘坐地铁1号线(湘湖方向)至龙翔桥站,换乘公交7路至西湖景区,全程约40分钟。

四、进阶:配置其他MCP Server(如MiniMax搜索)

除了高德地图,还可配置MiniMax搜索MCP(适合需要联网搜索的场景),步骤如下:

1、安装MiniMax MCP Server:

npm i -g minimax-coding-plan-mcp

2、添加MCP Server配置:

mcporter config add minimax-search \
  --stdio "uvx minimax-coding-plan-mcp -y" \
  --env MINIMAX_API_KEY=你的MiniMax API Key \
  --env MINIMAX_API_HOST=https://api.minimaxi.com

3、验证配置:

mcporter list # 显示minimax-search(状态为healthy)

4、调用搜索服务:

在OpenClaw中输入:

帮我搜索2026年AI行业趋势报告,并总结核心观点。

OpenClaw会通过MiniMax MCP Server获取搜索结果,并返回总结内容。

五、常见问题排查

1、MCP Server连接失败:

检查MCP Server的command(如npx、uvx)是否正确安装:npx --version、uvx --version;
检查环境变量(如MINIMAX_API_KEY、高德API Key)是否正确配置。

2、OpenClaw无法识别MCP工具:

重启OpenClaw网关:openclaw gateway restart;
检查mcporter配置是否正确:mcporter config list。

3、Windows系统特殊问题:

若sharp模块安装失败,尝试使用WSL2(推荐):

wsl --install

装WSL2(需重启电脑)

然后在WSL2中执行上述安装步骤(如curl -fsSL https://openclaw.ai/install.sh | bash)。

总结

OpenClaw使用MCP的核心逻辑是通过mcporter适配第三方MCP Server,从而实现与外部服务的连接。关键步骤包括:

  1. 安装OpenClaw与依赖;
  2. 安装并配置mcporter;
  3. 添加所需的MCP Server(如高德、MiniMax);
  4. 通过自然语言指令调用MCP服务。

通过这种方式,OpenClaw可突破自身功能限制,连接地图、搜索、数据库等外部服务,实现更复杂的自动化任务(如旅行攻略生成、竞品监控、自动回复评论等)。

MCP使用教程详细

第三方工具接入快

和Skill什么关系

原来MCP这么强

教程很实用

@zhaoyi_ml 配置有点复杂

性能开销大吗

@embedding_guru 调试工具推荐一下

1 个赞

MCP协议理解了

生态越来越丰富

连接经常断怎么办

1 个赞

@embedding_guru 文档写得清楚

1 个赞

@embedding_guru MCP是未来趋势

2 个赞

MCP 是目前扩展 AI 工具能力的最佳方式了

配了数据库的 MCP 工具,直接用自然语言查数据库了

MCP 教程写得很清晰,按步骤配好了

请问 MCP 和 Skills 有什么区别?哪个更适合新手

MCP 生态现在发展很快,各种工具都在接入

MCP协议文档看了半天没看懂