MCP

openclaw mcp له مهمتان:

• تشغيل OpenClaw كخادم MCP باستخدام openclaw mcp serve
• إدارة تعريفات خوادم MCP الصادرة التي يديرها OpenClaw باستخدام list وshow وstatus وdoctor وprobe وadd وset وconfigure وtools وlogin وlogout وreload وunset

يمثل serve عمل OpenClaw كخادم MCP. أما الأوامر الفرعية الأخرى فتمثل عمل OpenClaw كسجل من جانب عميل MCP للخوادم التي قد تستهلكها بيئات التشغيل الخاصة به لاحقًا.

استخدم openclaw acp عندما ينبغي أن يستضيف OpenClaw جلسة بيئة برمجة بنفسه ويوجّه بيئة التشغيل تلك عبر ACP.

اختيار مسار MCP المناسب

OpenClaw كخادم MCP

هذا هو مسار openclaw mcp serve.

متى تستخدم serve

استخدم openclaw mcp serve عندما:

• ينبغي أن يتواصل Codex أو Claude Code أو عميل MCP آخر مباشرةً مع محادثات القنوات المدعومة من OpenClaw
• لديك بالفعل Gateway محلي أو بعيد لـ OpenClaw مع جلسات موجّهة
• تريد خادم MCP واحدًا يعمل عبر الواجهات الخلفية لقنوات OpenClaw بدلًا من تشغيل جسور منفصلة لكل قناة

استخدم openclaw acp بدلًا من ذلك عندما ينبغي أن يستضيف OpenClaw بيئة تشغيل البرمجة بنفسه ويُبقي جلسة الوكيل داخل OpenClaw.

آلية العمل

يبدأ openclaw mcp serve خادم MCP يعمل عبر stdio. يمتلك عميل MCP تلك العملية. وطالما أبقى العميل جلسة stdio مفتوحة، يتصل الجسر بـ Gateway محلي أو بعيد لـ OpenClaw عبر WebSocket ويعرض محادثات القنوات الموجّهة عبر MCP.

اختيار وضع العميل

ما يعرضه serve

يستخدم الجسر بيانات تعريف مسار جلسة Gateway الحالية لعرض المحادثات المدعومة بالقنوات. تظهر المحادثة عندما تكون لدى OpenClaw بالفعل حالة جلسة ذات مسار معروف، مثل:

• channel
• بيانات تعريف المستلم أو الوجهة
• accountId اختياري
• threadId اختياري

يمنح ذلك عملاء MCP مكانًا واحدًا من أجل:

• سرد المحادثات الموجّهة الحديثة
• قراءة سجل النصوص المنسوخة الحديث
• انتظار الأحداث الواردة الجديدة
• إرسال رد عبر المسار نفسه
• رؤية طلبات الموافقة التي تصل أثناء اتصال الجسر

الاستخدام

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

أدوات الجسر

نموذج الأحداث

يحتفظ الجسر بقائمة انتظار أحداث في الذاكرة أثناء اتصاله.

أنواع الأحداث الحالية:

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

إشعارات قناة Claude

يمكن للجسر أيضًا عرض إشعارات قناة خاصة بـ Claude. وهذا هو مكافئ OpenClaw لمحوّل قناة Claude Code: تظل أدوات MCP القياسية متاحة، لكن يمكن أن تصل الرسائل الواردة المباشرة أيضًا كإشعارات MCP خاصة بـ Claude.

عندما يكون وضع قناة Claude مفعّلًا، يعلن الخادم عن إمكانات Claude التجريبية ويمكنه إصدار:

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

سلوك الجسر الحالي:

• تُعاد توجيه رسائل النصوص المنسوخة الواردة من النوع user بصفتها notifications/claude/channel
• يتم تتبع طلبات أذونات Claude الواردة عبر MCP في الذاكرة
• إذا أرسل مالك الأمر في المحادثة المرتبطة لاحقًا yes <id> أو no <id> (يمثل <id> معرّف الطلب المكوّن من 5 أحرف، باستثناء l) يحوّل الجسر ذلك إلى notifications/claude/channel/permission
• هذه الإشعارات خاصة بالجلسة المباشرة فقط؛ وإذا انقطع اتصال عميل MCP، فلن توجد وجهة للدفع

هذا خاص بالعميل عن قصد. ينبغي أن تعتمد عملاء MCP العامة على أدوات الاستقصاء القياسية.

إعدادات عميل MCP

مثال على إعداد عميل stdio:

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

