MCP

openclaw mcp ma dwa zadania:

• uruchamianie OpenClaw jako serwera MCP za pomocą openclaw mcp serve
• zarządzanie definicjami wychodzących serwerów MCP zarządzanych przez OpenClaw za pomocą list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload i unset

serve oznacza OpenClaw działający jako serwer MCP. Pozostałe podpolecenia dotyczą OpenClaw działającego jako rejestr serwerów po stronie klienta MCP, z którego jego środowiska uruchomieniowe mogą później korzystać.

Gdy OpenClaw ma samodzielnie hostować sesję środowiska programistycznego i kierować to środowisko uruchomieniowe przez ACP, należy użyć openclaw acp.

Wybór właściwej ścieżki MCP

OpenClaw jako serwer MCP

Jest to ścieżka openclaw mcp serve.

Kiedy używać polecenia serve

Należy użyć openclaw mcp serve, gdy:

• Codex, Claude Code lub inny klient MCP ma komunikować się bezpośrednio z konwersacjami kanałów obsługiwanymi przez OpenClaw
• lokalny lub zdalny OpenClaw Gateway ze skierowanymi sesjami jest już dostępny
• potrzebny jest jeden serwer MCP działający ze wszystkimi backendami kanałów OpenClaw zamiast oddzielnych mostów dla każdego kanału

Zamiast tego należy użyć openclaw acp, gdy OpenClaw ma samodzielnie hostować środowisko programistyczne i przechowywać sesję agenta wewnątrz OpenClaw.

Sposób działania

openclaw mcp serve uruchamia serwer MCP korzystający ze standardowego wejścia i wyjścia. Proces ten należy do klienta MCP. Dopóki klient utrzymuje otwartą sesję standardowego wejścia i wyjścia, most łączy się przez WebSocket z lokalnym lub zdalnym OpenClaw Gateway i udostępnia skierowane konwersacje kanałów przez MCP.

Wybór trybu klienta

Elementy udostępniane przez serve

Most używa istniejących metadanych tras sesji Gateway do udostępniania konwersacji obsługiwanych przez kanały. Konwersacja pojawia się, gdy OpenClaw ma już stan sesji ze znaną trasą, zawierającą na przykład:

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

Dzięki temu klienci MCP mogą w jednym miejscu:

• wyświetlać listę ostatnich skierowanych konwersacji
• odczytywać ostatnią historię transkrypcji
• oczekiwać na nowe zdarzenia przychodzące
• wysyłać odpowiedź tą samą trasą
• wyświetlać żądania zatwierdzenia przychodzące podczas połączenia mostu

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 --verboseopenclaw mcp serve --claude-channel-mode off

Narzędzia mostu

Model zdarzeń

Most utrzymuje kolejkę zdarzeń w pamięci, dopóki pozostaje połączony.

Obecne typy zdarzeń:

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

Powiadomienia kanału Claude

Most może również udostępniać powiadomienia kanału przeznaczone dla Claude. Jest to odpowiednik adaptera kanału Claude Code w OpenClaw: standardowe narzędzia MCP pozostają dostępne, ale wiadomości przychodzące na żywo mogą również docierać jako powiadomienia MCP przeznaczone dla Claude.

Po włączeniu trybu kanału Claude serwer ogłasza eksperymentalne możliwości Claude i może emitować:

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

Obecne zachowanie mostu:

• przychodzące wiadomości transkrypcji user są przekazywane jako notifications/claude/channel
• żądania uprawnień Claude otrzymane przez MCP są śledzone w pamięci
• jeśli właściciel polecenia w połączonej konwersacji wyśle później yes <id> lub no <id> (<id> to 5-literowy identyfikator żądania, bez l), most przekształca to w notifications/claude/channel/permission
• te powiadomienia są dostępne wyłącznie w aktywnej sesji; po rozłączeniu klienta MCP nie istnieje cel powiadomień push

To zachowanie jest celowo dostosowane do konkretnego klienta. Ogólni klienci MCP powinni korzystać ze standardowych narzędzi odpytywania.

Konfiguracja klienta MCP

Przykładowa konfiguracja klienta korzystającego ze standardowego wejścia i wyjścia:

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

W przypadku większości ogólnych klientów MCP należy zacząć od standardowego zestawu narzędzi i zignorować tryb Claude. Tryb Claude należy włączyć tylko dla klientów, którzy faktycznie obsługują metody powiadomień specyficzne dla Claude.

