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
• активним середовищам виконання може знадобитися openclaw mcp reload, публікація конфігурації Gateway або перезапуск процесу залежно від того, який процес керує клієнтами MCP

​

Застосунки 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
• Плагіни