OpenClaw MCP
Мост между Claude.ai и вашим OpenClaw: чат делегирует задачи своему ассистенту по OAuth 2.1 через HTTPS
- 188 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Мост передает сообщения ассистенту с его правами, а он может запускать команды и других агентов
- Токен шлюза и секрет клиента OAuth дают управление вашим ассистентом
Установка
- Работает в
Ручная установка
npx openclaw-mcpЛокальный запуск для Claude Desktop; адрес и токен шлюза задают переменными.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Мост передает сообщения ассистенту с его правами, а он может запускать команды и других агентов
- Токен шлюза и секрет клиента OAuth дают управление вашим ассистентом
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер соединяет Claude.ai или Claude Desktop с вашим ассистентом OpenClaw, который работает на вашей машине. Claude отправляет сообщение через инструмент `openclaw_chat`, а OpenClaw выполняет работу: например, запускает Claude Code, чтобы поправить ошибку. Для долгих задач есть асинхронные инструменты: `openclaw_chat_async` ставит сообщение в очередь и сразу возвращает номер задачи, а `openclaw_task_status`, `openclaw_task_list` и `openclaw_task_cancel` следят за ходом. Мост запускают в Docker или через `npx`. Для Claude.ai он принимает вход по OAuth 2.1 и стоит за вашим обратным прокси с HTTPS. Несколько экземпляров OpenClaw (рабочий, тестовый, разработческий) регистрируются в одной переменной `OPENCLAW_INSTANCES`, у каждого свой адрес и свой токен.
Для кого. Владельцам самохостного ассистента OpenClaw, которые хотят управлять им из веб-чата Claude.ai, а не только из мессенджеров.
Подходит, если
- Чат в Claude.ai передает задачу домашнему ассистенту, который сам запускает Claude Code и чинит ошибку
- Долгую работу ставят в очередь через `openclaw_chat_async` и проверяют статус позже
- У команды есть рабочий и тестовый экземпляры OpenClaw, и запрос нужно направить в один из них
- Состояние шлюза OpenClaw проверяют прямо из диалога инструментом `openclaw_status`
Не подходит, если
- OpenClaw не установлен: мост без него ничего не делает
- Нужен прямой доступ Claude к файлам и оболочке без второго ассистента: подойдут штатные серверы файлов
- Нет домена и HTTPS для Claude.ai: удаленному подключению нужен обратный прокси
Пример запроса к агенту
Через OpenClaw запусти Claude Code в репозитории api, найди причину падения тестов и сообщи, что нужно поправитьMCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Переменные окружения
OPENCLAW_URLобязательная- Адрес шлюза OpenClaw.
OPENCLAW_GATEWAY_TOKENобязательная, секрет- Токен шлюза OpenClaw.
MCP_CLIENT_SECRETсекрет- Секрет клиента OAuth для режима HTTP.
Ограничения
Для Claude.ai адрес коннектора обязан оканчиваться на `/mcp`, иначе после входа придет ошибка 404. За обратным прокси нужны `MCP_ISSUER_URL` и `TRUST_PROXY=1`, а список `MCP_REDIRECT_URIS` стоит ограничить адресами возврата Claude. Мост передает сообщения вашему ассистенту вместе с его правами, поэтому заведите отдельного агента OpenClaw через `OPENCLAW_AGENT_ID` и не отдавайте основного с доступом к оболочке. Режим `--transport sse` устарел, вместо него используют `--transport http`.
Как отключить. Удалите коннектор в Claude.ai или в клиенте, остановите контейнер (`docker compose down`) и смените токен шлюза OpenClaw.
Частые вопросы
Как подключить OpenClaw к Claude.ai?
Запустите мост в Docker за HTTPS-прокси и добавьте в Claude.ai свой коннектор на `https://ваш-домен/mcp` с `MCP_CLIENT_ID=openclaw` и вашим `MCP_CLIENT_SECRET`. Адрес должен оканчиваться на `/mcp`.
Можно ли запустить без Docker?
Да. Для Claude Desktop достаточно `npx openclaw-mcp` и блока в `claude_desktop_config.json`, а для Claude.ai без Docker запускают `npx openclaw-mcp --transport http --port 3000` с переменными OAuth.
Какие инструменты есть у моста?
Синхронные `openclaw_chat`, `openclaw_status` и `openclaw_instances`, а также асинхронные `openclaw_chat_async`, `openclaw_task_status`, `openclaw_task_list` и `openclaw_task_cancel`.
Как подключить несколько экземпляров OpenClaw?
Передайте JSON-список в `OPENCLAW_INSTANCES` с полями имени и адреса для каждого экземпляра. У каждого свои адрес, авторизация и тайм-аут.
Безопасно ли отдавать мост наружу?
Мост слушает только `127.0.0.1` и ждет обратный прокси с TLS. Защищают вход OAuth 2.1, проверка CORS и список адресов возврата, но права дает сам ассистент OpenClaw, поэтому заведите для него отдельного агента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыКомпактная замена OpenClaw: личный ассистент на Claude Agent SDK, агенты в изолированных контейнерах, мессенджеры добавляются скиллами
MCP самохостной панели EmperorClaw: Claude Code и Codex читают знания компании, задачи и клиентов в выданной области доступа
Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
CLI подключает локальных агентов к общему облачному хранилищу сессий, памяти, навыков и MCP-коннекторов.
Один рантайм для Claude Code, Codex, OpenCode и других: работа принята, только если пройдены проверки, которые агент не писал
CLI, который на лету превращает любой MCP-сервер, спецификацию OpenAPI или GraphQL-эндпоинт в набор команд без генерации кода
Коротко о README
README объясняет, зачем нужен мост, и дает три способа запуска: Docker, локально для Claude Desktop и удаленно для Claude.ai без Docker. Дальше идут схема, список синхронных и асинхронных инструментов и настройка нескольких экземпляров.