بالنسبة إلى معظم عملاء MCP العامّين، ابدأ بواجهة الأدوات القياسية وتجاهل وضع Claude. فعّل وضع Claude فقط للعملاء الذين يفهمون فعليًا أساليب الإشعارات الخاصة بـ Claude.

الخيارات

يدعم openclaw mcp serve ما يلي:

حدود الأمان والثقة

لا ينشئ الجسر مسارات توجيه من تلقاء نفسه. بل يعرض فقط المحادثات التي يعرف Gateway بالفعل كيفية توجيهها.

وهذا يعني:

• تظل قوائم السماح بالمرسلين والاقتران والثقة على مستوى القناة تابعة لإعداد قناة OpenClaw الأساسية
• لا يستطيع messages_send الرد إلا عبر مسار مخزّن موجود
• تكون حالة الموافقات مباشرة/في الذاكرة فقط لجلسة الجسر الحالية
• يجب أن تستخدم مصادقة الجسر ضوابط رمز Gateway المميز أو كلمة المرور نفسها التي تثق بها لأي عميل Gateway بعيد آخر

إذا كانت إحدى المحادثات مفقودة من conversations_list، فعادةً لا يكون السبب إعداد MCP، بل بيانات تعريف مسار مفقودة أو غير مكتملة في جلسة Gateway الأساسية.

الاختبار

يتضمن OpenClaw اختبار Docker تمهيديًا حتميًا لهذا الجسر:

pnpm test:docker:mcp-channels

يشغّل هذا الاختبار حاوية واحدة: يهيئ حالة المحادثة، ويبدأ Gateway، ثم ينشئ openclaw mcp serve كعملية stdio فرعية ويتحكم فيه بصفته عميل MCP. ويتحقق من اكتشاف المحادثات، وقراءة النصوص المنسوخة، وقراءة بيانات تعريف المرفقات، وسلوك طابور الأحداث المباشرة، وإشعارات القنوات والأذونات بأسلوب Claude عبر جسر stdio MCP الحقيقي. ويُغطّى توجيه الإرسال الصادر (messages_send الذي يعيد استخدام مسار المحادثة المخزّن) بشكل منفصل بواسطة اختبارات الوحدة في src/mcp/channel-server.test.ts.

هذه أسرع طريقة لإثبات عمل الجسر دون ربط حساب Telegram أو Discord أو iMessage حقيقي بتشغيل الاختبار.

للاطلاع على سياق أوسع للاختبارات، راجع الاختبار.

استكشاف الأخطاء وإصلاحها

OpenClaw كسجل لعملاء MCP

هذا هو مسار openclaw mcp list وshow وstatus وdoctor وprobe وadd وset، وconfigure وtools وlogin وlogout وreload وunset.

لا تعرض هذه الأوامر OpenClaw عبر MCP. بل تدير تعريفات خوادم MCP التي يديرها OpenClaw ضمن mcp.servers في إعداد OpenClaw. وهي لا تقرأ خوادم mcporter من config/mcporter.json.

هذه التعريفات المحفوظة مخصصة لبيئات التشغيل التي يشغّلها OpenClaw أو يضبطها لاحقًا، مثل OpenClaw المضمّن ومهايئات بيئات التشغيل الأخرى. يخزّن OpenClaw التعريفات مركزيًا كي لا تضطر بيئات التشغيل هذه إلى الاحتفاظ بقوائم مكررة خاصة بها لخوادم MCP.

قد تطبّع مهايئات بيئات التشغيل هذا السجل المشترك إلى الشكل الذي يتوقعه عميلها اللاحق. على سبيل المثال، يستهلك OpenClaw المضمّن قيم transport الخاصة بـ OpenClaw مباشرةً، بينما يتلقى Claude Code وGemini قيم type الأصلية للـ CLI، مثل http أو sse أو stdio.

يحترم خادم تطبيق Codex أيضًا كتلة codex اختيارية في كل خادم. هذه بيانات تعريف إسقاط OpenClaw لسلاسل رسائل خادم تطبيق Codex فقط؛ وهي لا تغيّر جلسات ACP أو إعداد حاضنة Codex العامة أو مهايئات بيئات التشغيل الأخرى. استخدم codex.agents غير فارغ لإسقاط خادم في معرّفات وكلاء OpenClaw المحددة فقط. ترفض عملية التحقق من الإعداد قوائم الوكلاء الفارغة أو الخالية أو غير الصالحة، ويحذفها مسار إسقاط بيئة التشغيل بدلًا من جعلها عامة. استخدم codex.defaultToolsApprovalMode ‏(auto أو prompt أو approve) لإصدار default_tools_approval_mode الأصلي الخاص بـ Codex لخادم موثوق. يزيل OpenClaw بيانات تعريف codex قبل تسليم إعداد mcp_servers الأصلي إلى Codex.

