← 返回目录

OpenClaw MCP Server

社区

将 Claude 与自托管 OpenClaw 助手安全连接的 MCP 服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 186 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 20+ · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 22 天前
工具数: 7

63FMRS · C

服务器提供与 OpenClaw 的无缝集成，支持同步和异步任务以及多实例。注重安全，提供 OAuth 和 CORS 控制。部署需要仔细配置。

最强项 · 文档质量 17/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

13/20

维护活跃度

15/20

文档质量

17/20

安装易用性

12/20

查看各项评分依据

可靠性 6/20: 证据：README 列出了完整的同步/异步工具集和两种传输模式，manifest 确认 npm 1.7.0 包与 OCI 镜像存在。扣分：未提供源码、测试或 CI 运行日志，无法验证 MCP 初始化、工具列表握手以及工具是否与真实行为一致；manifest 中 OCI 包声明 stdio 传输且固定为 1.5.0，与 README 中以 HTTP 桥接为主、版本 1.7.0 的说明相矛盾。不确定性只降不升，故给 6 分。
安全与权限 13/20: 证据：manifest 将 OPENCLAW_GATEWAY_TOKEN 标记为 isSecret；README 要求生产环境启用 OAuth 2.1，1.7.0 起 CORS 默认关闭，异步任务按连接隔离，openclaw_instances 不暴露令牌，容器以 read_only + no-new-privileges 运行，并发布威胁模型文档；安装示例均使用占位符，未发现真实密钥。扣分：实现无法从所供材料审计，桥接器的远程命令面完全依赖网关令牌，一旦泄露风险很高（虽有披露但无法核实）；因此不给满分，给 13 分。
维护活跃度 15/20: 证据：MIT 许可证，版本线推进至 1.7.0 并附升级说明，有 CI 徽章、GHCR 发布、SECURITY.md 和分层文档；manifest 独立确认 npm 与 OCI 包已发布。扣分：提交频率、issue 响应时效和依赖更新历史无法从所供材料核实，按保守原则不给满分，给 15 分。
文档质量 17/20: 证据：README 覆盖 Docker/本地/远程三种安装方式、多实例模式、SSE→HTTP 迁移、架构图、工具表、安全与升级章节，并提供 installation/configuration/deployment/threat-model/logging/development/SECURITY 等分层文档，还包含针对 ERR_ERL_UNEXPECTED_X_FORWARDED_FOR 和 Unregistered redirect_uri 的排障说明。扣分：未明确说明限额/成本，完整 OAuth 流程细节指向外部文档，故给 17 分。
安装易用性 12/20: 证据：提供了 docker-compose 示例、Claude Desktop 配置 JSON、Claude.ai 连接器步骤及环境变量表。扣分：步骤多且脆弱——URL 必须以 /mcp 结尾、redirect_uri 需精确匹配、反向代理后必须设置 MCP_ISSUER_URL 和 TRUST_PROXY；manifest 中 OCI 条目（1.5.0/stdio）与 README 的 1.7.0/HTTP 主线不一致，容易造成安装选择困惑；无执行证据，静态上限 15，实际给 12 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

希望将自托管 OpenClaw 与 Claude 集成的用户
需要从统一接口管理多个 OpenClaw 实例的用户

不适合谁

没有 OpenClaw 实例的用户
需要无认证生产部署的用户

所需权限

需要访问 OpenClaw 网关 HTTP API
需要网关令牌（Bearer token）进行认证

风险与副作用

如果没有正确保护，生产环境中的安全风险（必须启用认证）。
如果配置不当，OAuth 回调存在暴露风险；建议设置精确的重定向 URI。
暴露网关 URL 和密钥可能带来安全风险。

安装接入

准备工作

运行环境：Node.js 20+ · Docker

OPENCLAW_URL 必填 OpenClaw 网关的 URL（OpenAI 兼容 HTTP API），默认 http://127.0.0.1:18789，必填。

OPENCLAW_GATEWAY_TOKEN 必填密钥 OpenClaw 网关的 Bearer 认证令牌，从你自托管的 OpenClaw 网关获取，必填且为密钥。

MCP_CLIENT_SECRET 可选密钥 OAuth 客户端密钥，可用 openssl rand -hex 32 生成，密钥。

其他可选配置项（9 个）

OPENCLAW_MODEL 可选聊天补全使用的模型名，如 'openclaw' 或 'openclaw/<agentId>'，默认 'openclaw'，可选。

OPENCLAW_TIMEOUT_MS 可选请求超时毫秒数，默认 120000，可选。