Opcje

openclaw mcp serve obsługuje:

Granica bezpieczeństwa i zaufania

Most nie tworzy reguł routingu. Udostępnia tylko konwersacje, które Gateway już potrafi przekierować.

Oznacza to, że:

• listy dozwolonych nadawców, parowanie i zaufanie na poziomie kanału nadal należą do bazowej konfiguracji kanału OpenClaw
• messages_send może odpowiadać wyłącznie przez istniejącą zapisaną trasę
• stan zatwierdzeń jest dostępny 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 można zaufać w przypadku każdego innego zdalnego klienta Gateway

Jeśli w conversations_list brakuje konwersacji, zwykle przyczyną nie jest konfiguracja MCP. Powodem są brakujące lub niekompletne metadane trasy w bazowej sesji Gateway.

Testowanie

OpenClaw zawiera deterministyczny test smoke w Dockerze dla tego mostu:

pnpm test:docker:mcp-channels

Ten test smoke uruchamia jeden kontener: inicjuje stan konwersacji, uruchamia Gateway, następnie uruchamia openclaw mcp serve jako proces potomny stdio i steruje nim jak klientem MCP. Weryfikuje wykrywanie konwersacji, odczyt transkrypcji, odczyt metadanych załączników, zachowanie kolejki zdarzeń na żywo oraz powiadomienia o kanałach i uprawnieniach w stylu Claude za pośrednictwem rzeczywistego mostu MCP stdio. Routing wysyłania wychodzącego (messages_send ponownie wykorzystujący zapisaną trasę konwersacji) jest oddzielnie objęty testami jednostkowymi w src/mcp/channel-server.test.ts.

Jest to najszybszy sposób na potwierdzenie działania mostu bez podłączania do testu rzeczywistego konta Telegram, Discord lub iMessage.

Szerszy kontekst testowania opisano w sekcji Testowanie.

Rozwiązywanie problemów

OpenClaw jako rejestr klientów MCP

Jest to ścieżka openclaw mcp list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload i unset.

Te polecenia nie udostępniają OpenClaw przez MCP. Zarządzają definicjami serwerów MCP obsługiwanymi przez OpenClaw w sekcji mcp.servers konfiguracji OpenClaw. Nie odczytują serwerów mcporter z config/mcporter.json.

Zapisane definicje są przeznaczone dla środowisk uruchomieniowych, które OpenClaw uruchamia lub konfiguruje później, takich jak osadzony OpenClaw i inne adaptery środowiska uruchomieniowego. OpenClaw przechowuje definicje centralnie, dzięki czemu te środowiska nie muszą utrzymywać własnych, zduplikowanych list serwerów MCP.

Adaptery środowiska uruchomieniowego mogą normalizować ten wspólny rejestr do kształtu oczekiwanego przez ich klienta podrzędnego. Na przykład osadzony OpenClaw używa bezpośrednio wartości transport OpenClaw, natomiast Claude Code i Gemini otrzymują natywne dla CLI wartości type, takie jak http, sse lub stdio.

Serwer aplikacji Codex uwzględnia również opcjonalny blok codex na każdym serwerze. Są to metadane projekcji OpenClaw przeznaczone wyłącznie dla wątków serwera aplikacji Codex; nie zmieniają sesji ACP, ogólnej konfiguracji środowiska Codex ani innych adapterów środowiska uruchomieniowego. Niepustego codex.agents należy użyć, aby projektować serwer wyłącznie do określonych identyfikatorów agentów OpenClaw. Puste, zawierające wyłącznie białe znaki lub nieprawidłowe listy agentów są odrzucane przez walidację konfiguracji i pomijane przez ścieżkę projekcji środowiska uruchomieniowego, zamiast stawać się globalne. Należy użyć codex.defaultToolsApprovalMode (auto, prompt lub approve), aby wyemitować natywne default_tools_approval_mode systemu Codex dla zaufanego serwera. OpenClaw usuwa metadane codex przed przekazaniem natywnej konfiguracji mcp_servers do Codex.

Zapisane definicje serwerów MCP

Polecenia:

• 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>

Uwagi:

• list sortuje nazwy serwerów.
• show bez nazwy wyświetla pełny skonfigurowany obiekt serwera MCP.
• status klasyfikuje skonfigurowane transporty bez nawiązywania połączenia. --verbose uwzględnia rozpoznane szczegóły uruchamiania, limitu czasu, OAuth, filtrów i wywołań równoległych.
• doctor wykonuje kontrole statyczne bez nawiązywania połączenia. Należy dodać --probe, jeśli polecenie ma również sprawdzić, czy włączone serwery nawiązują połączenie.
• probe nawiązuje połączenie i raportuje liczbę narzędzi, obsługę zasobów/monitów, obsługę zmian listy oraz diagnostykę.
• add przyjmuje flagi stdio, takie jak --command, --arg, --env i --cwd, albo flagi HTTP, takie jak --url, --transport, --header, --auth oauth, a także flagi TLS, limitu czasu i wyboru narzędzi.
• set oczekuje w wierszu poleceń jednej wartości będącej obiektem JSON.
• configure aktualizuje stan włączenia, filtry narzędzi, limity czasu, OAuth, TLS i wskazówki dotyczące równoległych wywołań narzędzi bez zastępowania całej definicji serwera. Należy dodać --probe, aby zweryfikować zaktualizowany serwer przed zapisaniem.
• tools aktualizuje filtry narzędzi dla poszczególnych serwerów. Wpisy uwzględniania/wykluczania są nazwami narzędzi MCP i prostymi wzorcami glob *.
• login uruchamia przepływ OAuth dla serwerów HTTP skonfigurowanych z auth: "oauth". Pierwsze uruchomienie wyświetla adres URL autoryzacji; po zatwierdzeniu należy ponownie uruchomić polecenie z --code.
• logout usuwa zapisane dane uwierzytelniające OAuth dla wskazanego serwera bez usuwania zapisanej definicji serwera.
• reload usuwa z pamięci podręcznej środowiska uruchomieniowe MCP działające w procesie wyłącznie dla bieżącego procesu CLI. Procesy Gateway lub agenta działające w innym procesie nadal wymagają własnej ścieżki ponownego wczytania lub ponownego uruchomienia.
• Dla serwerów MCP korzystających ze Streamable HTTP należy użyć transport: "streamable-http". openclaw mcp set normalizuje również natywne dla CLI type: "http" do tego samego kanonicznego kształtu konfiguracji w celu zapewnienia zgodności.
• unset kończy się niepowodzeniem, jeśli wskazany serwer nie istnieje.

Przykłady:

openclaw mcp listopenclaw mcp show context7 --jsonopenclaw mcp status --verboseopenclaw mcp doctor --probeopenclaw mcp probe context7 --jsonopenclaw mcp add memory --command npx --arg -y --arg @modelcontextprotocol/server-memoryopenclaw 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 docsopenclaw mcp logout docsopenclaw mcp unset context7

Typowe konfiguracje serwerów

Te przykłady zapisują tylko definicje serwerów. Następnie uruchom openclaw mcp doctor --probe, aby potwierdzić, że serwer się uruchamia i udostępnia narzędzia.

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-memoryopenclaw 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.exampleopenclaw 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

Struktury danych wyjściowych JSON

Używaj --json w skryptach i panelach. Zestawy pól mogą z czasem się rozszerzać, dlatego odbiorcy powinni ignorować nieznane klucze.

{  "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": "Poświadczenia OAuth nie są autoryzowane; uruchom 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": []}

Przykładowa struktura konfiguracji:

{  "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_*"]        }      }    }  }}

Transport Stdio

Uruchamia lokalny proces potomny i komunikuje się przez stdin/stdout.

Transport SSE / HTTP

Łączy się ze zdalnym serwerem MCP przez zdarzenia HTTP Server-Sent Events.

Przykład:

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

Wrażliwe wartości w url (informacjach o użytkowniku) i headers są maskowane w dziennikach i danych wyjściowych stanu. openclaw mcp doctor ostrzega, gdy wpisy headers lub env wyglądające na wrażliwe zawierają wartości literałowe, aby operatorzy mogli usunąć te wartości z konfiguracji zatwierdzanej w repozytorium.

Przepływ pracy OAuth

OAuth jest przeznaczony dla serwerów MCP HTTP, które deklarują obsługę przepływu OAuth MCP. Statyczne nagłówki Authorization są ignorowane dla serwera, gdy włączono auth: "oauth". Poświadczenia zapisane przez openclaw mcp login działają z osadzonym MCP, programami uruchamiającymi CLI i lokalnym serwerem aplikacji Codex.

