Локальный Claude в OpenClaw: MCP вместо нативных тулов

Коротко

Локальные Claude-турны используют фильтруемые MCP-инструменты без чередования с нативными файловыми тулами Claude.
MCP-тулы получают формат <safe-server>__<safe-tool>. tools.allow и tools.deny определяют листинг, а лимит текущего тура отклоняет вызов до обращения к серверу.

Сверено с документацией OpenClaw 2026.10.7, 27 октября 2026.

Локальные Claude-турны не чередуют нативные файловые инструменты Claude и MCP-замены OpenClaw. MCP-мост оставляет единый набор инструментов для обычных сообщений и подтверждённых завершений дочерних агентов.

Как работает MCP-мост

OpenClaw берёт серверы из mcp.servers и включённые bundle-MCP серверы. CLI не подключается к ним напрямую: Gateway предоставляет инструменты через loopback-мост.

<safe-server>__<safe-tool>

Фильтры tools.allow и tools.deny решают, какие инструменты попадут в каталог сессии. Более узкий лимит текущего тура не удаляет определение, а отклоняет сам вызов.

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-5-5": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

Фильтр выбирает доступные инструменты, но проверка разрешения повторяется перед каждым запросом. Это касается вызовов инструментов, чтения ресурсов и получения промптов.

Что отключено на управляемых турах

Управляемые туры не подхватывают пользовательские настройки Claude, файлы инструкций, автопамять, пользовательские хуки, плагины, Chrome и MCP-серверы, настроенные только в Claude. OpenClaw передаёт собственные инструкции, выбранные skills и отфильтрованные инструменты.

Нативные возможности Claude не заменяют управляемую поверхность инструментов. Серверы из mcp.servers и включённые bundle-MCP серверы остаются доступными.

openclaw mcp doctor docs --probe
openclaw mcp status --verbose

Как проверить переход

Добавьте MCP-сервер в mcp.servers и включите его.
Запустите openclaw mcp doctor docs --probe, чтобы проверить живое соединение и опубликованные инструменты.
Начните новый тур локального Claude-агента и проверьте имена в формате <safe-server>__<safe-tool>.
Убедитесь, что скилл использует обновлённые имена, а запрещённый инструмент отклоняется политикой.

После изменения состава MCP-инструментов OpenClaw создаёт свежую нативную CLI-сессию. В журнале появляется сообщение cli session reset: provider=<backend> reason=prompt-tools.

cli session reset: provider=<backend> reason=prompt-tools

Повторная отправка промпта сама по себе не обновляет кеш каталога тулов.

Где ломается и когда не применять

Первый тур существующей сессии запускает новую нативную CLI-сессию из-за изменившихся имён тулов.
Серверы с областью действия отправителя требуют проверенного отправителя и не предлагаются на управляемых турах.
Явный выбор нативных инструментов, выполнение в node, side questions и изолированные завершения без инструментов сохраняют собственные контракты.
Для путей с нативным выполнением плагинов OpenClaw по-прежнему может использовать нативный поиск skills через --plugin-dir.