OPENCLAW_INSTANCES 可选多实例模式的 JSON 实例列表（每个含 name、url、token 等），可选。

AUTH_ENABLED 可选在 HTTP 模式下启用 OAuth 2.1 认证，生产环境建议设为 true，可选。

MCP_CLIENT_ID 可选 OAuth 客户端 ID，Claude.ai 连接器使用（如 'openclaw'），HTTP 模式下使用。

MCP_ISSUER_URL 可选反向代理后面必须设置的公网 HTTPS URL，否则 OAuth 元数据会指向 localhost。

MCP_REDIRECT_URIS 可选 OAuth 重定向 URI，Claude.ai 建议设为 https://claude.ai/api/mcp/auth_callback,https://claude.com/api/mcp/auth_callback。

TRUST_PROXY 可选反向代理后设为 1，避免 express-rate-limit 拒绝 X-Forwarded-For 头。

CORS_ORIGINS 可选允许的 CORS 来源（如 https://claude.ai），默认关闭，仅在浏览器客户端直连时设置。

对于 Claude Desktop（本地）：运行 npx openclaw-mcp，然后将二进制文件配置添加到 claude_desktop_config.json 中，设置环境变量。对于 Claude.ai（远程）：通过 Docker 或 CLI 使用 HTTP 传输，启用认证，并配置 OAuth 重定向 URI。

claude_desktop_config.json

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": [
        "openclaw-mcp"
      ],
      "env": {
        "OPENCLAW_URL": "http://127.0.0.1:18789",
        "OPENCLAW_GATEWAY_TOKEN": "your-gateway-token",
        "OPENCLAW_MODEL": "openclaw",
        "OPENCLAW_TIMEOUT_MS": "300000"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "openclaw": {
      "command": "npx",
      "args": [
        "openclaw-mcp"
      ],
      "env": {
        "OPENCLAW_URL": "http://127.0.0.1:18789",
        "OPENCLAW_GATEWAY_TOKEN": "your-gateway-token",
        "OPENCLAW_MODEL": "openclaw",
        "OPENCLAW_TIMEOUT_MS": "300000"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add openclaw -e OPENCLAW_URL=http://127.0.0.1:18789 -e OPENCLAW_GATEWAY_TOKEN=your-gateway-token -e OPENCLAW_MODEL=openclaw -e OPENCLAW_TIMEOUT_MS=300000 -- npx openclaw-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 openclaw_chat、openclaw_status、openclaw_instances 等七个工具；运行 openclaw_status，如果返回网关健康信息，说明与 OpenClaw 网关的连接已成功。

常见排障

确保连接器 URL 以 `/mcp` 结尾，否则可能在 OAuth 后返回 404。
确保 `MCP_ISSUER_URL` 设置为您的公共 HTTPS URL 并启用 `TRUST_PROXY`，以防认证问题。
如果您看到 `Unregistered redirect_uri`，请检查 `MCP_REDIRECT_URIS` 是否与 Claude 的回调路径精确匹配。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

问一下 OpenClaw：'Deploy status 是什么？'，并把它的回复转述给我。
帮我检查 OpenClaw 网关的健康状态。
列出当前配置的所有 OpenClaw 实例。
把消息 'Run tests' 异步发给 dev 实例，然后告诉我任务的进度。

工具能力 7

openclaw_chat 写入

向 OpenClaw 发送消息并获取响应。

openclaw_status 只读

检查 OpenClaw 网关健康状态。

openclaw_instances 只读

列出所有配置的 OpenClaw 实例。

openclaw_chat_async 写入

异步发送消息，立即获取任务 ID。

openclaw_task_status 只读

检查任务进度并获取结果。

openclaw_task_list 只读

列出您的任务并进行过滤。

openclaw_task_cancel 写入

取消待处理的任务。

使用场景

通过 Claude 界面将任务委派给 OpenClaw 助手。

从单一 MCP 服务器编排多个 OpenClaw 实例（例如生产、暂存、开发）。

运行长时间操作（异步任务）而不阻塞响应。

支持客户端

Claude Desktop

Claude.ai

依据项目文档列出，未经本站实测。

详细介绍

OpenClaw MCP 服务器是一个安全的桥梁，通过 OAuth 2.1 认证，将 Claude.ai 或 Claude Desktop 连接到自托管的 OpenClaw 助手。它允许 Claude 将任务委派给 OpenClaw 实例，并支持同步和异步操作。该服务器支持多实例模式，允许从一个 MCP 服务器编排多个 OpenClaw 网关。