RoxyBrowser x OpenClaw 官方指南：构建基于 MCP 协议的 AI 浏览器自动化执行

本教程面向新手，提供最详尽的 OpenClaw 安装与配置指南，按步骤操作即可在 OpenClaw 里高效使用 MCP 服务器。通过集成 RoxyBrowser MCP，你可以直接驱动 RoxyBrowser 指纹浏览器完成自动化任务。

文中涉及密钥、Token 等敏感信息的地方均用占位符表示，请替换为你自己的值。

一、前置要求

在开始 OpenClaw 部署之前，确保你的本地环境满足以下条件：

• 已安装 Node.js（建议 v22 或更高，可用 node -v 查看）
• 已安装 npm（随 Node.js 自带，可用 npm -v 查看）
• 已安装 OpenClaw（若未安装，见第二步）

二、安装 OpenClaw 与 mcporter 核心组件

2.1 安装 OpenClaw（如未安装）

在终端执行：

npm install -g openclaw@latest

安装完成后可执行 openclaw --version 确认。

2.2 安装 mcporter

mcporter 是 OpenClaw 用来连接和管理 MCP 服务器的工具，必须安装：

npm install -g mcporter

安装完成后可执行 mcporter list 测试（此时可能提示无配置，属正常）。

三、创建 mcporter 的 MCP 配置文件

mcporter 通过 config.json 风格的配置文件知道有哪些 MCP 服务器。你需要在固定的位置放置配置文件。

3.1 配置文件路径（按系统）

说明：把「你的用户名」换成你当前登录系统的用户名。
在 Windows 上可在资源管理器地址栏输入 %USERPROFILE% 查看当前用户目录。

3.2 创建配置目录

Windows（PowerShell）：

# 若目录不存在则创建
New-Item -ItemType Directory -Path "$env:USERPROFILE\.mcporter" -Force

macOS / Linux：

mkdir -p ~/.mcporter

3.3 编写配置文件内容

用记事本或任意编辑器打开（或新建）上面的 mcporter.json，填入下面内容。
须替换对应的 YOUR_ROXY_API_KEY 和 YOUR_ROXY_API_HOST 为你本地 RoxyBrowser 的信息。

{
  "mcpServers": {
    "roxybrowser-openapi": {
      "command": "npx",
      "args": ["-y", "@roxybrowser/openapi@latest"],
      "env": {
        "ROXY_API_KEY": "YOUR_ROXY_API_KEY",
        "ROXY_API_HOST": "YOUR_ROXY_API_HOST"
      }
    },
    "roxybrowser-playwright-mcp": {
      "command": "npx",
      "args": ["-y", "@roxybrowser/playwright-mcp@latest"]
    }
  }
}

参数说明：

如果暂时不用某个 MCP，可整段删除对应键（例如删掉 roxybrowser-openapi 整块）。
保存文件时确保编码为 UTF-8，文件名为 mcporter.json。

四、在 OpenClaw 中启用 mcporter 并指定配置路径

要让 OpenClaw 的 AI 能「看到」这些 MCP，需要：
1）启用 mcporter 这个 skill；
2）通过环境变量告诉 mcporter 配置文件的路径（避免找不到配置）。

4.1 OpenClaw 配置文件的路径

首次运行 OpenClaw 后通常会生成该文件；若没有，可先执行一次 openclaw doctor 或启动一次 OpenClaw 再找该文件。

4.2 在 openclaw.json 里添加 mcporter 配置

用编辑器打开 openclaw.json，找到 "skills" 这一段。
若已有 "entries"，就在里面加/改 "mcporter"；若没有，就按下面结构在 "skills" 下补全。

目标结构示例：

{
  "skills": {
    "install": {
      "nodeManager": "npm"
    },
    "entries": {
      "mcporter": {
        "enabled": true,
        "env": {
          "MCPORTER_CONFIG": "这里填你的_mcporter.json_的完整路径"
        }
      }
    }
  }
}

重要：MCPORTER_CONFIG 必须写成你电脑上 mcporter.json 的真实路径。

• Windows 示例（替换 你的用户名）：
  "MCPORTER_CONFIG": "C:\\Users\\你的用户名\\.mcporter\\mcporter.json"
• macOS / Linux 示例：
  "MCPORTER_CONFIG": "/Users/你的用户名/.mcporter/mcporter.json"

注意： Windows 路径里的反斜杠 \ 在 JSON 里要写成 \\。

保存 openclaw.json。

五、重启 OpenClaw 使配置生效

修改了 openclaw.json 或 mcporter.json 后，必须重新启动 OpenClaw 以加载新配置。

1. 若 OpenClaw 是以本地服务/网关形式在运行：
   • 在运行 OpenClaw 的终端里按 Ctrl+C 停止，再重新执行你平时启动 OpenClaw 的命令（例如 openclaw gateway 或应用内「启动网关」）。
2. 若使用的是 OpenClaw 桌面应用：
   • 完全退出应用后再次打开。

重启后，新配置才会被读取。

六、验证 MCP 是否安装成功

6.1 使用 mcporter list 指令验证

在终端执行：

mcporter list

若配置正确，会列出你在 mcporter.json 里配置的 MCP 服务器及各自工具；若提示找不到配置，请检查 第三步 的路径和 第四步 的 MCPORTER_CONFIG 是否一致。

6.2 在 OpenClaw 对话框验证

在 OpenClaw 对话框里对 AI 说：

• 「列出当前可用的 MCP 服务器」
  或
• 「执行 mcporter list」

若 AI 能列出 context7、roxybrowser 等服务器，说明 OpenClaw 已正确使用 mcporter 并看到 MCP。

七、常见问题

八、拓展阅读：为什么用 OpenClaw 配合 RoxyBrowser？

• 真正的 AI 自动化： 在 OpenClaw 中集成 RoxyBrowser MCP 后，你可以实现从“对话”到“执行”的跨越，比如直接用指令告诉 AI 打开某个指纹窗口并在窗口上自动登录亚马逊。

• 开源优势： 相比于 Claude Desktop，OpenClaw 提供了更高的配置自由度，在处理 config.json 调试时也更加直观。

• 多模型支持： 你可以在 OpenClaw 中灵活切换 DeepSeek、GPT-4 等主流 AI 大模型，同时调用底层的浏览器自动化能力。