MCP

• запускает OpenClaw как сервер MCP с помощью openclaw mcp serve
• управляет определениями исходящих серверов MCP, которыми управляет OpenClaw, с помощью list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload и unset

​

Выбор подходящего пути MCP

​

OpenClaw как сервер MCP

​

Когда использовать serve

• Codex, Claude Code или другой клиент MCP должен напрямую взаимодействовать с беседами каналов на базе OpenClaw
• у вас уже есть локальный или удалённый OpenClaw Gateway с маршрутизируемыми сеансами
• вам нужен один сервер MCP, работающий со всеми серверными реализациями каналов OpenClaw, вместо отдельных мостов для каждого канала

​

Принцип работы

​

Выбор режима клиента

​

Что предоставляет serve

• channel
• метаданные получателя или назначения
• необязательный accountId
• необязательный threadId

• вывести список недавних маршрутизируемых бесед
• прочитать недавнюю историю расшифровки
• ожидать новые входящие события
• отправить ответ по тому же маршруту
• просмотреть запросы на подтверждение, поступившие во время подключения моста

​

Использование

openclaw mcp serve

openclaw mcp serve --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

openclaw mcp serve --url wss://gateway-host:18789 --password-file ~/.openclaw/gateway.password

openclaw mcp serve --verbose
openclaw mcp serve --claude-channel-mode off

​

Инструменты моста

​

Модель событий

• message
• exec_approval_requested
• exec_approval_resolved
• plugin_approval_requested
• plugin_approval_resolved
• claude_permission_request

​

Уведомления канала Claude

• notifications/claude/channel
• notifications/claude/channel/permission

• входящие сообщения расшифровки user перенаправляются как notifications/claude/channel
• запросы разрешений Claude, полученные через MCP, отслеживаются в памяти
• если владелец команды в связанной беседе позднее отправляет yes <id> или no <id> (<id> — это 5-буквенный идентификатор запроса без l), мост преобразует это в notifications/claude/channel/permission
• эти уведомления существуют только в активном сеансе; если клиент MCP отключается, целевой объект для push-уведомлений отсутствует

​

Конфигурация клиента MCP

{
  "mcpServers": {
    "openclaw": {
      "command": "openclaw",
      "args": [
        "mcp",
        "serve",
        "--url",
        "wss://gateway-host:18789",
        "--token-file",
        "/path/to/gateway.token"
      ]
    }
  }
}

​

Параметры

​

Безопасность и граница доверия

• списки разрешённых отправителей, сопряжение и доверие на уровне канала по-прежнему определяются базовой конфигурацией канала OpenClaw
• messages_send может отвечать только через существующий сохранённый маршрут
• состояние подтверждений существует только в оперативной памяти и только в рамках текущего сеанса моста
• для аутентификации моста следует использовать те же механизмы токена или пароля Gateway, которым вы доверили бы любой другой удалённый клиент Gateway

​

Тестирование

pnpm test:docker:mcp-channels

​

Устранение неполадок

​

OpenClaw как реестр клиентов MCP

​

Сохранённые определения серверов MCP

• openclaw mcp list
• openclaw mcp show [name]
• openclaw mcp status [--verbose]
• openclaw mcp doctor [name] [--probe]
• openclaw mcp probe [name]
• openclaw mcp add <name> [flags]
• openclaw mcp set <name> <json>
• openclaw mcp configure <name> [flags]
• openclaw mcp tools <name> [--include csv] [--exclude csv] [--clear]
• openclaw mcp login <name> [--code code]
• openclaw mcp logout <name>
• openclaw mcp reload
• openclaw mcp unset <name>

• list сортирует имена серверов.
• show без имени выводит полный настроенный объект сервера MCP.
• status классифицирует настроенные транспорты без подключения. --verbose включает разрешённые сведения о запуске, тайм-аутах, OAuth, фильтрах и параллельных вызовах.
• doctor выполняет статические проверки без подключения. Добавьте --probe, если команда также должна проверить подключение активных серверов.
• probe подключается и сообщает количество инструментов, поддержку ресурсов и подсказок, поддержку изменений списка и диагностические сведения.
• add принимает флаги stdio, такие как --command, --arg, --env и --cwd, либо флаги HTTP, такие как --url, --transport, --header, --auth oauth, а также флаги TLS, тайм-аутов и выбора инструментов.
• set ожидает в командной строке одно значение объекта JSON.
• configure обновляет состояние включения, фильтры инструментов, тайм-ауты, OAuth, TLS и указания параллельных вызовов инструментов, не заменяя всё определение сервера. Добавьте --probe, чтобы проверить обновлённый сервер перед сохранением.
• tools обновляет фильтры инструментов для каждого сервера. Записи включения и исключения представляют собой имена инструментов MCP и простые шаблоны *.
• login запускает процесс OAuth для HTTP-серверов, настроенных с помощью auth: "oauth". При первом запуске выводится URL авторизации; после подтверждения запустите команду повторно с --code.
• logout очищает сохранённые учётные данные OAuth для указанного сервера, не удаляя сохранённое определение сервера.
• reload освобождает кэшированные внутрипроцессные среды выполнения MCP только для текущего процесса CLI. Для процессов Gateway или агента, работающих в другом процессе, по-прежнему требуется собственная перезагрузка или перезапуск.
• Используйте transport: "streamable-http" для серверов MCP Streamable HTTP. openclaw mcp set также преобразует собственный для CLI type: "http" в ту же каноническую форму конфигурации для совместимости.
• unset завершается с ошибкой, если указанный сервер не существует.

