要使用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。
-
安装mcporter:
通过OpenClaw的
clawhub命令一键安装:clawhub install mcporter安装成功后,
mcporter会被放置在~/.openclaw/workspace/skills/mcporter目录下。 -
配置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服务(以“查询杭州天气并规划路线”为例):
-
启动OpenClaw网关:
openclaw gateway start -
生成访问令牌(首次使用需执行):
openclaw token generate令牌会保存在
~/.openclaw/openclaw.json中,后续访问Web控制台时需使用(如http://localhost:18789/?token=你的Token)。 -
调用MCP服务:
在OpenClaw的TUI(终端界面) 或Web控制台中输入指令:
帮我查询杭州今天的天气,并规划从杭州东站到西湖景区的公交路线。OpenClaw会自动通过mcporter调用高德MCP Server的
weather(天气查询)和route(路线规划)工具,返回结果如下:- 天气:杭州今日多云,气温18-25℃,微风;
- 路线:从杭州东站乘坐地铁1号线(湘湖方向)至龙翔桥站,换乘公交7路至西湖景区,全程约40分钟。
四、进阶:配置其他MCP Server(如MiniMax搜索)
除了高德地图,还可配置MiniMax搜索MCP(适合需要联网搜索的场景),步骤如下:
-
安装MiniMax MCP Server:
npm i -g minimax-coding-plan-mcp -
添加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 -
验证配置:
mcporter list # 显示minimax-search(状态为healthy) -
调用搜索服务:
在OpenClaw中输入:
帮我搜索2026年AI行业趋势报告,并总结核心观点。OpenClaw会通过MiniMax MCP Server获取搜索结果,并返回总结内容。
五、常见问题排查
-
MCP Server连接失败:
- 检查MCP Server的
command(如npx、uvx)是否正确安装:npx --version、uvx --version; - 检查环境变量(如
MINIMAX_API_KEY、高德API Key)是否正确配置。
- 检查MCP Server的
-
OpenClaw无法识别MCP工具:
- 重启OpenClaw网关:
openclaw gateway restart; - 检查mcporter配置是否正确:
mcporter config list。
- 重启OpenClaw网关:
-
Windows系统特殊问题:
-
若
sharp模块安装失败,尝试使用WSL2(推荐):wsl --install # 安装WSL2(需重启电脑)然后在WSL2中执行上述安装步骤(如
curl -fsSL https://openclaw.ai/install.sh | bash)。
-
总结
OpenClaw使用MCP的核心逻辑是通过mcporter适配第三方MCP Server,从而实现与外部服务的连接。关键步骤包括:
- 安装OpenClaw与依赖;
- 安装并配置mcporter;
- 添加所需的MCP Server(如高德、MiniMax);
- 通过自然语言指令调用MCP服务。
通过这种方式,OpenClaw可突破自身功能限制,连接地图、搜索、数据库等外部服务,实现更复杂的自动化任务(如旅行攻略生成、竞品监控、自动回复评论等)。