MCP

openclaw mcp memiliki dua tugas:

• menjalankan OpenClaw sebagai server MCP dengan openclaw mcp serve
• mengelola definisi server MCP keluar yang dikelola OpenClaw dengan list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload, dan unset

serve adalah OpenClaw yang bertindak sebagai server MCP. Subperintah lainnya adalah OpenClaw yang bertindak sebagai registri sisi klien MCP untuk server yang nantinya dapat digunakan oleh runtime-nya sendiri.

Gunakan openclaw acp ketika OpenClaw harus menghosting sendiri sesi harness pengodean dan merutekan runtime tersebut melalui ACP.

Pilih jalur MCP yang tepat

OpenClaw sebagai server MCP

Ini adalah jalur openclaw mcp serve.

Kapan menggunakan serve

Gunakan openclaw mcp serve ketika:

• Codex, Claude Code, atau klien MCP lain harus berkomunikasi langsung dengan percakapan saluran yang didukung OpenClaw
• Anda sudah memiliki Gateway OpenClaw lokal atau jarak jauh dengan sesi yang dirutekan
• Anda menginginkan satu server MCP yang berfungsi di seluruh backend saluran OpenClaw, alih-alih menjalankan jembatan terpisah untuk setiap saluran

Gunakan openclaw acp sebagai gantinya ketika OpenClaw harus menghosting sendiri runtime pengodean dan mempertahankan sesi agen di dalam OpenClaw.

Cara kerjanya

openclaw mcp serve memulai server MCP stdio. Klien MCP memiliki proses tersebut. Selama klien mempertahankan sesi stdio tetap terbuka, jembatan terhubung ke Gateway OpenClaw lokal atau jarak jauh melalui WebSocket dan mengekspos percakapan saluran yang dirutekan melalui MCP.

Pilih mode klien

Yang diekspos serve

Jembatan menggunakan metadata rute sesi Gateway yang sudah ada untuk mengekspos percakapan yang didukung saluran. Percakapan muncul ketika OpenClaw sudah memiliki status sesi dengan rute yang diketahui, seperti:

• channel
• metadata penerima atau tujuan
• accountId opsional
• threadId opsional

Ini memberi klien MCP satu tempat untuk:

• mencantumkan percakapan terbaru yang dirutekan
• membaca riwayat transkrip terbaru
• menunggu peristiwa masuk baru
• mengirim balasan kembali melalui rute yang sama
• melihat permintaan persetujuan yang masuk selama jembatan terhubung

Penggunaan

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

Alat jembatan

Model peristiwa

Jembatan menyimpan antrean peristiwa dalam memori selama terhubung.

Jenis peristiwa saat ini:

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

Notifikasi saluran Claude

Jembatan juga dapat mengekspos notifikasi saluran khusus Claude. Ini adalah padanan adaptor saluran Claude Code di OpenClaw: alat MCP standar tetap tersedia, tetapi pesan masuk langsung juga dapat tiba sebagai notifikasi MCP khusus Claude.

Ketika mode saluran Claude diaktifkan, server mengumumkan kapabilitas eksperimental Claude dan dapat memancarkan:

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

Perilaku jembatan saat ini:

• pesan transkrip masuk user diteruskan sebagai notifications/claude/channel
• permintaan izin Claude yang diterima melalui MCP dilacak dalam memori
• jika pemilik perintah dalam percakapan tertaut kemudian mengirim yes <id> atau no <id> (<id> adalah ID permintaan 5 huruf, tidak termasuk l), jembatan mengonversinya menjadi notifications/claude/channel/permission
• notifikasi ini hanya tersedia untuk sesi langsung; jika klien MCP terputus, tidak ada target push

Ini sengaja dibuat khusus untuk klien. Klien MCP generik sebaiknya mengandalkan alat polling standar.

Konfigurasi klien MCP

Contoh konfigurasi klien stdio:

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

Untuk sebagian besar klien MCP generik, mulai dengan permukaan alat standar dan abaikan mode Claude. Aktifkan mode Claude hanya untuk klien yang benar-benar memahami metode notifikasi khusus Claude.

Opsi

openclaw mcp serve mendukung:

Batas keamanan dan kepercayaan

Bridge tidak menciptakan perutean. Bridge hanya mengekspos percakapan yang sudah diketahui cara dirutekannya oleh Gateway.

Artinya:

• daftar pengirim yang diizinkan, pemasangan, dan kepercayaan tingkat kanal tetap menjadi bagian dari konfigurasi kanal OpenClaw yang mendasarinya
• messages_send hanya dapat membalas melalui rute tersimpan yang sudah ada
• status persetujuan hanya aktif/tersimpan dalam memori untuk sesi bridge saat ini
• autentikasi bridge harus menggunakan kontrol token atau kata sandi Gateway yang sama dengan yang Anda percayai untuk klien Gateway jarak jauh lainnya

Jika suatu percakapan tidak ada di conversations_list, penyebab umumnya bukan konfigurasi MCP. Penyebabnya adalah metadata rute yang hilang atau tidak lengkap dalam sesi Gateway yang mendasarinya.

Pengujian

OpenClaw menyediakan pengujian smoke Docker deterministik untuk bridge ini:

pnpm test:docker:mcp-channels

Pengujian smoke tersebut menjalankan satu kontainer: mengisi status percakapan, memulai Gateway, lalu menjalankan openclaw mcp serve sebagai proses anak stdio dan mengendalikannya sebagai klien MCP. Pengujian ini memverifikasi penemuan percakapan, pembacaan transkrip, pembacaan metadata lampiran, perilaku antrean peristiwa langsung, serta notifikasi kanal dan izin bergaya Claude melalui bridge MCP stdio yang sebenarnya. Perutean pengiriman keluar (messages_send yang menggunakan kembali rute percakapan tersimpan) diuji secara terpisah oleh pengujian unit di src/mcp/channel-server.test.ts.

Ini adalah cara tercepat untuk membuktikan bahwa bridge berfungsi tanpa menghubungkan akun Telegram, Discord, atau iMessage yang sebenarnya ke dalam proses pengujian.

Untuk konteks pengujian yang lebih luas, lihat Pengujian.

Pemecahan masalah

OpenClaw sebagai registri klien MCP

Ini adalah jalur openclaw mcp list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload, dan unset.

Perintah-perintah ini tidak mengekspos OpenClaw melalui MCP. Perintah tersebut mengelola definisi server MCP yang dikelola OpenClaw di bawah mcp.servers dalam konfigurasi OpenClaw. Perintah tersebut tidak membaca server mcporter dari config/mcporter.json.

Definisi tersimpan tersebut ditujukan untuk runtime yang nantinya diluncurkan atau dikonfigurasi oleh OpenClaw, seperti OpenClaw tertanam dan adaptor runtime lainnya. OpenClaw menyimpan definisi tersebut secara terpusat agar runtime itu tidak perlu menyimpan daftar server MCP duplikatnya sendiri.

Adaptor runtime dapat menormalisasi registri bersama ini ke dalam bentuk yang diharapkan oleh klien hilirnya. Misalnya, OpenClaw tertanam menggunakan nilai transport OpenClaw secara langsung, sedangkan Claude Code dan Gemini menerima nilai type native CLI seperti http, sse, atau stdio.

Codex app-server juga mematuhi blok codex opsional pada setiap server. Ini adalah metadata proyeksi OpenClaw khusus untuk utas Codex app-server; metadata ini tidak mengubah sesi ACP, konfigurasi harness Codex generik, atau adaptor runtime lainnya. Gunakan codex.agents yang tidak kosong untuk memproyeksikan server hanya ke id agen OpenClaw tertentu. Daftar agen yang kosong, hanya berisi spasi, atau tidak valid ditolak oleh validasi konfigurasi dan dihilangkan oleh jalur proyeksi runtime, alih-alih menjadi global. Gunakan codex.defaultToolsApprovalMode (auto, prompt, atau approve) untuk menghasilkan default_tools_approval_mode native Codex bagi server tepercaya. OpenClaw menghapus metadata codex sebelum menyerahkan konfigurasi native mcp_servers ke Codex.

Definisi server MCP tersimpan

Perintah:

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

Catatan:

