OpenClaw MCP Adapter 完整教程：让任意 AI 客户端驱动 OpenClaw

前言

上篇教程我们讲的是 OpenClaw 调用外部 MCP Server（如 AKShare）。

这篇反过来——通过 openclaw-mcp-adapter，把 OpenClaw 本身变成一个 MCP Server，让 Claude Desktop、Cursor、Continue 等任意支持 MCP 协议的 AI 客户端，直接调用 OpenClaw 的全部能力。

Claude Desktop / Cursor / 自定义 AI 应用
              ↓
    openclaw-mcp-adapter（MCP Server）
              ↓
          OpenClaw
              ↓
      操控电脑、执行脚本、管理文件……

---

前置条件

依赖	要求	备注
OpenClaw	已安装并正常运行	确保 openclaw gateway 已启动
Node.js	≥ 22	运行 adapter 所需
npm / npx	最新版	随 Node.js 一起安装
uv / uvx	最新版	可选，部分安装方式需要

---

一、安装 openclaw-mcp-adapter

方式一：npx 直接运行（推荐，无需安装）

npx openclaw-mcp-adapter --help

首次运行会自动下载，后续直接使用，无需手动维护版本。

方式二：全局安装

npm install -g openclaw-mcp-adapter

安装后可直接使用命令：

openclaw-mcp-adapter --help

方式三：uvx 运行

uvx openclaw-mcp-adapter --help

---

二、确认 OpenClaw 已正常启动

adapter 需要连接到正在运行的 OpenClaw 服务，请先确认：

# 启动 OpenClaw gateway
openclaw gateway

# 检查运行状态
openclaw doctor

确认输出中包含：

✅ OpenClaw daemon running
✅ Gateway: http://localhost:你的端口

记下你的 OpenClaw 监听地址和端口，后续配置会用到，默认一般为：

http://localhost:3000

---

三、接入 Claude Desktop

3.1 找到 Claude Desktop 配置文件

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
C:\Users\用户名\AppData\Roaming\Claude\claude_desktop_config.json

如果文件不存在，手动创建即可。

3.2 添加 openclaw-mcp-adapter 配置

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": [
        "-y",
        "openclaw-mcp-adapter",
        "--url",
        "http://localhost:3000"
      ]
    }
  }
}

3.3 如果 OpenClaw 设置了 API Key

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": [
        "-y",
        "openclaw-mcp-adapter",
        "--url",
        "http://localhost:3000",
        "--api-key",
        "你的OpenClaw API Key"
      ]
    }
  }
}

3.4 重启 Claude Desktop

完全退出 Claude Desktop 后重新打开，在对话界面底部工具栏应能看到 OpenClaw 工具已挂载。

3.5 验证是否生效

在 Claude Desktop 对话框输入：

帮我列出桌面上的所有文件

或者：

打开记事本，写入"Hello from Claude Desktop"，保存到桌面

如果 Claude 能调用 OpenClaw 完成操作，说明接入成功。

---

四、接入 Cursor

4.1 打开 Cursor MCP 配置

在 Cursor 中按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows），搜索：

MCP: Open Configuration

或手动找到配置文件：

# macOS
~/.cursor/mcp.json

# Windows
C:\Users\用户名\.cursor\mcp.json

4.2 添加配置

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": [
        "-y",
        "openclaw-mcp-adapter",
        "--url",
        "http://localhost:3000"
      ]
    }
  }
}

4.3 在 Cursor 中调用示例

配置完成后，在 Cursor 的 AI 对话面板中可以这样使用：

帮我运行当前项目的测试，如果有报错，自动修复后重新运行

把 src 目录下所有 .js 文件重命名为 .ts

在终端执行 npm run build，把构建日志返回给我

---

五、接入 Continue（VS Code 插件）

5.1 找到 Continue 配置文件

# macOS / Linux
~/.continue/config.json

# Windows
C:\Users\用户名\.continue\config.json

5.2 在 config.json 中添加 MCP 配置

{
  "models": [...],
  "mcpServers": [
    {
      "name": "openclaw",
      "command": "npx",
      "args": [
        "-y",
        "openclaw-mcp-adapter",
        "--url",
        "http://localhost:3000"
      ]
    }
  ]
}