تعريفات خوادم MCP المحفوظة

الأوامر:

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

ملاحظات:

• يرتّب list أسماء الخوادم.
• يطبع show من دون اسم كائن خادم MCP المضبوط كاملًا.
• يصنّف status وسائل النقل المضبوطة دون اتصال. ويتضمن --verbose تفاصيل التشغيل والمهلة وOAuth والمرشّح والاستدعاء المتوازي بعد حلّها.
• ينفّذ doctor فحوصات ثابتة دون اتصال. أضف --probe عندما ينبغي للأمر أيضًا التحقق من اتصال الخوادم المفعّلة.
• يتصل probe ويبلغ عن أعداد الأدوات، ودعم الموارد/المطالبات، ودعم تغيّر القوائم، والتشخيصات.
• يقبل add علامات stdio مثل --command و--arg و--env و--cwd، أو علامات HTTP مثل --url و--transport و--header و--auth oauth، إلى جانب علامات TLS والمهلة واختيار الأدوات.
• يتوقع set قيمة كائن JSON واحدة في سطر الأوامر.
• يحدّث configure التمكين ومرشّحات الأدوات والمهل وOAuth وTLS وتلميحات استدعاء الأدوات المتوازي دون استبدال تعريف الخادم كاملًا. أضف --probe للتحقق من الخادم المحدّث قبل الحفظ.
• يحدّث tools مرشّحات الأدوات لكل خادم. تكون إدخالات التضمين/الاستبعاد أسماء أدوات MCP وأنماط * عامة بسيطة.
• يشغّل login تدفق OAuth لخوادم HTTP المضبوطة باستخدام auth: "oauth". تطبع عملية التشغيل الأولى عنوان URL للتفويض؛ أعد التشغيل باستخدام --code بعد الموافقة.
• يمسح logout بيانات اعتماد OAuth المخزّنة للخادم المسمى دون إزالة تعريف الخادم المحفوظ.
• يتخلص reload من بيئات تشغيل MCP المخبأة داخل العملية لعملية CLI الحالية فقط. ولا تزال عمليات Gateway أو الوكلاء الموجودة في عملية أخرى بحاجة إلى مسار إعادة التحميل أو إعادة التشغيل الخاص بها.
• استخدم transport: "streamable-http" لخوادم Streamable HTTP MCP. كما يطبّع openclaw mcp set قيمة type: "http" الأصلية للـ CLI إلى شكل الإعداد القياسي نفسه لأغراض التوافق.
• يفشل unset إذا لم يكن الخادم المسمى موجودًا.

أمثلة:

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

وصفات شائعة للخوادم

تحفظ هذه الأمثلة تعريفات الخوادم فقط. شغّل openclaw mcp doctor --probe بعدها لإثبات أن الخادم يبدأ ويعرض الأدوات.

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

أشكال مخرجات JSON

استخدم --json للبرامج النصية ولوحات المعلومات. قد تتوسع مجموعات الحقول بمرور الوقت، لذا ينبغي للمستهلكين تجاهل المفاتيح غير المعروفة.

{  "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": "بيانات اعتماد OAuth غير مخوّلة؛ شغّل 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": []}

مثال على شكل الإعدادات:

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

نقل Stdio

يشغّل عملية فرعية محلية ويتواصل عبر stdin/stdout.

نقل SSE / HTTP

يتصل بخادم MCP بعيد عبر أحداث HTTP المرسلة من الخادم.

مثال:

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

تُنقّح القيم الحساسة في url (معلومات المستخدم) وheaders في السجلات ومخرجات الحالة. يحذر openclaw mcp doctor عندما تحتوي إدخالات headers أو env التي تبدو حساسة على قيم حرفية، بحيث يستطيع المشغّلون نقل تلك القيم خارج الإعدادات المودعة.

سير عمل OAuth

يُستخدم OAuth لخوادم MCP عبر HTTP التي تعلن عن تدفق MCP لـ OAuth. تُتجاهل ترويسات Authorization الثابتة للخادم ما دام auth: "oauth" مفعّلًا. تعمل بيانات الاعتماد المحفوظة بواسطة openclaw mcp login مع MCP المضمّن ومشغّلات CLI وخادم تطبيق Codex المحلي.

