适合谁
- 希望将自托管 OpenClaw 与 Claude 集成的用户
- 需要从统一接口管理多个 OpenClaw 实例的用户
O
63FMRS · C
服务器提供与 OpenClaw 的无缝集成，支持同步和异步任务以及多实例。注重安全，提供 OAuth 和 CORS 控制。部署需要仔细配置。
OpenClaw MCP 服务器是一个安全的桥梁，通过 OAuth 2.1 认证，将 Claude.ai 或 Claude Desktop 连接到自托管的 OpenClaw 助手。它允许 Claude 将任务委派给 OpenClaw 实例，并支持同步和异步操作。该服务器支持多实例模式，允许从一个 MCP 服务器编排多个 OpenClaw 网关。
工具能力
openclaw_chat
向 OpenClaw 发送消息并获取响应。
openclaw_status
检查 OpenClaw 网关健康状态。
openclaw_instances
列出所有配置的 OpenClaw 实例。
openclaw_chat_async
异步发送消息，立即获取任务 ID。
openclaw_task_status
检查任务进度并获取结果。
openclaw_task_list
列出您的任务并进行过滤。
openclaw_task_cancel
取消待处理的任务。
安装接入
对于 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"
}
}
}
}
选型与风险
不适合谁
- 没有 OpenClaw 实例的用户
- 需要无认证生产部署的用户
所需权限
- 需要访问 OpenClaw 网关 HTTP API
- 需要网关令牌（Bearer token）进行认证
风险与副作用
- 如果没有正确保护，生产环境中的安全风险（必须启用认证）。
- 如果配置不当，OAuth 回调存在暴露风险；建议设置精确的重定向 URI。
- 暴露网关 URL 和密钥可能带来安全风险。
常见排障
- 确保连接器 URL 以 `/mcp` 结尾，否则可能在 OAuth 后返回 404。
- 确保 `MCP_ISSUER_URL` 设置为您的公共 HTTPS URL 并启用 `TRUST_PROXY`，以防认证问题。
- 如果您看到 `Unregistered redirect_uri`，请检查 `MCP_REDIRECT_URIS` 是否与 Claude 的回调路径精确匹配。
使用场景
通过 Claude 界面将任务委派给 OpenClaw 助手。
从单一 MCP 服务器编排多个 OpenClaw 实例（例如生产、暂存、开发）。
运行长时间操作（异步任务）而不阻塞响应。
支持客户端
Claude Desktop完整支持
Claude.ai完整支持