openclaw mcp list
openclaw mcp show context7 --json
openclaw mcp status --verbose
openclaw mcp doctor --probe
openclaw mcp probe context7 --json
openclaw mcp add memory --command npx --arg -y --arg @modelcontextprotocol/server-memory
openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'
openclaw mcp tools context7 --include 'resolve-library-id,get-library-docs'
openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'
openclaw mcp configure docs --timeout 20 --connect-timeout 5 --include 'search,read_*'
openclaw mcp configure docs --auth oauth --oauth-scope 'docs.read'
openclaw mcp login docs
openclaw mcp logout docs
openclaw mcp unset context7

​

Распространённые конфигурации серверов

openclaw mcp add files \
  --command npx \
  --arg -y \
  --arg @modelcontextprotocol/server-filesystem \
  --arg "$HOME/Documents" \
  --include 'read_file,list_directory,search_files'
openclaw mcp doctor files --probe

openclaw mcp add memory \
  --command npx \
  --arg -y \
  --arg @modelcontextprotocol/server-memory
openclaw mcp probe memory --json

openclaw mcp add local-tools \
  --command node \
  --arg ./dist/mcp-server.js \
  --cwd /srv/openclaw-tools \
  --env API_BASE=https://internal.example
openclaw mcp status --verbose

openclaw mcp add docs \
  --url https://mcp.example.com/mcp \
  --transport streamable-http \
  --auth oauth \
  --oauth-scope docs.read \
  --timeout 20 \
  --connect-timeout 5 \
  --include 'search,read_*'
openclaw mcp doctor docs --probe

openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
openclaw mcp tools cua-driver --include 'list_apps,observe,click,type'
openclaw mcp doctor cua-driver --probe

​

Форматы вывода JSON

{
  "path": "/home/user/.openclaw/openclaw.json",
  "servers": [
    {
      "name": "docs",
      "configured": true,
      "enabled": true,
      "ok": true,
      "transport": "streamable-http",
      "launch": "streamable-http https://mcp.example.com/mcp",
      "auth": "oauth",
      "authStatus": {
        "hasTokens": true,
        "hasClientInformation": true,
        "hasCodeVerifier": false,
        "hasDiscoveryState": true,
        "hasLastAuthorizationUrl": false
      },
      "requestTimeoutMs": 20000,
      "connectionTimeoutMs": 5000,
      "toolFilter": {
        "include": ["search", "read_*"],
        "exclude": []
      },
      "supportsParallelToolCalls": true
    }
  ]
}

{
  "ok": true,
  "path": "/home/user/.openclaw/openclaw.json",
  "servers": [
    {
      "name": "docs",
      "ok": true,
      "issues": [
        {
          "level": "warning",
          "message": "Учётные данные OAuth не авторизованы; выполните openclaw mcp login docs"
        }
      ]
    }
  ]
}

{
  "generatedAt": "2026-05-31T09:00:00.000Z",
  "servers": {
    "docs": {
      "launch": "streamable-http https://mcp.example.com/mcp",
      "tools": 2,
      "resources": true,
      "listChanged": {
        "tools": true,
        "resources": false,
        "prompts": false
      }
    }
  },
  "tools": ["docs__read_page", "docs__search"],
  "diagnostics": []
}

{
  "mcp": {
    "servers": {
      "context7": {
        "command": "uvx",
        "args": ["context7-mcp"]
      },
      "docs": {
        "url": "https://mcp.example.com",
        "transport": "streamable-http",
        "timeout": 20,
        "connectTimeout": 5,
        "supportsParallelToolCalls": true,
        "auth": "oauth",
        "oauth": {
          "scope": "docs.read"
        },
        "sslVerify": true,
        "clientCert": "/path/to/client.crt",
        "clientKey": "/path/to/client.key",
        "toolFilter": {
          "include": ["search_*"],
          "exclude": ["admin_*"]
        }
      }
    }
  }
}

​

Транспорт Stdio

​

Транспорт SSE / HTTP

{
  "mcp": {
    "servers": {
      "remote-tools": {
        "url": "https://mcp.example.com",
        "auth": "oauth",
        "timeout": 20,
        "headers": {
          "Authorization": "Bearer <token>"
        }
      }
    }
  }
}

