OpenClaw+McPorter一键管遍所有MCP服务器💥

❶ 安装McPorter（三种方式任选）

✨ 方式1：OpenClaw官方一键安装（推荐！）

直接通过OpenClaw的clawhub命令安装，无需手动处理npm路径，完美适配OpenClaw环境：

1 2	# OpenClaw专属一键安装 clawhub install mcporter

💡 安装后路径：mcporter会自动放置在 ~/.openclaw/workspace/skills/mcporter 目录下，无需额外配置环境变量！

✨ 方式2：npm全局安装（通用方式）

# 全局安装（OpenClaw兼容）
npm install -g mcporter
# 验证安装成功（显示版本即OK）
mcporter --version

✨ 方式3：Docker环境安装（容器化部署OpenClaw专用）

1	docker exec -it openclaw-gateway npm install -g mcporter

❷ 核心前置：McPorter配置文件路径说明

McPorter 通过 mcporter.json 配置文件识别所有MCP服务器，先理清路径才能避免配置失效！

系统级默认路径（跨平台对照表）

系统	配置文件路径
Windows	C:\Users\你的用户名.mcporter\mcporter.json
macOS / Linux	~/.mcporter/mcporter.json

❸ 在OpenClaw中启用McPorter

配置好McPorter后，必须在OpenClaw主配置中启用，才能让OpenClaw识别这些MCP！

🔹 第一步：定位OpenClaw主配置文件

macOS/Linux：~/.openclaw/openclaw.json
Windows：C:\Users\你的用户名\.openclaw\openclaw.json

🔹 第二步：添加McPorter配置

编辑openclaw.json，在skills节点下新增mcporter配置：

{
  "skills": {
    "entries": {
      "mcporter": {
        "enabled": true, // 必须设为true才生效
        "env": {
          // 指定McPorter配置文件路径（对应上文路径）
          "MCPORTER_CONFIG": "/Users/你的用户名/.mcporter/mcporter.json"
          // Windows路径示例："C:\\Users\\你的用户名\\.mcporter\\mcporter.json"
        }
      }
    }
  }
}

🔹 第三步：写入OpenClaw MCP配置（示例）

复制这段到对应路径（参考上文路径表），替换成自己MCP的对应参数：

{
  "mcpServers": {
    "openclaw-fs": { // 自定义MCP名称，方便识别
      "command": "npx",
      "args": ["-y", "@openclaw/mcp-fs@latest"], // OpenClaw官方MCP包
      "env": {
        "FS_ROOT": "/your/workdir", // 限制文件访问目录
        "OPENCLAW_API_KEY": "${你的密钥}"
      }
    },
    "brave-search": { // 远程MCP示例
      "baseUrl": "https://mcp.brave.com/mcp",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer 你的Brave密钥"
      },
      "timeout": 5000
    }
  }
}

❹ 核心配置：mcporter config add 快捷管理

不想手动写JSON？用config add命令一键生成配置，自动写入OpenClaw官方路径！

🔹 基础语法（OpenClaw适配版）

1	mcporter config add <MCP名称> [参数]

🔹 适配OpenClaw的高频用法

✨ 1. 添加STDIO类型MCP（以MD2Card为例)

mcporter config add md2card-server \
--command "npx" \
--arg "-y" \
--arg "md2card-mcp-server@latest" \ 
--env "MD2CARD_API_KEY=${你的API密钥}" \
--scope home #全局

💡 配置会自动写入对应系统路径，无需手动改文件！

✨ 2. 添加HTTP/SSE远程MCP

mcporter config add brave-search \
--url https://mcp.brave.com/mcp \
--transport sse \
--header "Authorization=Bearer ${BRAVE_API_KEY}" \
--timeout 5000

✨ 3. 试运行验证（避免配置出错）

mcporter config add openclaw-llm \
--command "npx" \
--arg "@openclaw/mcp-llm@latest" \
--dry-run # 仅输出配置，不实际写入文件

✨ 4. 从已有配置复制（快速复用）

1
2
3

mcporter config add openclaw-linear \
--copy-from cursor:linear \
--persist ~/.openclaw/config/mcporter.json # 写入OpenClaw专属路径

🔹 验证配置是否生效

# 查看所有已配置的MCP
mcporter config list
# 查看单个MCP详情（JSON格式）
mcporter config get md2card-server --json

❺ 一键管理OpenClaw的MCP服务器

启用后，就能用McPorter一站式管理所有MCP，不用再折腾OpenClaw网关！

🔍 发现可用MCP

# 搜索关键词（如数据库/搜索/文件系统）
mcporter search "database"
# 按分类浏览
mcporter browse --category search
# 查看服务器详情
mcporter info brave-search

📦 一键安装MCP（OpenClaw适配版）

# 基础安装（自动适配OpenClaw环境）
mcporter install brave-search
# 安装时配置环境变量
mcporter install brave-search --env BRAVE_API_KEY=你的密钥
# 批量安装多个
mcporter install brave-search postgres filesystem
# 试运行（不实际安装）
mcporter install postgres --dry-run
# 指定OpenClaw配置文件路径安装
mcporter install openclaw-llm --config ~/.openclaw/config/mcporter.json

🔧 一站式运维管理

# 列出OpenClaw已加载的所有MCP（含状态）
mcporter list
# 查看单个MCP详细状态
mcporter status postgres
# 调用OpenClaw的MCP工具（示例：文件读取）
mcporter call openclaw-fs.read-file path="/test.md"
# 更新MCP（单个/全部）
mcporter update openclaw-llm
mcporter update --all
# 全局健康检查（适配OpenClaw环境）
mcporter doctor
mcporter diagnose postgres
# 启用/禁用/重启/卸载
mcporter enable/disable notion
mcporter restart postgres
mcporter uninstall notion

❻ 关键小知识：McPorter≠ClawHub，互补使用更香

✅ McPorter管MCP服务器：给OpenClaw加原子能力（搜索、查数据库、读写文件），纯工具连接，跨应用通用
✅ ClawHub管Skill：给OpenClaw加编排好的工作流（日报生成、代码审查），OpenClaw专属
✅ 最强搭配：McPorter装底层工具+ClawHub装工作流，Skill调用MCP工具完成复杂任务，效率直接拉满！

💡 OpenClaw专属小技巧

配置路径别写错！MCPORTER_CONFIG必须指向实际的mcporter.json（参考路径表），否则OpenClaw识别不到MCP
给OpenClaw加文件类MCP时，一定要用FS_ROOT限制目录，避免敏感文件泄露
修改配置后无需重启OpenClaw，McPorter会自动同步
忘记命令就输mcporter --help，所有OpenClaw适配的功能都能查
用mcporter export > ~/.openclaw/config/mcporter-backup.json导出配置，环境迁移一键恢复

自从OpenClaw接了McPorter，再也不用跟多份配置文件打交道了！从clawhub一键安装→配文件→启用→管理，一套流程下来，OpenClaw的MCP工具链直接拉满，AI开发效率翻倍💻 谁用谁香，赶紧去试试！

#OpenClaw #McPorter #MCP服务器 #AI开发 #效率工具 #AIGC教程

总结

McPorter有系统级默认路径，但会优先读取OpenClaw统一路径~/.openclaw/config/mcporter.json，配置时需确保路径正确；
mcporter config add是配置核心（自动写入对应路径），mcporter install是安装核心（适配OpenClaw环境），结合--dry-run可避免配置出错；
在OpenClaw主配置openclaw.json中启用McPorter后，可通过list/call/doctor等命令一站式管理所有MCP服务器。

Computer Science

openclaw接入mcporter