OpenClaw MCP Server

OpenClaw MCP Server

freemaMIT
171 звёзд24 форков
OpenClaw MCP Server — это мост, соединяющий Claude AI (веб-версию или десктопное приложение) с саморазмещённым экземпляром OpenClaw. OpenClaw — это AI-ассистент, который умеет выполнять действия: запускать код, обращаться к внешним системам, работать с репозиториями. Вся связь защищена современным протоколом OAuth 2.1. Сервер превращает ваш чат с Claude в полноценный пункт управления. Вы даёте задание, Claude перепоручает его своему боту Claw, а тот выполняет работу: запускает Claude Code для ревью кода, деплоит приложения или собирает данные. Результат возвращается в тот же диалог. Вам не нужно переключаться между окнами и каналами — всё происходит в одном месте.

Установка

npx -y openclaw-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикfreema
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Соединение Claude AI с вашим личным сервером OpenClaw по протоколу MCP.
  • Безопасный вход по OAuth 2.1: доступ к OpenClaw получают только авторизованные пользователи.
  • Делегирование задач: вы пишете запрос в Claude, а сервер передаёт его OpenClaw для выполнения.
  • Автоматический запуск Claude Code через OpenClaw для рефакторинга, отладки и написания кода.
  • Поддержка Streamable HTTP (эндпоинт /mcp) для работы с веб-версией Claude.ai.
  • Гибкая конфигурация через переменные окружения: URL OpenClaw, модель, токены шлюза.
  • Готовая сборка Docker Compose с изоляцией (read-only, no-new-privileges) для безопасного продакшена.
  • Быстрый старт через npx без установки Docker.
  • Ограничение CORS: сервер принимает запросы только с домена claude.ai.

Как подключить

Шаг 1. Установка

Самый быстрый способ — запустить сервер через npx:

npx -y openclaw-mcp

Для продакшена используйте Docker. Скачайте готовый образ:

docker pull ghcr.io/freema/openclaw-mcp:latest

Затем настройте docker-compose.yml с переменными окружения, сгенерируйте секреты и запустите контейнер.

Шаг 2. Настройка Claude Desktop

Отредактируйте файл конфигурации claude_desktop_config.json:

{ "mcpServers": { "openclaw": { "command": "npx", "args": ["-y", "openclaw-mcp"], "env": { "OPENCLAW_URL": "http://localhost:18789", "OPENCLAW_GATEWAY_TOKEN": "ваш_токен_шлюза", "OPENCLAW_MODEL": "openclaw", "AUTH_ENABLED": "true", "MCP_CLIENT_ID": "openclaw", "MCP_CLIENT_SECRET": "сгенерированный_секрет" } } } }

Примечание: Замените localhost:18789 на адрес вашего сервера OpenClaw. Токены и секреты сгенерируйте заранее.

Шаг 3. Перезагрузка

Закройте и снова откройте Claude Desktop. В списке доступных инструментов появится подключение к OpenClaw.

Для веб-версии Claude.ai укажите внешний URL сервера, который заканчивается на /mcp, и данные OAuth-клиента (Client ID и Client Secret).

Примеры запросов

  • «Попроси OpenClaw найти в репозитории все TODO-комментарии и создать по ним задачи в трекере».
  • «Спроси у моего OpenClaw, какие микросервисы сейчас работают на staging и есть ли там ошибки в логах».
  • «Запусти через OpenClaw автотесты для сервиса payments и покажи отчёт о покрытии».
  • «Делегируй OpenClaw задачу: сделать rebase моей ветки на main и запустить финальную сборку».

Технические детали

  • Язык разработки: TypeScript
  • Транспорт: stdio (Claude Desktop), HTTP Streamable (Claude.ai)
  • Аутентификация: OAuth 2.1
  • Лицензия: MIT
  • Разработчик: freema
  • Репозиторий: GitHub (171 звезда)
  • Совместимость: Claude Desktop, Claude.ai

Поделиться