​

Рабочий процесс OAuth

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"docs.read"}}'

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"authProfileId":"docs:mcp"}}'

openclaw mcp login docs

openclaw mcp login docs --code abc123

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

openclaw mcp logout docs

​

Потоковый транспорт HTTP

{
  "mcp": {
    "servers": {
      "streaming-tools": {
        "url": "https://mcp.example.com/stream",
        "transport": "streamable-http",
        "connectTimeout": 10,
        "timeout": 30,
        "headers": {
          "Authorization": "Bearer <token>"
        }
      }
    }
  }
}

​

Интерфейс управления

1. Откройте интерфейс управления и выберите MCP.
2. Просмотрите сводные карточки с общим количеством серверов, а также количеством включённых серверов, серверов с OAuth и серверов с фильтрами.
3. В строке каждого сервера можно просмотреть подсказки по транспорту, аутентификации, фильтрам, тайм-аутам и командам.
4. Переключайте состояние включения, если требуется сохранить определение, но исключить его из обнаружения во время выполнения.
5. Изменяйте раздел конфигурации mcp с ограниченной областью действия для структурных изменений, таких как добавление серверов, заголовков, TLS, метаданных OAuth или фильтров инструментов.
6. Выберите Save, чтобы только сохранить конфигурацию, или Save & Publish, чтобы применить её через путь конфигурации Gateway.
7. Выполните openclaw mcp doctor --probe, когда требуется подтвердить в реальном времени, что изменённый сервер запускается и возвращает список инструментов.

• во фрагментах команд имена серверов заключаются в кавычки, чтобы необычные имена можно было скопировать в оболочку
• отображаемые значения, похожие на URL, маскируются перед отрисовкой, если содержат встроенные учётные данные
• страница сама по себе не запускает транспорты MCP
• в зависимости от процесса, которому принадлежат клиенты MCP, активным средам выполнения может потребоваться openclaw mcp reload, публикация конфигурации Gateway или перезапуск процесса

​

Приложения MCP

openclaw config set mcp.apps.enabled true --strict-json

{
  mcp: {
    apps: {
      enabled: true,
      sandboxOrigin: "https://mcp-apps.example.com",
      sandboxPort: 18790,
    },
  },
}

{
  mcp: {
    apps: { enabled: true },
    servers: {
      "basic-react": {
        command: "npx",
        args: ["-y", "@modelcontextprotocol/server-basic-react", "--stdio"],
      },
    },
  },
}

• OpenClaw объявляет расширение io.modelcontextprotocol/ui только при включённых приложениях.
• Отображаются только ресурсы ui:// с MIME-типом, точно соответствующим text/html;profile=mcp-app.
• Размер ресурсов пользовательского интерфейса ограничен 2 MiB; они размещаются за прокси-схемой с двумя iframe в отдельном внешнем источнике, загружаются в непрозрачный внутренний источник приложения и ограничиваются политикой CSP, сформированной на основе метаданных ресурса.
• Инструменты, предназначенные только для приложений (_meta.ui.visibility: ["app"]), не включаются в списки инструментов модели. Приложения могут вызывать только доступные приложениям инструменты на принадлежащем им сервере, которые также соответствуют действующей политике инструментов OpenClaw для запуска, создавшего представление.
• Привязанные к источнику разрешения приложений, например на использование камеры, микрофона и геолокации, не предоставляются, пока внутренние документы приложений используют непрозрачные источники для изоляции приложений друг от друга.
• HTML приложения, полные аргументы инструментов и необработанные результаты хранятся в ограниченной десятиминутной аренде представления в памяти и не записываются на диск и не копируются в метаданные предварительного просмотра расшифровки. В расшифровке сохраняется только ограниченный дескриптор сервера, инструмента и ресурса, связанный с исходным идентификатором вызова инструмента. После перезапуска Gateway интерфейс управления может сверить этот дескриптор с расшифровкой аутентифицированного сеанса и повторно получить ресурс ui://; восстановленные представления доступны только для чтения, пока новый запуск не установит актуальные разрешения инструментов.
• openclaw security audit выводит предупреждение, пока мост включён. Отключите его с помощью openclaw config set mcp.apps.enabled false --strict-json, когда он не нужен.

​

Текущие ограничения

• обнаружение диалогов зависит от существующих метаданных маршрутов сеансов Gateway
• универсальный протокол отправки событий отсутствует, кроме адаптера для Claude
• инструменты редактирования сообщений и реакций пока отсутствуют
• транспорт HTTP/SSE/streamable-http подключается к одному удалённому серверу; мультиплексирование вышестоящих серверов пока не поддерживается
• permissions_list_open включает только подтверждения, зарегистрированные во время подключения моста

​

Связанные материалы

• Справочник CLI
• Плагины