OpenClaw 使用和管理 MCP 完全指南

概述

OpenClaw（原名 Clawdbot）是一款開源的本地 AI 智能體框架，在 GitHub 上擁有超過 180K 星標。MCP（Model Context Protocol）是由 Anthropic 推出的一種開放標準協(xié)議，旨在讓 AI 模型通過統(tǒng)一接口連接各種外部工具和數(shù)據(jù)源。通過配置 MCP，OpenClaw 可以直接訪問本地文件系統(tǒng)、數(shù)據(jù)庫、GitHub 倉庫，甚至 Google Drive 和 Slack 等服務(wù)。

MCP 在 OpenClaw 中扮演"萬能插槽"的角色：以往每個工具都要編寫單獨的插件（Skill），現(xiàn)在只要工具支持 MCP，OpenClaw 就能直接調(diào)用，實現(xiàn)即插即用。

環(huán)境準備

在開始配置 MCP 之前，需要確保本地環(huán)境滿足以下條件：

• Node.js：建議 v22 或更高版本（node -v 查看）
• npm：隨 Node.js 自帶（npm -v 查看）
• OpenClaw：已安裝并可運行（openclaw --version 確認）
• mcporter（可選）：OpenClaw 用來連接和管理 MCP 服務(wù)器的工具

安裝 OpenClaw 后，可以運行 openclaw doctor 檢查系統(tǒng)健康狀態(tài)，確認運行時環(huán)境正常。

連接 MCP 的三種方式

OpenClaw 提供了多種將 MCP 服務(wù)器接入系統(tǒng)的途徑，適配不同技術(shù)水平和使用場景。

方式一：CLI 命令行添加（推薦）

這是官方推薦的最簡便方式。打開終端執(zhí)行以下格式的命令：

# 格式
openclaw mcp add --transport <傳輸協(xié)議> <服務(wù)器名稱> <啟動命令>
# 示例：添加本地文件系統(tǒng)訪問
openclaw mcp add --transport stdio local-files npx -y @modelcontextprotocol/server-filesystem /Users/yourname/Documents

上述命令會添加一個本地文件讀取工具，/Users/yourname/Documents 是授權(quán) AI 訪問的目錄。MCP 支持兩種傳輸協(xié)議：stdio（本地進程通信，低延遲）和 http/SSE（遠程服務(wù)器連接，支持多客戶端）。

方式二：通過 mcporter 工具管理

mcporter 是 OpenClaw 生態(tài)中專門用于連接和管理 MCP 服務(wù)器的工具。安裝方式：

npm install -g mcporter
mcporter --version

創(chuàng)建 mcporter 配置文件

mcporter 通過 mcporter.json 文件知道有哪些 MCP 服務(wù)器。配置文件路徑如下：

配置文件示例：

