openclaw如何使用MCP

15 阅读3分钟

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

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

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

  1. 验证安装

    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(如npxuvx)是否正确安装:npx --versionuvx --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可突破自身功能限制,连接地图、搜索、数据库等外部服务,实现更复杂的自动化任务(如旅行攻略生成、竞品监控、自动回复评论等)。