AI导哈

OpenClaw MCP桥接插件

一个用于连接OpenClaw代理与MCP服务器的桥接插件，支持多种服务器工具的注册、生命周期管理和配置。

  • by AIWerk
  • TypeScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 AIWerk/openclaw-mcp-bridge

使用说明

@aiwerk/openclaw mcp桥

OpenClaw插件 MCP电桥 --将任何MCP服务器连接到您的OpenClaw代理。

这是一个薄薄的包装 @aiwerk/mcp大桥 它处理OpenClaw工具的注册、生命周期和配置。

安装

openclaw plugins install @aiwerk/openclaw-mcp-bridge

⚠️ 重要提示： 始终使用全范围名称 @aiwerk/openclaw-mcp-bridge.未放映的 openclaw-mcp-bridge npm是一个 不同的、无关的包.

快速开始

# 1. Install the plugin
openclaw plugins install @aiwerk/openclaw-mcp-bridge

# 2. Install a server from the catalog
~/.openclaw/extensions/openclaw-mcp-bridge/install-server.sh todoist

# 3. Restart the gateway
openclaw gateway restart

安装脚本提示您输入API密钥，并自动配置所有内容。

配置

插件配置位于 ~/.openclaw/openclaw.json 在...之下 plugins.entries.openclaw-mcp-bridge.config:

{
  "plugins": {
    "entries": {
      "openclaw-mcp-bridge": {
        "config": {
          "mode": "router",
          "servers": {
            "todoist": {
              "transport": "stdio",
              "command": "npx",
              "args": ["-y", "@doist/todoist-ai"],
              "env": { "TODOIST_API_KEY": "${TODOIST_API_TOKEN}" },
              "description": "Task management"
            }
          },
          "toolPrefix": true
        }
      }
    }
  }
}

目录选项

选项 类型 默认值 描述
catalog boolean true 是否在启动时通过以下方式获取目录食谱 bootstrapCatalog()
autoMerge boolean false 是否将目录配方自动合并到服务器配置中

突变（v0.14.0+）： autoMerge 现在默认为 false。以前，目录食谱总是自动合并的。要恢复旧行为，请设置 autoMerge: true 在你的插件配置中。

{
  "plugins": {
    "entries": {
      "openclaw-mcp-bridge": {
        "config": {
          "autoMerge": true
        }
      }
    }
  }
}

环境变量解析自 ~/.openclaw/.env 以及系统环境。

注（v0.10.4+）： 如果您的shell中存在空字符串形式的env-var，则插件将返回读取 ~/.openclaw/.env 直接。这可以防止以下问题 dotenv(override:false) 默默地忽略 .env 价值。

模式

模式 工作原理 最适合
direct （默认） 单独注册的所有工具(todoist_find_tasks，等等） 服务器少，型号更简单
router 单身 mcp tool——代理通过它发现并调用服务器工具 3+台服务器，节省约99%的工具令牌

服务器目录

# List available servers
~/.openclaw/extensions/openclaw-mcp-bridge/list-servers.sh

# Install interactively
~/.openclaw/extensions/openclaw-mcp-bridge/install-server.sh <server>

# Available: todoist, github, notion, stripe, linear, google-maps,
#            hetzner, miro, wise, tavily, apify

Docker沙盒

如果你在启用Docker沙盒的情况下运行OpenClaw(agents.defaults.sandbox.mode: "all" 或 "non-main")，插件注册工具有 不包括 在默认的沙盒工具allowlist中。你需要明确地允许它们：

{
  "tools": {
    "sandbox": {
      "tools": {
        "allow": ["group:openclaw", "mcp", "mcp_bridge_update"]
      }
    }
  }
}
  • group:openclaw --保留所有内置的OpenClaw工具
  • mcp --MCP网桥路由器工具
  • mcp_bridge_update --插件更新工具

您可以通过以下方式进行验证 openclaw sandbox explain --json --检查一下 mcp 出现于 sandbox.tools.allow.

应用此功能的替代方法：

  • 控制UI： 打开 http://localhost:18789/config → 导航至 tools → sandbox → tools → allow → add mcp 和 mcp_bridge_update 一起 group:openclaw.
  • CLI： openclaw config set tools.sandbox.tools.allow '["group:openclaw", "mcp", "mcp_bridge_update"]'

网关会自动热重新加载配置。

注： 无沙箱(sandbox.mode: "off")，不需要额外的配置——插件工具是自动可用的。

更新

# Check for updates (via the agent)
mcp_bridge_update(check_only=true)

# Install update
openclaw plugins update @aiwerk/openclaw-mcp-bridge
openclaw gateway restart

建筑

OpenClaw Agent
    │
    ├── mcp tool (router mode)
    │   └── @aiwerk/openclaw-mcp-bridge (this plugin)
    │       └── @aiwerk/mcp-bridge (core)
    │           ├── todoist (stdio)
    │           ├── github (stdio)
    │           └── notion (stdio)
    │
    └── other tools...

插件处理：

  • 使用OpenClaw注册工具(registerTool / unregisterTool)
  • 生命周期(activate / deactivate)
  • 更新通知（注入到工具响应中）
  • OpenClaw配置集成(openclaw.json)

核心处理：

  • MCP协议（初始化、工具/列表、工具/调用）
  • 传输管理（stdio、SSE、可流式传输http）
  • 路由器/直接模式多路复用
  • 模式转换、重新连接、错误处理

独立使用

不使用OpenClaw？直接将核心包与Claude Desktop、Cursor、Windsurf或任何MCP客户端一起使用：

npm install -g @aiwerk/mcp-bridge
mcp-bridge init
mcp-bridge install todoist
mcp-bridge

看 @aiwerk/mcp大桥 了解详情。

许可证

麻省理工学院-- 工作

相关 MCP