MCP

openclaw mcp iki göreve sahiptir:

• openclaw mcp serve ile OpenClaw'ı bir MCP sunucusu olarak çalıştırmak
• list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload ve unset ile OpenClaw tarafından yönetilen giden MCP sunucusu tanımlarını yönetmek

serve, OpenClaw'ın bir MCP sunucusu olarak çalışmasıdır. Diğer alt komutlar ise OpenClaw'ın, kendi çalışma zamanlarının daha sonra kullanabileceği sunucular için MCP istemci tarafı kayıt defteri olarak çalışmasıdır.

OpenClaw'ın bir kodlama altyapısı oturumunu kendisinin barındırması ve bu çalışma zamanını ACP üzerinden yönlendirmesi gerektiğinde openclaw acp kullanın.

Doğru MCP yolunu seçme

MCP sunucusu olarak OpenClaw

Bu, openclaw mcp serve yoludur.

serve ne zaman kullanılmalı?

Şu durumlarda openclaw mcp serve kullanın:

• Codex, Claude Code veya başka bir MCP istemcisi doğrudan OpenClaw destekli kanal konuşmalarıyla iletişim kurmalıysa
• yönlendirilmiş oturumlara sahip yerel veya uzak bir OpenClaw Gateway zaten varsa
• kanal başına ayrı köprüler çalıştırmak yerine OpenClaw'ın tüm kanal arka uçlarında çalışan tek bir MCP sunucusu istiyorsanız

OpenClaw'ın kodlama çalışma zamanını kendisinin barındırması ve ajan oturumunu OpenClaw içinde tutması gerektiğinde bunun yerine openclaw acp kullanın.

Nasıl çalışır?

openclaw mcp serve, bir stdio MCP sunucusu başlatır. Bu işlemin sahibi MCP istemcisidir. İstemci stdio oturumunu açık tuttuğu sürece köprü, WebSocket üzerinden yerel veya uzak bir OpenClaw Gateway'e bağlanır ve yönlendirilmiş kanal konuşmalarını MCP üzerinden sunar.

İstemci modu seçme

serve tarafından sunulanlar

Köprü, kanal destekli konuşmaları sunmak için mevcut Gateway oturum yönlendirme meta verilerini kullanır. OpenClaw, aşağıdaki gibi bilinen bir yönlendirmeye sahip oturum durumunu zaten içeriyorsa bir konuşma görünür:

• channel
• alıcı veya hedef meta verileri
• isteğe bağlı accountId
• isteğe bağlı threadId

Bu, MCP istemcilerine aşağıdaki işlemler için tek bir yer sağlar:

• son yönlendirilmiş konuşmaları listelemek
• son transkript geçmişini okumak
• yeni gelen olayları beklemek
• aynı yönlendirme üzerinden yanıt göndermek
• köprü bağlıyken gelen onay isteklerini görmek

Kullanım

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

Köprü araçları

Olay modeli

Köprü, bağlı olduğu sürece bellekte bir olay kuyruğu tutar.

Mevcut olay türleri:

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

Claude kanal bildirimleri

Köprü ayrıca Claude'a özgü kanal bildirimlerini sunabilir. Bu, Claude Code kanal bağdaştırıcısının OpenClaw karşılığıdır: standart MCP araçları kullanılabilir durumda kalırken canlı gelen iletiler Claude'a özgü MCP bildirimleri olarak da ulaşabilir.

Claude kanal modu etkinleştirildiğinde sunucu, Claude deneysel yeteneklerini bildirir ve şunları gönderebilir:

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

Mevcut köprü davranışı:

• gelen user transkript iletileri notifications/claude/channel olarak iletilir
• MCP üzerinden alınan Claude izin istekleri bellekte izlenir
• bağlantılı konuşmadaki komut sahibi daha sonra yes <id> veya no <id> gönderirse (<id>, l hariç 5 harfli istek kimliğidir), köprü bunu notifications/claude/channel/permission değerine dönüştürür
• bu bildirimler yalnızca canlı oturum içindir; MCP istemcisi bağlantıyı keserse anlık bildirim hedefi kalmaz

Bu, bilinçli olarak istemciye özgüdür. Genel MCP istemcileri standart yoklama araçlarını kullanmalıdır.

MCP istemci yapılandırması

Örnek stdio istemci yapılandırması:

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