Dopóki poświadczenia nie będą dostępne, OpenClaw pomija w środowisku uruchomieniowym agenta tylko ten serwer MCP, zamiast powodować niepowodzenie tury agenta. Operator lub agent z dostępem do powłoki może następnie uruchomić openclaw mcp login <name> i użyć serwera w późniejszej turze.

Gdy zdalna usługa MCP jest już obsługiwana przez oddzielny profil uwierzytelniania OpenClaw z możliwością odświeżania, można opcjonalnie ustawić oauth.authProfileId. OpenClaw odświeża jedno ze źródeł poświadczeń przed projekcją środowiska uruchomieniowego i przekazuje klientowi MCP niższego poziomu tylko aktualny token dostępu.

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 --verboseopenclaw mcp doctor docs --probe

openclaw mcp logout docs

Jeśli dostawca rotuje tokeny lub stan autoryzacji się zablokuje, uruchom openclaw mcp logout <name>, a następnie ponownie wykonaj login. Polecenie logout może wyczyścić dane uwierzytelniające zapisanego serwera HTTP nawet po usunięciu auth: "oauth" z konfiguracji, o ile nazwa i adres URL serwera nadal identyfikują wpis w magazynie danych uwierzytelniających.

Transport strumieniowego HTTP

streamable-http jest dodatkową opcją transportu obok sse i stdio. Wykorzystuje strumieniowanie HTTP do dwukierunkowej komunikacji ze zdalnymi serwerami MCP.

Konfiguracja OpenClaw używa transport: "streamable-http" jako kanonicznej pisowni. Natywne dla CLI wartości MCP type: "http" są akceptowane przy zapisywaniu przez openclaw mcp set i naprawiane przez openclaw doctor --fix w istniejącej konfiguracji, ale osadzony OpenClaw bezpośrednio korzysta z transport.

Przykład:

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

Interfejs sterowania

Przeglądarkowy interfejs sterowania zawiera dedykowaną stronę ustawień MCP pod adresem /settings/mcp; poprzednia ścieżka /mcp pozostaje aliasem. Strona wyświetla liczbę skonfigurowanych serwerów, podsumowania włączonych serwerów, OAuth i filtrów, wiersze transportu poszczególnych serwerów, elementy sterujące włączaniem i wyłączaniem, typowe polecenia CLI oraz edytor o zakresie ograniczonym do sekcji konfiguracji mcp.

Strona służy do wprowadzania zmian przez operatora i szybkiego przeglądania zasobów. Gdy wymagane jest potwierdzenie działania serwera na żywo, użyj openclaw mcp doctor --probe lub openclaw mcp probe.

Przepływ pracy operatora:

1. Otwórz interfejs sterowania i wybierz MCP.
2. Przejrzyj karty podsumowania całkowitej liczby serwerów oraz serwerów włączonych, korzystających z OAuth i filtrowanych.
3. W każdym wierszu serwera można znaleźć wskazówki dotyczące transportu, uwierzytelniania, filtra, limitu czasu i poleceń.
4. Przełącz stan włączenia, aby zachować definicję, ale wykluczyć ją z wykrywania w środowisku uruchomieniowym.
5. Edytuj sekcję konfiguracji mcp o ograniczonym zakresie, aby wprowadzać zmiany strukturalne, takie jak nowe serwery, nagłówki, TLS, metadane OAuth lub filtry narzędzi.
6. Wybierz Save, aby tylko zachować konfigurację, lub Save & Publish, aby zastosować ją za pośrednictwem ścieżki konfiguracji Gateway.
7. Uruchom openclaw mcp doctor --probe, gdy potrzebne jest potwierdzenie na żywo, że edytowany serwer uruchamia się i wyświetla listę narzędzi.

Uwagi:

• fragmenty poleceń ujmują nazwy serwerów w cudzysłowy, dzięki czemu nietypowe nazwy można skopiować do powłoki
• wyświetlane wartości przypominające adresy URL są przed renderowaniem redagowane, jeśli zawierają osadzone dane uwierzytelniające
• strona nie uruchamia samodzielnie transportów MCP
• aktywne środowiska uruchomieniowe mogą wymagać openclaw mcp reload, opublikowania konfiguracji Gateway lub ponownego uruchomienia procesu, zależnie od tego, który proces jest właścicielem klientów MCP

Aplikacje MCP