5.3 重启 VS Code

保存配置后重启 VS Code，Continue 插件会自动加载 OpenClaw 工具。

---

六、同时接入多个客户端

openclaw-mcp-adapter 支持多个客户端同时连接同一个 OpenClaw 实例，无需任何额外配置。

Claude Desktop ─┐
                ├─→ openclaw-mcp-adapter ─→ OpenClaw ─→ 你的电脑
Cursor         ─┘
Continue       ─┘

每个客户端独立配置自己的 adapter 连接即可，OpenClaw 会统一处理所有请求。

---

七、完整配置参数说明

openclaw-mcp-adapter [选项]

选项：
  --url        OpenClaw 服务地址     默认: http://localhost:3000
  --api-key    OpenClaw API Key      如果开启了认证则必填
  --timeout    请求超时时间（毫秒）  默认: 30000
  --debug      开启调试日志          默认: false
  --help       显示帮助信息

完整示例：

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": [
        "-y",
        "openclaw-mcp-adapter",
        "--url", "http://localhost:3000",
        "--api-key", "your-api-key",
        "--timeout", "60000",
        "--debug", "true"
      ]
    }
  }
}

---

八、实战场景示例

场景一：Claude Desktop 控制电脑自动化办公

我需要把桌面上所有 PDF 文件移动到"文档/PDF归档/2025"文件夹，
如果目标文件夹不存在，先创建它

场景二：Cursor 调用 OpenClaw 执行 CI/CD

帮我执行以下步骤：
1. git pull origin main
2. npm install
3. npm run test
4. 如果测试全部通过，执行 npm run build
5. 把每步的执行结果返回给我

场景三：多工具协同（AKShare MCP + OpenClaw）

这个场景需要 OpenClaw 同时配置了 AKShare MCP（见上篇教程）

在 Claude Desktop 中：

帮我查询贵州茅台最近 30 天的收盘价数据，
生成一张折线图，保存到桌面，文件名为"茅台走势图.png"

AI 会自动：

1. 调用 AKShare MCP 获取股价数据
2. 调用 OpenClaw 在本地执行 Python 脚本生成图表
3. 将文件保存到指定位置

---

九、常见问题排查

问题现象	可能原因	解决方案
Claude Desktop 看不到 OpenClaw 工具	配置文件格式错误	用 jsonlint.com 检查 JSON 格式
adapter 连接超时	OpenClaw 未启动	先执行 openclaw gateway
工具调用返回权限错误	未配置 API Key	添加 --api-key 参数
npx 下载速度慢	网络问题	配置 npm 镜像：npm config set registry https://registry.npmmirror.com
Cursor 重启后工具消失	配置文件路径有误	确认 mcp.json 文件位置正确
多客户端冲突	端口占用	检查各客户端日志，OpenClaw 单实例即可支持多客户端

---

十、架构总结

至此，你已经构建了一套完整的 AI 工具链：

外部 AI 客户端（Claude Desktop / Cursor / Continue）
                    ↓
         openclaw-mcp-adapter
                    ↓
               OpenClaw
              ↙         ↘
    调用 MCP Server      操控本地电脑
   （AKShare / 文件系统）  （执行脚本 / 管理文件）

每一层的职责：

层级	组件	职责
交互层	Claude Desktop / Cursor	自然语言输入，展示结果
桥接层	openclaw-mcp-adapter	协议转换，暴露 OpenClaw 为 MCP Server
执行层	OpenClaw	任务编排、指令执行
数据层	AKShare MCP / 文件系统 MCP	提供数据和工具能力

---

写在最后

通过 openclaw-mcp-adapter，OpenClaw 不再是一座孤岛，而是成为整个 AI 生态的核心执行引擎。无论你习惯用 Claude Desktop 对话，还是在 Cursor 里写代码，都能无缝调用 OpenClaw 的全部能力。

AI 模型的质量决定了任务理解和规划的上限，推荐搭配 一步API（yibuapi.com） 为各个客户端提供顶级模型支持——GPT-4o、Claude、Gemini 一站接入，￥1=$1 充值汇率，让你的整套 AI 工具链都跑在最强的模型上。

👉 立即访问 yibuapi.com，为你的 AI 工具链注入顶级动力

---