Çoğu genel MCP istemcisi için standart araç yüzeyiyle başlayın ve Claude modunu dikkate almayın. Claude modunu yalnızca Claude'a özgü bildirim yöntemlerini gerçekten anlayan istemciler için açın.

Seçenekler

openclaw mcp serve şunları destekler:

Güvenlik ve güven sınırı

Köprü yönlendirme oluşturmaz. Yalnızca Gateway'in zaten nasıl yönlendireceğini bildiği konuşmaları kullanıma sunar.

Bunun anlamı şudur:

• gönderen izin listeleri, eşleştirme ve kanal düzeyindeki güven, temel OpenClaw kanal yapılandırmasına ait olmaya devam eder
• messages_send yalnızca mevcut bir kayıtlı rota üzerinden yanıt verebilir
• onay durumu yalnızca geçerli köprü oturumu için canlı/bellek içindedir
• köprü kimlik doğrulaması, diğer tüm uzak Gateway istemcileri için güveneceğiniz aynı Gateway belirteci veya parola denetimlerini kullanmalıdır

conversations_list içinde bir konuşma eksikse olağan neden MCP yapılandırması değildir. Temel Gateway oturumundaki rota meta verilerinin eksik veya tamamlanmamış olmasıdır.

Test

OpenClaw bu köprü için deterministik bir Docker duman testiyle birlikte gelir:

pnpm test:docker:mcp-channels

Bu duman testi tek bir kapsayıcı çalıştırır: konuşma durumunu başlangıç verileriyle doldurur, Gateway'i başlatır, ardından openclaw mcp serve öğesini bir stdio alt süreci olarak oluşturur ve onu bir MCP istemcisi olarak çalıştırır. Gerçek stdio MCP köprüsü üzerinden konuşma keşfini, transkript okumalarını, ek meta verisi okumalarını, canlı olay kuyruğu davranışını ve Claude tarzı kanal ve izin bildirimlerini doğrular. Giden gönderim yönlendirmesi (kayıtlı konuşma rotasını yeniden kullanan messages_send) src/mcp/channel-server.test.ts içindeki birim testleri tarafından ayrıca kapsanır.

Bu, test çalıştırmasına gerçek bir Telegram, Discord veya iMessage hesabı bağlamadan köprünün çalıştığını kanıtlamanın en hızlı yoludur.

Daha geniş test bağlamı için Test bölümüne bakın.

Sorun giderme

MCP istemci kayıt defteri olarak OpenClaw

Bu, openclaw mcp list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload ve unset yoludur.

Bu komutlar OpenClaw'u MCP üzerinden kullanıma sunmaz. OpenClaw yapılandırmasında mcp.servers altındaki OpenClaw tarafından yönetilen MCP sunucu tanımlarını yönetirler. config/mcporter.json içindeki mcporter sunucularını okumazlar.

Kaydedilen bu tanımlar, gömülü OpenClaw ve diğer çalışma zamanı bağdaştırıcıları gibi OpenClaw'un daha sonra başlattığı veya yapılandırdığı çalışma zamanları içindir. OpenClaw, bu çalışma zamanlarının kendi yinelenen MCP sunucu listelerini tutmak zorunda kalmaması için tanımları merkezi olarak depolar.

Çalışma zamanı bağdaştırıcıları bu paylaşılan kayıt defterini, sonraki istemcilerinin beklediği biçime normalleştirebilir. Örneğin gömülü OpenClaw, OpenClaw transport değerlerini doğrudan tüketirken Claude Code ve Gemini, http, sse veya stdio gibi CLI'ya özgü type değerlerini alır.

Codex uygulama sunucusu ayrıca her sunucudaki isteğe bağlı codex bloğunu dikkate alır. Bu, yalnızca Codex uygulama sunucusu ileti dizileri için OpenClaw projeksiyon meta verisidir; ACP oturumlarını, genel Codex çalıştırma düzeneği yapılandırmasını veya diğer çalışma zamanı bağdaştırıcılarını değiştirmez. Bir sunucuyu yalnızca belirli OpenClaw ajan kimliklerine yansıtmak için boş olmayan codex.agents kullanın. Boş, yalnızca boşluk içeren veya geçersiz ajan listeleri, genel hale gelmek yerine yapılandırma doğrulaması tarafından reddedilir ve çalışma zamanı projeksiyon yolundan çıkarılır. Güvenilen bir sunucu için Codex'in yerel default_tools_approval_mode değerini yaymak üzere codex.defaultToolsApprovalMode (auto, prompt veya approve) kullanın. OpenClaw, yerel mcp_servers yapılandırmasını Codex'e aktarmadan önce codex meta verilerini kaldırır.