OpenClaw może renderować narzędzia implementujące stabilne rozszerzenie MCP Apps. Aplikacje są opcjonalne, ponieważ ich kod HTML pochodzi ze skonfigurowanego serwera MCP i może żądać narzędzi lub zasobów widocznych dla aplikacji z tego samego serwera.

Włącz most hosta:

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

Po zmianie tego ustawienia uruchom ponownie Gateway. Po włączeniu OpenClaw uruchamia przeznaczony wyłącznie dla piaskownicy nasłuch HTTP(S) na porcie Gateway powiększonym o jeden (dla domyślnego Gateway jest to 18790). Interfejs sterowania ładuje aplikacje z tego oddzielnego źródła; nasłuch nigdy nie udostępnia interfejsu sterowania, uwierzytelnionych tras Gateway ani danych użytkownika.

Bezpośrednie połączenia z Gateway wymagają dostępu do obu portów. Jeśli odwrotny serwer proxy lub terminator TLS udostępnia interfejs sterowania, należy przydzielić aplikacjom osobne publiczne źródło i przekazywać tylko to źródło do nasłuchu piaskownicy:

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

Źródło piaskownicy musi różnić się od źródła interfejsu sterowania. Nie należy udostępniać w nim innych uwierzytelnionych ani poufnych treści.

Na przykład oficjalne podstawowe demo React można skonfigurować następująco:

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

Zachowanie i granice bezpieczeństwa:

• OpenClaw ogłasza rozszerzenie io.modelcontextprotocol/ui tylko wtedy, gdy aplikacje są włączone.
• Renderowane są wyłącznie zasoby ui:// z dokładnym typem MIME text/html;profile=mcp-app.
• Zasoby interfejsu użytkownika są ograniczone do 2 MiB, umieszczane za dwuetapowym serwerem proxy iframe w dedykowanym źródle zewnętrznym, ładowane do nieprzezroczystego wewnętrznego źródła aplikacji i ograniczane przez CSP wyprowadzoną z metadanych zasobu.
• Narzędzia przeznaczone wyłącznie dla aplikacji (_meta.ui.visibility: ["app"]) nie trafiają na listy narzędzi modelu. Aplikacje mogą wywoływać wyłącznie narzędzia widoczne dla aplikacji na serwerze, do którego należą, i które przechodzą również efektywne zasady OpenClaw dotyczące narzędzi dla przebiegu, w którym utworzono widok.
• Uprawnienia aplikacji powiązane ze źródłem, takie jak dostęp do kamery, mikrofonu i geolokalizacji, nie są przyznawane, gdy wewnętrzne dokumenty aplikacji używają nieprzezroczystych źródeł w celu izolacji między aplikacjami.
• Kod HTML aplikacji, pełne argumenty narzędzi i surowe wyniki znajdują się w ograniczonej, dziesięciominutowej dzierżawie widoku w pamięci i nie są zapisywane na dysku ani kopiowane do metadanych podglądu transkrypcji. Transkrypcja przechowuje tylko ograniczony deskryptor serwera, narzędzia i zasobu powiązany z pierwotnym identyfikatorem wywołania narzędzia. Po ponownym uruchomieniu Gateway interfejs sterowania może zweryfikować ten deskryptor względem transkrypcji uwierzytelnionej sesji i ponownie pobrać zasób ui://; odtworzone widoki są tylko do odczytu, dopóki nowy przebieg nie ustanowi aktualnych uprawnień do narzędzi.
• openclaw security audit ostrzega, gdy most jest włączony. Gdy nie jest potrzebny, wyłącz go za pomocą openclaw config set mcp.apps.enabled false --strict-json.

Obecne ograniczenia

Ta strona dokumentuje most w postaci obecnie dostarczanej.

Obecne ograniczenia:

• wykrywanie konwersacji zależy od istniejących metadanych tras sesji Gateway
• brak ogólnego protokołu wypychania poza adapterem przeznaczonym dla Claude
• narzędzia do edycji wiadomości i dodawania reakcji nie są jeszcze dostępne
• transport HTTP/SSE/streamable-http łączy się z jednym zdalnym serwerem; multipleksowane połączenie nadrzędne nie jest jeszcze dostępne
• permissions_list_open obejmuje tylko zatwierdzenia zaobserwowane, gdy most jest połączony

Powiązane

• Dokumentacja CLI
• Pluginy