• list mengurutkan nama server.
• show tanpa nama mencetak objek server MCP terkonfigurasi secara lengkap.
• status mengklasifikasikan transportasi yang dikonfigurasi tanpa terhubung. --verbose mencakup detail peluncuran, batas waktu, OAuth, filter, dan pemanggilan paralel yang telah diuraikan, termasuk saat token OAuth tersimpan memerlukan otorisasi tambahan. Argumen stdio yang memuat kredensial disamarkan dalam keluaran teks dan JSON.
• doctor menjalankan pemeriksaan statis tanpa terhubung. Tambahkan --probe saat perintah juga harus memverifikasi bahwa server yang diaktifkan dapat terhubung.
• probe terhubung dan melaporkan jumlah alat, dukungan sumber daya/prompt, dukungan perubahan daftar, dan diagnostik.
• add menerima flag stdio seperti --command, --arg, --env, dan --cwd, atau flag HTTP seperti --url, --transport, --header, --auth oauth, TLS, batas waktu, dan flag pemilihan alat.
• set mengharapkan satu nilai objek JSON pada baris perintah.
• configure memperbarui status pengaktifan, filter alat, batas waktu, OAuth, TLS, dan petunjuk pemanggilan alat paralel tanpa mengganti seluruh definisi server. Tambahkan --probe untuk memverifikasi server yang diperbarui sebelum menyimpan.
• tools memperbarui filter alat per server. Entri penyertaan/pengecualian adalah nama alat MCP dan glob * sederhana.
• login menjalankan alur OAuth untuk server HTTP yang dikonfigurasi dengan auth: "oauth". Proses pertama mencetak URL otorisasi; jalankan kembali dengan --code setelah disetujui.
• logout menghapus kredensial OAuth tersimpan untuk server bernama tanpa menghapus definisi server tersimpan.
• reload membuang runtime MCP dalam proses yang tersimpan dalam cache hanya untuk proses CLI saat ini. Proses Gateway atau agen dalam proses lain tetap memerlukan jalur pemuatan ulang atau mulai ulangnya sendiri.
• Gunakan transport: "streamable-http" untuk server MCP Streamable HTTP. openclaw mcp set juga menormalisasi type: "http" native CLI ke bentuk konfigurasi kanonis yang sama untuk kompatibilitas.
• unset gagal jika server bernama tidak ada.

Contoh:

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

Resep server umum

Contoh-contoh ini hanya menyimpan definisi server. Jalankan openclaw mcp doctor --probe setelahnya untuk membuktikan bahwa server dapat dimulai dan menyediakan alat.

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

Bentuk keluaran JSON

Gunakan --json untuk skrip dan dasbor. Kumpulan bidang dapat bertambah seiring waktu, sehingga konsumen sebaiknya mengabaikan kunci yang tidak dikenal.

{  "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": "Kredensial OAuth belum diotorisasi; jalankan 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": []}

Contoh bentuk konfigurasi:

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

Transportasi Stdio

Meluncurkan proses turunan lokal dan berkomunikasi melalui stdin/stdout.

Transportasi SSE / HTTP

Terhubung ke server MCP jarak jauh melalui HTTP Server-Sent Events.

Contoh:

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

Nilai sensitif dalam url (info pengguna) dan headers disamarkan dalam log dan keluaran status. openclaw mcp doctor memperingatkan ketika entri headers atau env yang tampak sensitif berisi nilai literal, sehingga operator dapat memindahkan nilai tersebut keluar dari konfigurasi yang di-commit.

Alur kerja OAuth

OAuth ditujukan untuk server MCP HTTP yang mengiklankan alur OAuth MCP. Header Authorization statis diabaikan untuk server ketika auth: "oauth" diaktifkan. Kredensial yang disimpan oleh openclaw mcp login berfungsi dengan MCP tertanam, pelaksana CLI, dan server aplikasi Codex lokal.

Sesi OAuth MCP native berada dalam basis data SQLite bersama yang hanya dapat diakses pemilik di <state-dir>/state/openclaw.sqlite (mcp_oauth_stores). Baris tersebut dapat memuat token akses dan penyegaran, rahasia pendaftaran klien dinamis, metadata penemuan, dan pemverifikasi PKCE sementara. Penyegaran, login, dan logout menggunakan lease SQLite yang sama, sehingga proses OpenClaw paralel tidak dapat menggunakan satu token penyegaran atau menghidupkan kembali sesi yang telah logout.

