# @aiwerk/openclaw-mcp-bridge 中文文档

规范地址：https://npmcn.com/package/%40aiwerk/openclaw-mcp-bridge/

版本：0\.14\.1
npm 元数据更新时间：2026-05-21T14:02:57.859Z
中文译文更新时间：2026-11-06T12:12:16.519Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aiwerk/openclaw-mcp-bridge
原文对照：https://npmcn.com/package/%40aiwerk/openclaw-mcp-bridge/?lang=original
项目主页：https://github.com/AIWerk/openclaw-mcp-bridge#readme
源码仓库：https://github.com/AIWerk/openclaw-mcp-bridge

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：145 kB，94 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.0\.0
- 运行依赖：2 个
- 首次发布：2026-03-10T14:12:41.342Z
- 最新版本发布：2026-05-21T14:02:57.754Z
- 近 30 天下载量：3255（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 35 个）

## 中文简介

OpenClaw MCP插件 — 为无缝 MCP 服务器集成而绕道@aiwerk/ mcp- bridge 的薄包装器

## 安装

```sh
npm install @aiwerk/openclaw-mcp-bridge
```

也可以使用：`pnpm add @aiwerk/openclaw-mcp-bridge`、`yarn add @aiwerk/openclaw-mcp-bridge`、`bun add @aiwerk/openclaw-mcp-bridge`

## README

# @aiwerk/openclaw-mcp-桥

[![Tests](https://github.com/AIWerk/openclaw-mcp-bridge/actions/workflows/test.yml/badge.svg)](https://github.com/AIWerk/openclaw-mcp-bridge/actions/workflows/test.yml) [![npm version](https://img.shields.io/npm/v/@aiwerk/openclaw-mcp-bridge.svg)](https://www.npmjs.com/package/@aiwerk/openclaw-mcp-bridge) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

用于 OpenClaw 插件 [MCP桥](https://github.com/AIWerk/mcp-bridge) 连接任何 MCP 服务器到您的 OpenClaw 代理 .

这是薄薄的包裹 [@aiwerk/mcp-桥](https://www.npmjs.com/package/@aiwerk/mcp-bridge) 处理 OpenClaw 工具注册、生命周期和配置.

## 安装

```bash
openclaw plugins install @aiwerk/openclaw-mcp-bridge
```

> ⚠️ **重要内容:** 总是使用全范围名称 `@aiwerk/openclaw-mcp-bridge`。未瞄准镜 `openclaw-mcp-bridge` npm 是一个 **不同、无关的软件包**。 。 。 .

## 快速启动

```bash
# 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`数字 :

```json
{
  "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` 在您的插件配置中.

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

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

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

## 模式

| 模式 | 如何运作 | 最好还是 |
| --- | --- | --- |
| `direct` (默认) | 单独登记的所有工具(`todoist_find_tasks`页:1 | 很少服务器, 更简单的模型 |
| `router` | 单身 `mcp` 工具——代理通过它发现和调用服务器工具 | 3+ 服务器, 保存 ~ 99% 工具符 |

## 服务器目录

```bash
# 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"`),插件注册的工具是 **未包括** 在默认的沙盒工具允许列表中。 你需要明确允许他们:

```json
{
  "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"`),不需要额外的配置——插件工具自动可用.

## 更新

```bash
# 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 客户端的核心软件包 :

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

见 [@aiwerk/mcp-桥](https://github.com/AIWerk/mcp-bridge) 详细情况.

## 许可证

麻省理工学院 - [阿威克语Name](https://aiwerk.ch/)

## 常见问题

### @aiwerk/openclaw-mcp-bridge 是什么？

OpenClaw MCP插件 — 为无缝 MCP 服务器集成而绕道@aiwerk/ mcp- bridge 的薄包装器

### 如何安装 @aiwerk/openclaw-mcp-bridge？

在项目目录运行 npm install @aiwerk/openclaw-mcp-bridge，或使用 pnpm add / yarn add / bun add。

### @aiwerk/openclaw-mcp-bridge 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aiwerk\_\_openclaw-mcp-bridge 是否存在。

### @aiwerk/openclaw-mcp-bridge 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aiwerk/openclaw-mcp-bridge 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aiwerk/openclaw-mcp-bridge 可以商用吗？

@aiwerk/openclaw-mcp-bridge 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aiwerk/openclaw-mcp-bridge 的下载量有多少？

根据 npm 官方下载统计，@aiwerk/openclaw-mcp-bridge 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,255 次，日均约 109 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aiwerk/openclaw-mcp-bridge 还在维护吗？

最新版本 0\.14\.1 发布于 2026/05/21（5 个月前）；至今共发布 35 个版本，其中过去 12 个月发布了 35 个；首次发布于 2026/03/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。