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.

• uruchamiać OpenClaw jako serwer MCP za pomocą openclaw mcp serve
• zarządzać należącymi do OpenClaw definicjami wychodzących serwerów MCP za pomocą list, show, set i unset

• serve to OpenClaw działający jako serwer MCP
• list / show / set / unset to OpenClaw działający jako rejestr po stronie klienta MCP dla innych serwerów MCP, z których jego runtime’y mogą korzystać później

​

OpenClaw jako serwer MCP

​

Kiedy używać serve

• Codex, Claude Code lub inny klient MCP ma komunikować się bezpośrednio z konwersacjami kanałów obsługiwanymi przez OpenClaw
• masz już lokalny lub zdalny OpenClaw Gateway z routowanymi sesjami
• chcesz jednego serwera MCP, który działa z backendami kanałów OpenClaw, zamiast uruchamiać osobne mosty dla każdego kanału

​

Jak to działa

​

Wybierz tryb klienta

​

Co udostępnia serve

• channel
• metadane odbiorcy lub miejsca docelowego
• opcjonalne accountId
• opcjonalne threadId

• wyświetlać ostatnie routowane konwersacje
• odczytywać ostatnią historię transkrypcji
• czekać na nowe zdarzenia przychodzące
• wysyłać odpowiedź tą samą trasą
• widzieć żądania zatwierdzenia, które docierają, gdy most jest połączony

​

Użycie

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

​

Narzędzia mostu

​

Model zdarzeń

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

​

Powiadomienia kanału Claude

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

• przychodzące wiadomości transkrypcji user są przekazywane jako notifications/claude/channel
• żądania uprawnień Claude odebrane przez MCP są śledzone w pamięci
• jeśli powiązana konwersacja wyśle później yes abcde lub no abcde, most konwertuje to na notifications/claude/channel/permission
• te powiadomienia istnieją tylko w sesji na żywo; jeśli klient MCP się rozłączy, nie ma celu push

​

Konfiguracja klienta MCP

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

​

Opcje

​

Bezpieczeństwo i granica zaufania

• listy dozwolonych nadawców, parowanie i zaufanie na poziomie kanału nadal należą do bazowej konfiguracji kanału OpenClaw
• messages_send może odpowiadać tylko przez istniejącą zapisaną trasę
• stan zatwierdzeń jest tylko na żywo/w pamięci dla bieżącej sesji mostu
• uwierzytelnianie mostu powinno używać tych samych mechanizmów tokenu lub hasła Gateway, którym ufałbyś w przypadku każdego innego zdalnego klienta Gateway

​

Testowanie

pnpm test:docker:mcp-channels

• uruchamia wstępnie zasilony kontener Gateway
• uruchamia drugi kontener, który startuje openclaw mcp serve
• weryfikuje wykrywanie konwersacji, odczyty transkrypcji, odczyty metadanych załączników, zachowanie kolejki zdarzeń na żywo i routing wysyłania wychodzącego
• waliduje powiadomienia kanału i uprawnień w stylu Claude przez rzeczywisty most MCP stdio

​

Rozwiązywanie problemów

​

OpenClaw jako rejestr klientów MCP

​

Zapisane definicje serwerów MCP

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

• list sortuje nazwy serwerów.
• show bez nazwy wypisuje pełny skonfigurowany obiekt serwera MCP.
• set oczekuje jednej wartości obiektu JSON w wierszu poleceń.
• Użyj transport: "streamable-http" dla serwerów MCP Streamable HTTP. openclaw mcp set normalizuje też natywne dla CLI type: "http" do tego samego kanonicznego kształtu konfiguracji w celu zgodności.
• unset kończy się niepowodzeniem, jeśli nazwany serwer nie istnieje.

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"
      }
    }
  }
}

​

Transport stdio

​

Transport SSE / HTTP

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

​

Transport Streamable HTTP

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

​

Obecne ograniczenia

• odnajdywanie konwersacji zależy od istniejących metadanych trasy sesji Gateway
• brak ogólnego protokołu push poza adapterem specyficznym dla Claude
• nie ma jeszcze narzędzi edycji wiadomości ani reakcji
• transport HTTP/SSE/streamable-http łączy się z jednym zdalnym serwerem; nie ma jeszcze multipleksowanego upstreamu
• permissions_list_open obejmuje tylko zatwierdzenia zaobserwowane, gdy most jest połączony

​

Powiązane

• Dokumentacja CLI
• Plugins