Kaydedilmiş MCP sunucu tanımları

Komutlar:

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

Notlar:

• list, sunucu adlarını sıralar.
• adsız show, yapılandırılmış MCP sunucu nesnesinin tamamını yazdırır.
• status, yapılandırılmış aktarımları bağlanmadan sınıflandırır. --verbose, depolanan OAuth belirteçlerinin ek yetkilendirme gerektirdiği durumlar dahil olmak üzere çözümlenmiş başlatma, zaman aşımı, OAuth, filtre ve paralel çağrı ayrıntılarını içerir. Kimlik bilgileri içeren stdio bağımsız değişkenleri metin ve JSON çıktısında gizlenir.
• doctor, bağlanmadan statik denetimler gerçekleştirir. Komutun etkin sunucuların bağlandığını da doğrulaması gerektiğinde --probe ekleyin.
• probe, bağlanır ve araç sayılarını, kaynak/istem desteğini, liste değişikliği desteğini ve tanıları bildirir.
• add; --command, --arg, --env ve --cwd gibi stdio bayraklarını veya --url, --transport, --header, --auth oauth, TLS, zaman aşımı ve araç seçimi bayrakları gibi HTTP bayraklarını kabul eder.
• set, komut satırında tek bir JSON nesne değeri bekler.
• configure, sunucu tanımının tamamını değiştirmeden etkinleştirmeyi, araç filtrelerini, zaman aşımlarını, OAuth'ı, TLS'yi ve paralel araç çağrısı ipuçlarını günceller. Güncellenen sunucuyu kaydetmeden önce doğrulamak için --probe ekleyin.
• tools, sunucu başına araç filtrelerini günceller. Dahil etme/dışlama girdileri MCP araç adları ve basit * glob kalıplarıdır.
• login, auth: "oauth" ile yapılandırılmış HTTP sunucuları için OAuth akışını çalıştırır. İlk çalıştırma bir yetkilendirme URL'si yazdırır; onaydan sonra --code ile yeniden çalıştırın.
• logout, kaydedilmiş sunucu tanımını kaldırmadan adlandırılmış sunucu için depolanan OAuth kimlik bilgilerini temizler.
• reload, yalnızca geçerli CLI süreci için önbelleğe alınmış süreç içi MCP çalışma zamanlarını sonlandırır. Başka bir süreçteki Gateway veya ajan süreçleri yine kendi yeniden yükleme veya yeniden başlatma yollarına ihtiyaç duyar.
• Streamable HTTP MCP sunucuları için transport: "streamable-http" kullanın. openclaw mcp set, uyumluluk amacıyla CLI'ya özgü type: "http" değerini de aynı kurallı yapılandırma biçimine normalleştirir.
• unset, adlandırılmış sunucu mevcut değilse başarısız olur.

Örnekler:

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

Yaygın sunucu tarifleri

Bu örnekler yalnızca sunucu tanımlarını kaydeder. Sunucunun başlatıldığını ve araçları kullanıma sunduğunu doğrulamak için daha sonra openclaw mcp doctor --probe komutunu çalıştırın.

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,get_window_state,click,type_text'openclaw mcp doctor cua-driver --probe

JSON çıktı biçimleri

Betikler ve panolar için --json kullanın. Alan kümeleri zamanla büyüyebileceğinden tüketiciler bilinmeyen anahtarları yok saymalıdır.

