OpenClaw MCP Server — MCP-сервер для Claude Code: мост к OpenClaw
Связывает Claude.ai и Claude Desktop с вашим OpenClaw через OAuth 2.1. Пригодится, если хотите поручать задачи боту прямо из чата.
claude mcp add --env OPENCLAW_URL=<OPENCLAW_URL> --env OPENCLAW_GATEWAY_TOKEN=<OPENCLAW_GATEWAY_TOKEN> --env OPENCLAW_MODEL=<OPENCLAW_MODEL> --env OPENCLAW_TIMEOUT_MS=<OPENCLAW_TIMEOUT_MS> --transport stdio openclaw-mcp-server -- npx -y openclaw-mcpЧто делает OpenClaw MCP Server
Сервер поднимает мост между клиентом MCP и шлюзом OpenClaw на порту 18789. Чат отправляет задачу боту, а тот берётся за остальное — вплоть до запуска Claude для правок. Синхронные инструменты openclaw_chat, openclaw_status и openclaw_instances дают ответ сразу, асинхронные openclaw_chat_async, openclaw_task_status, openclaw_task_list и openclaw_task_cancel ставят задачу в очередь и возвращают task_id.
Запускать можно двумя путями. Docker-образ лежит в GitHub Container Registry, конфигурация собирается в docker-compose.yml с переменными OPENCLAW_URL, OPENCLAW_GATEWAY_TOKEN и секретом MCP_CLIENT_SECRET. Для Claude Desktop хватит npx openclaw-mcp и записи в конфиге. Есть и HTTP-режим за реверс-прокси.
За прокси придётся выставить MCP_ISSUER_URL на публичный HTTPS-адрес и TRUST_PROXY=1. Без первого OAuth-метаданные отдают http://localhost:3000, и клиент не проходит авторизацию. Без второго express-rate-limit спотыкается о заголовок X-Forwarded-For и /token падает с ERR_ERL_UNEXPECTED_X_FORWARDED_FOR. В Claude.ai адрес коннектора обязан заканчиваться на /mcp — голый домен вернёт 404 после OAuth. Задачи привязаны к соединению: в HTTP-режиме чужой task_id для клиента выглядит как «not found».
Какие задачи решает
- отправлять задачи боту OpenClaw из чата Claude.ai
- проверить, жив ли шлюз OpenClaw
- поставить долгую операцию в очередь и забрать результат по task_id
- отменить зависшую задачу
- посмотреть список настроенных инстансов OpenClaw
Примеры запросов агенту
- Отправь через openclaw_chat задачу боту и покажи ответ
- Проверь статус шлюза OpenClaw через openclaw_status
- Поставь эту задачу в очередь через openclaw_chat_async и верни task_id
Как установить OpenClaw MCP Server
Командой платформы
claude mcp add --env OPENCLAW_URL=<OPENCLAW_URL> --env OPENCLAW_GATEWAY_TOKEN=<OPENCLAW_GATEWAY_TOKEN> --env OPENCLAW_MODEL=<OPENCLAW_MODEL> --env OPENCLAW_TIMEOUT_MS=<OPENCLAW_TIMEOUT_MS> --transport stdio openclaw-mcp-server -- npx -y openclaw-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add openclaw-mcp-server --env OPENCLAW_URL=<OPENCLAW_URL> --env OPENCLAW_GATEWAY_TOKEN=<OPENCLAW_GATEWAY_TOKEN> --env OPENCLAW_MODEL=<OPENCLAW_MODEL> --env OPENCLAW_TIMEOUT_MS=<OPENCLAW_TIMEOUT_MS> -- npx -y openclaw-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"openclaw-mcp-server": {
"command": "npx",
"args": [
"-y",
"openclaw-mcp"
],
"env": {
"OPENCLAW_URL": "<OPENCLAW_URL>",
"OPENCLAW_GATEWAY_TOKEN": "<OPENCLAW_GATEWAY_TOKEN>",
"OPENCLAW_MODEL": "<OPENCLAW_MODEL>",
"OPENCLAW_TIMEOUT_MS": "<OPENCLAW_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"openclaw-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"openclaw-mcp"
],
"env": {
"OPENCLAW_URL": "<OPENCLAW_URL>",
"OPENCLAW_GATEWAY_TOKEN": "<OPENCLAW_GATEWAY_TOKEN>",
"OPENCLAW_MODEL": "<OPENCLAW_MODEL>",
"OPENCLAW_TIMEOUT_MS": "<OPENCLAW_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OPENCLAW_URL=<OPENCLAW_URL> -e OPENCLAW_GATEWAY_TOKEN=<OPENCLAW_GATEWAY_TOKEN> -e OPENCLAW_MODEL=<OPENCLAW_MODEL> -e OPENCLAW_TIMEOUT_MS=<OPENCLAW_TIMEOUT_MS> openclaw-mcp-server npx -y openclaw-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о OpenClaw MCP Server
Как установить OpenClaw MCP Server в Claude Code?
Добавьте сервер командой claude mcp add openclaw-mcp -e OPENCLAW_URL=<OPENCLAW_URL> -e OPENCLAW_GATEWAY_TOKEN=<OPENCLAW_GATEWAY_TOKEN> -- npx -y openclaw-mcp.
Что делает OpenClaw MCP Server?
Прокидывает инструменты OpenClaw в клиент MCP: чат, проверку статуса, список инстансов и очередь асинхронных задач с отменой.
Почему OAuth не проходит за реверс-прокси?
Нужно задать MCP_ISSUER_URL с публичным HTTPS-адресом и TRUST_PROXY=1. Иначе метаданные указывают на localhost, а /token падает на заголовке X-Forwarded-For.
