MCP

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• запускати OpenClaw як MCP-сервер за допомогою openclaw mcp serve
• керувати вихідними визначеннями MCP-серверів, що належать OpenClaw, за допомогою list, show, set і unset

• serve — це OpenClaw, що діє як MCP-сервер
• list / show / set / unset — це OpenClaw, що діє як клієнтський реєстр MCP для інших 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 abcde або no abcde, міст перетворює це на 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

• запускає контейнер Gateway із початковими даними
• запускає другий контейнер, який породжує openclaw mcp serve
• перевіряє виявлення розмов, читання стенограми, читання метаданих вкладень, поведінку живої черги подій і маршрутизацію вихідних надсилань
• перевіряє сповіщення каналу та дозволів у стилі Claude через справжній stdio MCP-міст

​

Усунення несправностей

​

OpenClaw як реєстр MCP-клієнта

​

Збережені визначення MCP-серверів

• openclaw mcp list
• openclaw mcp show [name]
• openclaw mcp set <name> <json>
• openclaw mcp unset <name>

• list сортує імена серверів.
• show без імені виводить повний налаштований об’єкт MCP-сервера.
• set очікує одне значення JSON-об’єкта в командному рядку.
• Використовуйте transport: "streamable-http" для MCP-серверів Streamable HTTP. openclaw mcp set також нормалізує нативне для CLI type: "http" до тієї самої канонічної форми конфігурації для сумісності.
• unset завершується помилкою, якщо сервер із таким іменем не існує.

openclaw mcp list
openclaw mcp show context7 --json
openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'
openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'
openclaw mcp unset context7

{
  "mcp": {
    "servers": {
      "context7": {
        "command": "uvx",
        "args": ["context7-mcp"]
      },
      "docs": {
        "url": "https://mcp.example.com",
        "transport": "streamable-http"
      }
    }
  }
}

​

Транспорт stdio

​

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

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

​

Транспорт Streamable HTTP

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

​

Поточні обмеження

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

​

Пов’язане

• Довідник CLI
• Plugins