{  "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,        "requiresAuthorization": false,        "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 kimlik bilgileri yetkilendirilmemiş; openclaw mcp login docs komutunu çalıştırın"        }      ]    }  ]}

{  "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": []}

Örnek yapılandırma biçimi:

{  "mcp": {    "servers": {      "context7": {        "command": "uvx",        "args": ["context7-mcp"]      },      "docs": {        "url": "https://mcp.example.com",        "transport": "streamable-http",        "requestTimeoutMs": 20000,        "connectionTimeoutMs": 5000,        "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 aktarımı

Yerel bir alt işlem başlatır ve stdin/stdout üzerinden iletişim kurar.

SSE / HTTP aktarımı

HTTP Sunucu Gönderimli Olaylar üzerinden uzak bir MCP sunucusuna bağlanır.

Örnek:

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

url (kullanıcı bilgileri) ve headers içindeki hassas değerler günlüklerde ve durum çıktısında gizlenir. openclaw mcp doctor, hassas görünümlü headers veya env girdileri değişmez değerler içerdiğinde uyarır; böylece operatörler bu değerleri depoya kaydedilmiş yapılandırmanın dışına taşıyabilir.

OAuth iş akışı

OAuth, MCP OAuth akışını duyuran HTTP MCP sunucuları içindir. auth: "oauth" etkinleştirildiğinde sunucu için statik Authorization üstbilgileri yok sayılır. openclaw mcp login tarafından kaydedilen kimlik bilgileri; gömülü MCP, CLI çalıştırıcıları ve yerel Codex uygulama sunucusuyla çalışır.

Yerel MCP OAuth oturumları, <state-dir>/state/openclaw.sqlite konumundaki yalnızca sahibinin erişebildiği paylaşılan SQLite veritabanında (mcp_oauth_stores) bulunur. Satır; erişim ve yenileme belirteçlerini, dinamik istemci kaydı sırlarını, keşif meta verilerini ve geçici PKCE doğrulayıcısını içerebilir. Yenileme, oturum açma ve oturumu kapatma aynı SQLite kirasını kullanır; böylece paralel OpenClaw işlemleri tek bir yenileme belirtecini tüketemez veya oturumu kapatılmış bir oturumu yeniden etkinleştiremez.

Kullanımdan kaldırılmış <state-dir>/mcp-oauth/*.json deposundan yükseltmeler yalnızca openclaw doctor --fix tarafından gerçekleştirilir. Çalışma zamanı kodu bu dosyaları hiçbir zaman okumaz, yazmaz veya bunlara geri dönmez.

Kimlik bilgileri kullanılabilir olana kadar OpenClaw, aracı turunu başarısız kılmak yerine yalnızca ilgili MCP sunucusunu aracı çalışma zamanından çıkarır. Ardından operatör veya kabuk erişimi olan bir aracı openclaw mcp login <name> komutunu çalıştırabilir ve sonraki bir turda sunucuyu kullanabilir.

Bir sunucu belirteci insufficient_scope ile reddederse OpenClaw, istenen kapsamı korur ve yeni kapsam veremeyecek bir yenilemeyi tekrarlamak yerine openclaw mcp login <name> ister. Bu oturum açma işlemi, yerine geçecek kimlik bilgileri kaydedilene kadar önceki belirteci koruyarak yeni bir yetkilendirme isteği başlatır.

Uzak bir MCP hizmeti zaten yenileme özellikli ayrı bir OpenClaw kimlik doğrulama profiliyle destekleniyorsa isteğe bağlı olarak oauth.authProfileId ayarlanabilir. OpenClaw, çalışma zamanı yansıtmasından önce iki kimlik bilgisi kaynağından birini yeniler ve aşağı akış MCP istemcisine yalnızca geçerli erişim belirtecini iletir.

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

Sağlayıcı tokenları döndürürse veya yetkilendirme durumu takılı kalırsa openclaw mcp logout <name> komutunu çalıştırın, ardından login işlemini tekrarlayın. Sunucu adı ve URL kimlik bilgisi deposu girdisini tanımlamaya devam ettiği sürece logout, auth: "oauth" yapılandırmadan kaldırıldıktan sonra bile kaydedilmiş bir HTTP sunucusunun kimlik bilgilerini temizleyebilir.

Akış özellikli HTTP aktarımı

streamable-http, sse ve stdio seçeneklerinin yanında ek bir aktarım seçeneğidir. Uzak MCP sunucularıyla çift yönlü iletişim için HTTP akışını kullanır.

OpenClaw yapılandırması, kurallı yazım olarak transport: "streamable-http" kullanır. CLI'ye özgü MCP type: "http" değerleri, openclaw mcp set aracılığıyla kaydedildiğinde kabul edilir ve mevcut yapılandırmada openclaw doctor --fix tarafından düzeltilir; ancak yerleşik OpenClaw'ın doğrudan tükettiği değer transport değeridir.

Örnek:

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

Kontrol kullanıcı arayüzü

Tarayıcıdaki Kontrol kullanıcı arayüzü, /settings/mcp konumunda özel bir MCP ayarları sayfası içerir; önceki /mcp yolu takma ad olarak kalır. Sayfa; yapılandırılmış sunucu sayılarını, etkin/OAuth/filtre özetlerini, sunucu başına aktarım satırlarını, etkinleştirme/devre dışı bırakma denetimlerini, yaygın CLI komutlarını ve mcp yapılandırma bölümü için kapsamlı bir düzenleyiciyi gösterir.

Sayfayı operatör düzenlemeleri ve hızlı envanter için kullanın. Canlı sunucu kanıtına ihtiyaç duyduğunuzda openclaw mcp doctor --probe veya openclaw mcp probe kullanın.

Operatör iş akışı:

1. Kontrol kullanıcı arayüzünü açın ve MCP seçeneğini belirleyin.
2. Toplam, etkin, OAuth ve filtrelenmiş sunucular için özet kartlarını inceleyin.
3. Aktarım, kimlik doğrulama, filtre, zaman aşımı ve komut ipuçları için her sunucu satırını kullanın.
4. Bir tanımı korumak ancak çalışma zamanı keşfinden hariç tutmak istediğinizde etkinleştirme durumunu değiştirin.
5. Yeni sunucular, üst bilgiler, TLS, OAuth meta verileri veya araç filtreleri gibi yapısal değişiklikler için kapsamlı mcp yapılandırma bölümünü düzenleyin.
6. Yalnızca yapılandırmayı kalıcılaştırmak için Save, Gateway yapılandırma yolu üzerinden uygulamak için Save & Publish seçeneğini belirleyin.
7. Düzenlenen sunucunun başlatıldığına ve araçları listelediğine dair canlı kanıt gerektiğinde openclaw mcp doctor --probe komutunu çalıştırın.

Notlar:

• komut parçacıkları, sıra dışı adların kabukta kopyalanabilir kalması için sunucu adlarını tırnak içine alır
• görüntülenen URL benzeri değerler, gömülü kimlik bilgileri içerdiğinde işlenmeden önce karartılır
• sayfa MCP aktarımlarını kendi başına başlatmaz
• MCP istemcilerinin sahibi olan sürece bağlı olarak etkin çalışma zamanları openclaw mcp reload, Gateway yapılandırmasının yayımlanması veya işlemin yeniden başlatılmasını gerektirebilir

MCP Uygulamaları

OpenClaw, kararlı MCP Uygulamaları uzantısını uygulayan araçları işleyebilir. Uygulamalar isteğe bağlıdır; çünkü HTML'leri yapılandırılmış MCP sunucusundan gelir ve aynı sunucudan uygulama tarafından görülebilen araçları veya kaynakları isteyebilir.

Ana makine köprüsünü etkinleştirin:

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

Bu ayarı değiştirdikten sonra Gateway'i yeniden başlatın. Etkinleştirildiğinde OpenClaw, Gateway portunun bir fazlasında yalnızca korumalı alana yönelik bir HTTP(S) dinleyicisi başlatır (varsayılan Gateway için 18790). Kontrol kullanıcı arayüzü Uygulamaları bu ayrı kaynaktan yükler; dinleyici hiçbir zaman Kontrol kullanıcı arayüzünü, kimliği doğrulanmış Gateway rotalarını veya kullanıcı verilerini sunmaz.

Doğrudan Gateway bağlantılarının her iki porta da erişmesi gerekir. Bir ters proxy veya TLS sonlandırıcısı Kontrol kullanıcı arayüzünü açığa çıkarıyorsa Uygulamalara özel bir genel kaynak verin ve yalnızca bu kaynağı korumalı alan dinleyicisine yönlendirin:

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

Korumalı alan kaynağı, Kontrol kullanıcı arayüzü kaynağından farklı olmalıdır. Üzerinde kimliği doğrulanmış veya hassas başka içerikler barındırmayın.

Örneğin, resmî temel React demosu şu şekilde yapılandırılabilir:

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

Davranış ve güvenlik sınırları:

• OpenClaw, io.modelcontextprotocol/ui uzantısını yalnızca Uygulamalar etkinleştirildiğinde duyurur.
• Yalnızca tam olarak text/html;profile=mcp-app MIME türüne sahip ui:// kaynakları işlenir.
• Kullanıcı arayüzü kaynakları 2 MiB ile sınırlandırılır, özel bir dış kaynakta çift iframe proxy'sinin arkasına yerleştirilir, opak bir iç Uygulama kaynağına yüklenir ve kaynak meta verilerinden türetilen CSP ile kısıtlanır.
• Yalnızca Uygulamaya özgü araçlar (_meta.ui.visibility: ["app"]) model araç listelerinin dışında kalır. Uygulamalar yalnızca kendi sunucularındaki, uygulama tarafından görülebilen ve görünümü oluşturan çalıştırma için geçerli OpenClaw araç politikasından da geçen araçları çağırabilir.
• İç Uygulama belgeleri, Uygulamalar arası yalıtım için opak kaynaklar kullandığı sürece kamera, mikrofon ve coğrafi konum gibi kaynağa bağlı Uygulama izinleri verilmez.
• Uygulama HTML'si, eksiksiz araç bağımsız değişkenleri ve ham sonuçlar, on dakikalık sınırlı bir bellek içi görünüm kiralamasında tutulur ve diske yazılmaz veya transkript önizleme meta verilerine kopyalanmaz. Transkript yalnızca özgün araç çağrısı kimliğine bağlı, sınırlı bir sunucu/araç/kaynak tanımlayıcısı saklar. Gateway yeniden başlatıldıktan sonra Kontrol kullanıcı arayüzü bu tanımlayıcıyı kimliği doğrulanmış oturum transkriptine göre doğrulayabilir ve ui:// kaynağını yeniden getirebilir; yeni bir çalıştırma güncel araç izinlerini belirleyene kadar yeniden oluşturulan görünümler salt okunurdur.
• Kanal konuşmalarında, bir turdaki en son başarılı Uygulama görünümü son asistan yanıtına Uygulamayı Aç tarzı tek bir eylem ekler. Telegram DM'leri yerel bir Mini App düğmesi kullanır; Slack ve Discord aynı taşınabilir eylemi bağlantı olarak işler. Diğer kanallar özgün yanıt metnini korur ve anlaşılır bir HTTPS bağlantısı ekler.
• Kanal başlatma bağlantıları yalnızca Gateway Tailscale erişimi yayımlanmış bir HTTPS kaynağı hazırladığında kullanılabilir. gateway.tailscale.mode: "serve" yalnızca tailnet üzerinden erişilebilir; "funnel" genel internetten erişilebilir. gateway.tailscale.preserveFunnel tarafından korunan, haricî olarak yönetilen bir Funnel da internetten erişilebilir kabul edilir. Bkz. Tailscale.
• Başlatma biletleri opaktır, yalnızca son kanal yanıtı oluşturulurken üretilir ve en fazla iki dakika sonra ya da temel görünüm kiralamasının süresi dolduğunda (hangisi önce gerçekleşirse) sona erer. URL; Gateway bearer kimlik bilgilerini, oturum anahtarlarını, görünüm meta verilerini, Uygulama HTML'sini, araç girdisini veya araç sonuçlarını içermez.
• Yayımlanmış bir kaynak veya bilet kapasitesi yoksa, görünümün ya da biletin süresi dolmuşsa veya aktarım yerel denetimleri işleyemiyorsa özgün asistan metni kullanılabilir kalır. Kontrol kullanıcı arayüzü mevcut satır içi Uygulama tuvalini korur ve yinelenen bir başlatma eylemi almaz.
• openclaw security audit, köprü etkinken uyarı verir. Gerekli olmadığında openclaw config set mcp.apps.enabled false --strict-json ile devre dışı bırakın.

Mevcut sınırlar

Bu sayfa, köprüyü bugün yayımlandığı hâliyle belgeler.

Mevcut sınırlar:

• konuşma keşfi, mevcut Gateway oturum rotası meta verilerine bağlıdır
• Claude'a özgü bağdaştırıcının ötesinde genel bir gönderim protokolü yoktur
• henüz mesaj düzenleme veya tepki araçları yoktur
• HTTP/SSE/streamable-http aktarımı tek bir uzak sunucuya bağlanır; henüz çoğullanmış üst akış yoktur
• permissions_list_open yalnızca köprü bağlıyken gözlemlenen onayları içerir

İlgili

• CLI referansı
• Pluginler