{
  "mcpServers": {
    "my-tool": {
      "command": "npx",
      "args": ["-y", "@some-mcp-package"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

在 openclaw.json 中啟用 mcporter

編輯 ~/.openclaw/openclaw.json，在 skills 部分添加 mcporter 配置：

{
  "skills": {
    "entries": {
      "mcporter": {
        "enabled": true,
        "env": {
          "MCPORTER_CONFIG": "/Users/你的用戶名/.mcporter/mcporter.json"
        }
      }
    }
  }
}

注意：MCPORTER_CONFIG 必須寫成絕對路徑。Windows 路徑中的反斜杠在 JSON 里需要寫成 \\。[3]

方式三：通過 openclaw-mcp-adapter 插件

openclaw-mcp-adapter 是一個將 MCP 服務(wù)器工具轉(zhuǎn)換為 OpenClaw 原生工具的插件。安裝方式：

openclaw plugins install mcp-adapter
# 或從源碼安裝
git clone https://github.com/androidStern/openclaw-mcp-adapter.git
openclaw plugins install ./openclaw-mcp-adapter

在 ~/.openclaw/openclaw.json 中配置：

{
  "plugins": {
    "entries": {
      "openclaw-mcp-adapter": {
        "enabled": true,
        "config": {
          "servers": [
            {
              "name": "my-mcp-server",
              "transport": "stdio",
              "command": "npx",
              "args": ["-y", "@some-mcp-package"]
            },
            {
              "name": "remote-server",
              "transport": "http",
              "url": "http://localhost:3000/mcp"
            }
          ],
          "toolPrefix": true
        }
      }
    }
  }
}

該插件的工作原理是：

1. 網(wǎng)關(guān)啟動時，插件連接到每個已配置的 MCP 服務(wù)器
2. 調(diào)用 listTools() 發(fā)現(xiàn)所有可用工具
3. 將每個工具注冊為 OpenClaw 的原生工具
4. 當 AI 調(diào)用工具時，插件將調(diào)用代理到 MCP 服務(wù)器
5. 連接斷開后，下次工具調(diào)用時自動重連

將 MCP 服務(wù)器轉(zhuǎn)換為 OpenClaw Skill

社區(qū)還提供了一個便捷工具，可以一行命令將任何 HTTP MCP 服務(wù)器轉(zhuǎn)換為完整的 OpenClaw Skill：

npx @filiksyos/mcptoskill@latest https://mcp.example.com/mcp

這個命令會自動完成以下操作：

• 連接到 MCP 服務(wù)器并發(fā)現(xiàn)所有工具
• 生成帶有描述和觸發(fā)短語的 SKILL.md
• 創(chuàng)建通過 curl 調(diào)用 MCP 服務(wù)器的 Shell 腳本
• 支持 JSON 和 SSE 兩種響應(yīng)格式
• 自動安裝到 ~/.openclaw/skills/ 并在配置中啟用

OpenClaw 作為 MCP 服務(wù)器

OpenClaw 不僅可以連接 MCP 服務(wù)器（作為客戶端），它本身也可以作為 MCP 服務(wù)器，讓其他 AI 系統(tǒng)調(diào)用。

連接到 Claude Desktop

通過 Docker 部署 openclaw-mcp 橋接服務(wù)器：

services:
  mcp-bridge:
    image: ghcr.io/freema/openclaw-mcp:latest
    container_name: openclaw-mcp
    ports:
      - "3000:3000"
    environment:
      - OPENCLAW_URL=http://host.docker.internal:18789
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - AUTH_ENABLED=true
      - MCP_CLIENT_ID=openclaw
      - MCP_CLIENT_SECRET=${MCP_CLIENT_SECRET}
      - CORS_ORIGINS=https://claude.ai

在 Claude Desktop 配置中添加：

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": ["openclaw-mcp"]
    }
  }
}

連接到 Cursor / Windsurf 等 IDE

在 IDE 配置文件中添加類似配置：[11]

{
  "mcp.servers": {
    "openclaw": {
      "command": "node",
      "args": ["/absolute/path/to/openclaw-mcp-server/dist/index.js"],
      "env": {
        "OPENCLAW_GATEWAY_TOKEN": "your-token-here"
      }
    }
  }
}

配置文件路徑匯總

網(wǎng)關(guān)管理

OpenClaw 的 MCP 工具需要網(wǎng)關(guān)（Gateway）進程正常運行才能工作。

# 啟動網(wǎng)關(guān)
openclaw gateway
# 查看網(wǎng)關(guān)狀態(tài)
openclaw gateway status
# 重啟網(wǎng)關(guān)（重新加載所有 Skill 和配置）
openclaw gateway restart
# 檢查系統(tǒng)健康狀態(tài)
openclaw doctor
# 查看網(wǎng)關(guān)日志
openclaw gateway logs

修改了 openclaw.json 或 mcporter.json 后，必須重啟 OpenClaw 才能使新配置生效。

驗證與調(diào)試

驗證 MCP 連接

配置完成后，通過以下步驟確認 MCP 已正確生效：

1. 狀態(tài)查詢：運行 openclaw status 查看 MCP 服務(wù)器是否處于 running 狀態(tài)
2. 工具列表：運行 mcporter list 查看所有已連接的 MCP 服務(wù)器及工具
3. 交互驗證：在 OpenClaw 對話框中嘗試發(fā)送相關(guān)指令（如"列出我授權(quán)目錄下的前 5 個文件名"）
4. Skill 列表：運行 clawdbot skills list 查看所有已加載的 Skill 及其狀態(tài)

常見問題排查

連接第三方 MCP 平臺

MCP360

MCP360 提供 100+ 生產(chǎn)級工具的統(tǒng)一訪問端點。集成步驟：

1. 在 mcp360.ai 創(chuàng)建賬號并生成 API Token
2. 安裝 MCPorter：npm install -g mcporter
3. 注冊 MCP360 為 MCP 服務(wù)器：提供端點 URL 和 Token
4. 運行 mcporter config list 確認注冊
5. 運行 mcporter list 驗證工具訪問

Latenode

Latenode 提供可視化工作流引擎，支持 1000+ 應(yīng)用集成。集成方式：

1. 在 Latenode 中創(chuàng)建 Scenario 并添加 MCP Trigger 節(jié)點
2. 配置 Tool Name、Tool Description 和輸入?yún)?shù)
3. 復(fù)制 Latenode 的 Server URL
4. 在 OpenClaw 中添加新的 MCP 服務(wù)器，粘貼該 URL
5. 如啟用了認證，需提供 API Key[13]

ClawPad 桌面應(yīng)用

ClawPad 是內(nèi)嵌 OpenClaw 運行時的桌面應(yīng)用，提供了一鍵安裝 MCP 擴展的圖形界面。通過 Extension Store 可以搜索、安裝和啟動 MCP 服務(wù)器（如 Filesystem MCP、Git MCP、Gmail MCP 等），無需手動編輯配置文件。

MCP 傳輸協(xié)議對比

選擇 stdio 適合本地開發(fā)和安全敏感場景；選擇 HTTP/SSE 適合需要跨設(shè)備共享或團隊協(xié)作的生產(chǎn)環(huán)境。

到此這篇關(guān)于OpenClaw 使用和管理 MCP詳細攻略的文章就介紹到這了,更多相關(guān)OpenClaw 使用和管理 MCP內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論