@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
        }
      }
    }
  }
}

目录选项

断裂变化(v0.14.0+): autoMerge 现在默认为 false。以前,目录食谱总是自动合并。 为了恢复旧行为,设定 autoMerge: true 在您的插件配置中.

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

环境变量从 ~/.openclaw/.env 和系统舱.

注 (v0.10.4+): 如果您的外壳中存在空字符串, 插件会返回读取 ~/.openclaw/.env 直接说 这可以防止出现以下问题: dotenv(override:false) 默然无视 .env 数值.

模式

服务器目录

# 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 沙盒运行 OpenClaw (启用)agents.defaults.sandbox.mode: "all" 或者说 "non-main"),插件注册的工具是 未包括 在默认的沙盒工具允许列表中。 你需要明确允许他们:

{
  "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 • 添加 mcp 财务报告和审定财务报表 mcp_bridge_update 并行 group:openclaw。 。 。 .
• CLI: 爱丽丝 openclaw config set tools.sandbox.tools.allow '["group:openclaw", "mcp", "mcp_bridge_update"]'

网关热重装自动配置 .

说明: 没有沙盒( N)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 配置集成( R)openclaw.json(中文(简体) )

核心手柄:

• MCP协议(初始化、工具/清单、工具/呼叫)
• 运输管理(Stio、SSE、可流-http)
• 路由器/ 直接模式多向
• Schema 转换、重新连接、错误处理

独立使用

不要使用OpenClaw吗? 直接使用 Claude 桌面、光标、 Windsurf 或 MCP 客户端的核心软件包 :

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

见 @aiwerk/mcp-桥 详细情况.

许可证

麻省理工学院 - 阿威克语Name