إلى أن تتوفر بيانات الاعتماد، يحذف OpenClaw خادم MCP ذاك فقط من وقت تشغيل الوكيل بدلًا من إفشال دورة الوكيل. ويمكن للمشغّل، أو لوكيل لديه وصول إلى الصدفة، تشغيل openclaw mcp login <name> ثم استخدام الخادم في دورة لاحقة.

عندما تكون خدمة MCP بعيدة مدعومة بالفعل بملف تعريف مصادقة منفصل في OpenClaw قادر على التحديث، يمكنك اختياريًا ضبط oauth.authProfileId. يحدّث OpenClaw أيًا من مصدري بيانات الاعتماد قبل إسقاط وقت التشغيل، ولا يمرر إلى عميل MCP اللاحق سوى رمز الوصول الحالي.

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

إذا أجرى المزوّد تدويرًا للرموز المميزة أو علقت حالة التفويض، فشغّل openclaw mcp logout <name>، ثم كرر login. يمكن للأمر logout مسح بيانات اعتماد خادم HTTP محفوظ حتى بعد إزالة auth: "oauth" من الإعداد، ما دام اسم الخادم وعنوان URL لا يزالان يحددان إدخال مخزن بيانات الاعتماد.

نقل HTTP القابل للبث

يُعد streamable-http خيار نقل إضافيًا إلى جانب sse وstdio. ويستخدم بث HTTP للاتصال ثنائي الاتجاه بخوادم MCP البعيدة.

يستخدم إعداد OpenClaw الصيغة transport: "streamable-http" بوصفها الصيغة القياسية. تُقبل قيم MCP الأصلية في CLI ‏type: "http" عند حفظها عبر openclaw mcp set، ويُصلحها openclaw doctor --fix في الإعداد الحالي، لكن transport هو ما يستهلكه OpenClaw المضمّن مباشرةً.

مثال:

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

واجهة التحكم

تتضمن واجهة التحكم في المتصفح صفحة مخصصة لإعدادات MCP في /settings/mcp؛ ويظل المسار السابق /mcp اسمًا مستعارًا. تعرض الصفحة أعداد الخوادم المضبوطة، وملخصات التمكين وOAuth والتصفية، وصفوف النقل لكل خادم، وعناصر التحكم في التمكين والتعطيل، وأوامر CLI الشائعة، ومحررًا محدد النطاق لقسم الإعداد mcp.

استخدم الصفحة لإجراء تعديلات المشغّل والجرد السريع. استخدم openclaw mcp doctor --probe أو openclaw mcp probe عندما تحتاج إلى إثبات حي للخادم.

سير عمل المشغّل:

1. افتح واجهة التحكم واختر MCP.
2. راجع بطاقات الملخص لإجمالي الخوادم والممكّنة منها وخوادم OAuth والخوادم المصفّاة.
3. استخدم صف كل خادم للاطلاع على تلميحات النقل والمصادقة والتصفية والمهلة والأوامر.
4. بدّل حالة التمكين عندما تريد الاحتفاظ بتعريف مع استبعاده من اكتشاف وقت التشغيل.
5. حرّر قسم الإعداد محدد النطاق mcp لإجراء تغييرات بنيوية، مثل إضافة خوادم أو ترويسات أو TLS أو بيانات OAuth الوصفية أو مرشحات الأدوات.
6. اختر حفظ للاحتفاظ بالإعداد فقط، أو حفظ ونشر لتطبيقه عبر مسار إعداد Gateway.
7. شغّل openclaw mcp doctor --probe عندما تحتاج إلى إثبات حي على أن الخادم المعدّل يبدأ ويسرد الأدوات.

ملاحظات:

• تضع مقتطفات الأوامر أسماء الخوادم بين علامتي اقتباس لكي تظل الأسماء غير المعتادة قابلة للنسخ في الصدفة
• تُنقّح القيم المعروضة الشبيهة بعناوين URL قبل التصيير عندما تحتوي على بيانات اعتماد مضمنة
• لا تبدأ الصفحة عمليات نقل MCP بنفسها
• قد تحتاج أوقات التشغيل النشطة إلى openclaw mcp reload أو نشر إعداد Gateway أو إعادة تشغيل العملية، بحسب العملية المالكة لعملاء MCP

تطبيقات MCP

يمكن لـ OpenClaw تصيير الأدوات التي تنفذ امتداد تطبيقات MCP المستقر. تكون التطبيقات اختيارية لأن HTML الخاص بها يأتي من خادم MCP المضبوط، ويمكنه طلب أدوات أو موارد مرئية للتطبيق من الخادم نفسه.