Peningkatan dari penyimpanan <state-dir>/mcp-oauth/*.json yang telah dihentikan hanya ditangani oleh openclaw doctor --fix. Kode runtime tidak pernah membaca, menulis, atau beralih ke berkas tersebut sebagai cadangan.

Hingga kredensial tersedia, OpenClaw hanya menghilangkan server MCP tersebut dari runtime agen, bukan menggagalkan giliran agen. Operator, atau agen dengan akses shell, kemudian dapat menjalankan openclaw mcp login <name> dan menggunakan server pada giliran berikutnya.

Jika server menolak token dengan insufficient_scope, OpenClaw mempertahankan cakupan yang diminta dan meminta openclaw mcp login <name>, alih-alih mengulangi penyegaran yang tidak dapat memberikan cakupan baru. Login tersebut memulai permintaan otorisasi baru sambil mempertahankan token sebelumnya hingga kredensial pengganti disimpan.

Ketika layanan MCP jarak jauh sudah didukung oleh profil autentikasi OpenClaw terpisah yang mampu melakukan penyegaran, Anda dapat menetapkan oauth.authProfileId secara opsional. OpenClaw menyegarkan salah satu sumber kredensial sebelum proyeksi runtime dan hanya meneruskan token akses saat ini ke klien MCP hilir.

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

Jika penyedia merotasi token atau status otorisasi macet, jalankan openclaw mcp logout <name>, lalu ulangi login. logout dapat menghapus kredensial untuk server HTTP yang disimpan bahkan setelah auth: "oauth" dihapus dari konfigurasi, selama nama dan URL server masih mengidentifikasi entri penyimpanan kredensial.

Transport HTTP yang dapat dialirkan

streamable-http adalah opsi transport tambahan di samping sse dan stdio. Opsi ini menggunakan streaming HTTP untuk komunikasi dua arah dengan server MCP jarak jauh.

Konfigurasi OpenClaw menggunakan transport: "streamable-http" sebagai ejaan kanonis. Nilai MCP bawaan CLI type: "http" diterima saat disimpan melalui openclaw mcp set dan diperbaiki oleh openclaw doctor --fix dalam konfigurasi yang ada, tetapi transport adalah yang digunakan langsung oleh OpenClaw tersemat.

Contoh:

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

UI Kontrol

UI Kontrol browser menyertakan halaman pengaturan MCP khusus di /settings/mcp; jalur /mcp sebelumnya tetap menjadi alias. Halaman tersebut menampilkan jumlah server yang dikonfigurasi, ringkasan server yang diaktifkan/OAuth/filter, baris transport per server, kontrol aktifkan/nonaktifkan, perintah CLI umum, dan editor tercakup untuk bagian konfigurasi mcp.

Gunakan halaman tersebut untuk pengeditan oleh operator dan inventaris cepat. Gunakan openclaw mcp doctor --probe atau openclaw mcp probe ketika Anda memerlukan bukti server aktif.

Alur kerja operator:

1. Buka UI Kontrol dan pilih MCP.
2. Tinjau kartu ringkasan untuk total server, server yang diaktifkan, server OAuth, dan server yang difilter.
3. Gunakan setiap baris server untuk melihat petunjuk transport, autentikasi, filter, batas waktu, dan perintah.
4. Alihkan pengaktifan ketika Anda ingin mempertahankan definisi, tetapi mengecualikannya dari penemuan runtime.
5. Edit bagian konfigurasi tercakup mcp untuk perubahan struktural seperti server baru, header, TLS, metadata OAuth, atau filter alat.
6. Pilih Save untuk hanya menyimpan konfigurasi, atau Save & Publish untuk menerapkannya melalui jalur konfigurasi Gateway.
7. Jalankan openclaw mcp doctor --probe ketika Anda memerlukan bukti langsung bahwa server yang diedit dapat dimulai dan mencantumkan alat.

Catatan:

• cuplikan perintah mengapit nama server dengan tanda kutip agar nama yang tidak biasa tetap dapat disalin ke shell
• nilai seperti URL yang ditampilkan disamarkan sebelum dirender jika berisi kredensial tersemat
• halaman tersebut tidak memulai transport MCP dengan sendirinya
• runtime aktif mungkin memerlukan openclaw mcp reload, penerbitan konfigurasi Gateway, atau mulai ulang proses, bergantung pada proses yang memiliki klien MCP

Aplikasi MCP

OpenClaw dapat merender alat yang mengimplementasikan ekstensi Aplikasi MCP stabil. Aplikasi bersifat opsional karena HTML-nya berasal dari server MCP yang dikonfigurasi dan dapat meminta alat atau sumber daya yang terlihat oleh aplikasi dari server yang sama.

Aktifkan jembatan host:

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

Mulai ulang Gateway setelah mengubah pengaturan ini. Saat diaktifkan, OpenClaw memulai listener HTTP(S) khusus sandbox pada port Gateway ditambah satu (untuk Gateway default, 18790). UI Kontrol memuat Aplikasi dari origin terpisah tersebut; listener tidak pernah menyajikan UI Kontrol, rute Gateway terautentikasi, atau data pengguna.

Koneksi Gateway langsung memerlukan akses ke kedua port. Jika proksi balik atau terminator TLS mengekspos UI Kontrol, berikan origin publik khusus untuk Aplikasi dan proksikan hanya origin tersebut ke listener sandbox:

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

Origin sandbox harus berbeda dari origin UI Kontrol. Jangan meng-host konten terautentikasi atau sensitif lainnya di sana.

Sebagai contoh, demo React dasar resmi dapat dikonfigurasi sebagai berikut:

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

Perilaku dan batas keamanan:

• OpenClaw mengumumkan ekstensi io.modelcontextprotocol/ui hanya saat Aplikasi diaktifkan.
• Hanya sumber daya ui:// dengan jenis MIME text/html;profile=mcp-app yang persis sama yang dirender.
• Sumber daya UI dibatasi hingga 2 MiB, ditempatkan di belakang proksi iframe ganda pada origin luar khusus, dimuat ke dalam origin Aplikasi dalam yang opak, dan dibatasi oleh CSP yang diturunkan dari metadata sumber daya.
• Alat khusus Aplikasi (_meta.ui.visibility: ["app"]) tidak disertakan dalam daftar alat model. Aplikasi hanya dapat memanggil alat yang terlihat oleh aplikasi pada server pemiliknya dan juga lolos kebijakan alat OpenClaw efektif untuk proses yang membuat tampilan tersebut.
• Izin Aplikasi yang terikat pada origin, seperti kamera, mikrofon, dan geolokasi, tidak diberikan selama dokumen Aplikasi dalam menggunakan origin opak untuk isolasi lintas Aplikasi.
• HTML Aplikasi, argumen alat lengkap, dan hasil mentah berada dalam sewa tampilan dalam memori terbatas selama sepuluh menit serta tidak ditulis ke disk atau disalin ke metadata pratinjau transkrip. Transkrip hanya menyimpan deskriptor server/alat/sumber daya terbatas yang terkait dengan ID panggilan alat asli. Setelah Gateway dimulai ulang, UI Kontrol dapat memverifikasi deskriptor tersebut terhadap transkrip sesi terautentikasi dan mengambil ulang sumber daya ui://; tampilan yang direkonstruksi bersifat hanya-baca hingga proses baru menetapkan izin alat terkini.
• Dalam percakapan kanal, tampilan Aplikasi terbaru yang berhasil dalam satu giliran menambahkan satu tindakan bergaya Buka Aplikasi ke balasan akhir asisten. DM Telegram menggunakan tombol Mini App bawaan; Slack dan Discord merender tindakan portabel yang sama sebagai tautan. Kanal lain mempertahankan teks balasan asli dan menambahkan tautan HTTPS yang mudah dipahami.
• Tautan peluncuran kanal hanya tersedia ketika eksposur Tailscale Gateway telah menyiapkan origin HTTPS yang dipublikasikan. gateway.tailscale.mode: "serve" hanya dapat dijangkau dari tailnet; "funnel" dapat dijangkau dari internet publik. Funnel yang dikelola secara eksternal dan dipertahankan oleh gateway.tailscale.preserveFunnel juga dianggap dapat dijangkau dari internet. Lihat Tailscale.
• Tiket peluncuran bersifat opak, dibuat hanya saat mematerialisasikan balasan kanal akhir, dan kedaluwarsa setelah paling lama dua menit atau ketika sewa tampilan yang mendasarinya kedaluwarsa, mana saja yang terjadi lebih dahulu. URL tidak berisi kredensial bearer Gateway, kunci sesi, metadata tampilan, HTML Aplikasi, masukan alat, atau hasil alat.
• Jika tidak ada origin yang dipublikasikan atau kapasitas tiket yang tersedia, tampilan atau tiket telah kedaluwarsa, atau transport tidak dapat merender kontrol bawaan, teks asisten asli tetap tersedia. UI Kontrol mempertahankan kanvas Aplikasi sebaris yang ada dan tidak menerima tindakan peluncuran duplikat.
• openclaw security audit memberikan peringatan selama jembatan diaktifkan. Nonaktifkan dengan openclaw config set mcp.apps.enabled false --strict-json ketika tidak diperlukan.

Batas saat ini

Halaman ini mendokumentasikan jembatan sebagaimana dirilis saat ini.

Batas saat ini:

• penemuan percakapan bergantung pada metadata rute sesi Gateway yang ada
• tidak ada protokol push generik selain adaptor khusus Claude
• belum ada alat untuk mengedit pesan atau memberikan reaksi
• transport HTTP/SSE/streamable-http terhubung ke satu server jarak jauh; belum ada upstream termultipleks
• permissions_list_open hanya menyertakan persetujuan yang diamati saat jembatan terhubung

Terkait

• Referensi CLI
• Plugin