مكّن جسر المضيف:

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

أعد تشغيل Gateway بعد تغيير هذا الإعداد. عند التمكين، يبدأ OpenClaw مستمع HTTP(S) خاصًا بصندوق العزل على منفذ Gateway زائد واحد (بالنسبة إلى Gateway الافتراضي، 18790). تحمّل واجهة التحكم التطبيقات من ذلك الأصل المنفصل؛ ولا يقدم المستمع مطلقًا واجهة التحكم أو مسارات Gateway المصادَق عليها أو بيانات المستخدم.

تحتاج الاتصالات المباشرة بـ Gateway إلى الوصول إلى كلا المنفذين. إذا كشف وكيل عكسي أو مُنهي TLS واجهة التحكم، فامنح التطبيقات أصلًا عامًا مخصصًا، ومرّر ذلك الأصل وحده إلى مستمع صندوق العزل:

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

يجب أن يختلف أصل صندوق العزل عن أصل واجهة التحكم. لا تستضف عليه أي محتوى آخر مصادَق عليه أو حساس.

على سبيل المثال، يمكن ضبط العرض التوضيحي الرسمي الأساسي المبني باستخدام React على النحو الآتي:

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

السلوك والحدود الأمنية:

• لا يعلن OpenClaw عن امتداد io.modelcontextprotocol/ui إلا عند تمكين التطبيقات.
• لا تُصيّر سوى موارد ui:// ذات نوع MIME المطابق تمامًا لـ text/html;profile=mcp-app.
• تُحدد موارد واجهة المستخدم بحد أقصى قدره 2 MiB، وتوضع خلف وكيل ذي إطاري iframe متداخلين على أصل خارجي مخصص، وتُحمّل في أصل تطبيق داخلي مبهم، وتُقيّد بواسطة CSP مشتقة من البيانات الوصفية للمورد.
• تظل الأدوات الخاصة بالتطبيق فقط (_meta.ui.visibility: ["app"]) خارج قوائم أدوات النموذج. ولا يمكن للتطبيقات استدعاء سوى الأدوات المرئية للتطبيق على الخادم المالك لها، التي تجتاز أيضًا سياسة أدوات OpenClaw الفعلية للتشغيل الذي أنشأ طريقة العرض.
• لا تُمنح أذونات التطبيقات المرتبطة بالأصل، مثل الكاميرا والميكروفون والموقع الجغرافي، ما دامت مستندات التطبيقات الداخلية تستخدم أصولًا مبهمة للعزل بين التطبيقات.
• يظل HTML الخاص بالتطبيق ووسائط الأدوات الكاملة والنتائج الأولية ضمن مدة إيجار محدودة لطريقة العرض في الذاكرة مقدارها عشر دقائق، ولا تُكتب إلى القرص ولا تُنسخ إلى بيانات المعاينة الوصفية للنص المنسوخ. لا يخزّن النص المنسوخ سوى واصف محدود للخادم والأداة والمورد مرتبط بمعرّف استدعاء الأداة الأصلي. بعد إعادة تشغيل Gateway، يمكن لواجهة التحكم التحقق من ذلك الواصف مقابل النص المنسوخ للجلسة المصادَق عليها وإعادة جلب مورد ui://؛ وتكون طرق العرض المُعاد إنشاؤها للقراءة فقط إلى أن ينشئ تشغيل جديد أذونات الأدوات الحالية.
• يحذّر openclaw security audit أثناء تمكين الجسر. عطّله باستخدام openclaw config set mcp.apps.enabled false --strict-json عندما لا تكون هناك حاجة إليه.

الحدود الحالية

توثّق هذه الصفحة الجسر كما هو متاح حاليًا.

الحدود الحالية:

• يعتمد اكتشاف المحادثات على البيانات الوصفية الحالية لمسار جلسة Gateway
• لا يوجد بروتوكول دفع عام يتجاوز المحوّل الخاص بـ Claude
• لا تتوفر بعد أدوات لتعديل الرسائل أو إضافة تفاعلات إليها
• يتصل نقل HTTP/SSE/streamable-http بخادم بعيد واحد؛ ولا تتوفر بعد اتصالات صاعدة متعددة الإرسال
• لا يتضمن permissions_list_open سوى الموافقات المرصودة أثناء اتصال الجسر

ذو صلة

• مرجع CLI
• Plugins