​

mcp

• تشغيل OpenClaw كخادم MCP باستخدام openclaw mcp serve
• إدارة تعريفات خوادم MCP الصادرة والمملوكة لـ OpenClaw باستخدام list وshow، وset، وunset

• serve يعني أن OpenClaw يعمل كخادم MCP
• list / show / set / unset تعني أن OpenClaw يعمل كسجل MCP من جهة العميل لخوادم MCP أخرى قد تستهلكها بيئات تشغيله لاحقًا

​

OpenClaw كخادم MCP

​

متى تستخدم serve

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

​

كيف يعمل

1. يشغّل عميل MCP الأمر openclaw mcp serve
2. يتصل الجسر بـ Gateway
3. تصبح الجلسات الموجّهة محادثات MCP وأدوات النصوص/السجل
4. تُصفّ أحداث البث المباشر في الذاكرة بينما يكون الجسر متصلًا
5. إذا كان وضع قناة Claude مفعّلًا، يمكن للجلسة نفسها أيضًا تلقي إشعارات دفع خاصة بـ Claude

• تبدأ حالة قائمة الانتظار الحية عندما يتصل الجسر
• يُقرأ سجل النصوص الأقدم باستخدام messages_read
• لا توجد إشعارات دفع Claude إلا أثناء بقاء جلسة MCP حيّة
• عندما ينفصل العميل، يخرج الجسر وتختفي قائمة الانتظار الحية

​

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

• عملاء MCP العامون: أدوات MCP قياسية فقط. استخدم conversations_list، وmessages_read، وevents_poll، وevents_wait، وmessages_send، و أدوات الموافقة.
• Claude Code: أدوات MCP القياسية بالإضافة إلى مكيّف القناة الخاص بـ Claude. فعّل --claude-channel-mode on أو اترك القيمة الافتراضية auto.

​

ما الذي يكشفه serve

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

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

​

الاستخدام

# Gateway محلي
openclaw mcp serve

# Gateway بعيد
openclaw mcp serve --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

# Gateway بعيد مع مصادقة كلمة مرور
openclaw mcp serve --url wss://gateway-host:18789 --password-file ~/.openclaw/gateway.password

# تمكين سجلات الجسر المفصلة
openclaw mcp serve --verbose

# تعطيل إشعارات الدفع الخاصة بـ Claude
openclaw mcp serve --claude-channel-mode off

​

أدوات الجسر

• conversations_list
• conversation_get
• messages_read
• attachments_fetch
• events_poll
• events_wait
• messages_send
• permissions_list_open
• permissions_respond

​

conversations_list

• limit
• search
• channel
• includeDerivedTitles
• includeLastMessage

​

conversation_get

​

messages_read

​

attachments_fetch

​

events_poll

​

events_wait

​

messages_send

• يتطلب مسار محادثة موجودًا
• يستخدم القناة الخاصة بالجلسة، والمستلم، ومعرّف الحساب، ومعرّف السلسلة
• يرسل نصًا فقط

​

permissions_list_open

​

permissions_respond

• allow-once
• allow-always
• deny

​

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

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

• قائمة الانتظار حية فقط؛ تبدأ عندما يبدأ جسر MCP
• لا يعيد events_poll وevents_wait تشغيل سجل Gateway الأقدم من تلقاء نفسيهما
• يجب قراءة التراكم الدائم باستخدام messages_read

​

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

• --claude-channel-mode off: أدوات MCP قياسية فقط
• --claude-channel-mode on: تمكين إشعارات قناة Claude
• --claude-channel-mode auto: القيمة الافتراضية الحالية؛ سلوك الجسر نفسه كما في on

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

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

​

إعداد عميل MCP

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

​

الخيارات

• --url <url>: عنوان URL لـ Gateway WebSocket
• --token <token>: رمز Gateway المميز
• --token-file <path>: قراءة الرمز المميز من ملف
• --password <password>: كلمة مرور Gateway
• --password-file <path>: قراءة كلمة المرور من ملف
• --claude-channel-mode <auto|on|off>: وضع إشعارات Claude
• -v, --verbose: سجلات مفصلة على stderr

​

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

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

​

الاختبار

pnpm test:docker:mcp-channels

• يبدأ حاوية Gateway مهيأة مسبقًا
• يبدأ حاوية ثانية تشغّل openclaw mcp serve
• يتحقق من اكتشاف المحادثات، وقراءات النصوص، وقراءات بيانات تعريف المرفقات، وسلوك قائمة انتظار الأحداث الحية، وتوجيه الإرسال الصادر
• يتحقق من إشعارات القنوات والأذونات بنمط Claude عبر جسر MCP الحقيقي عبر stdio

​

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

​

لم يتم إرجاع أي محادثات

​

يفوّت events_poll أو events_wait الرسائل الأقدم

​

لا تظهر إشعارات Claude

• أبقى العميل جلسة stdio MCP مفتوحة
• كانت قيمة --claude-channel-mode هي on أو auto
• يفهم العميل فعليًا طرق الإشعارات الخاصة بـ Claude
• حدثت الرسالة الواردة بعد اتصال الجسر

​

الموافقات مفقودة

​

OpenClaw كسجل عميل MCP

• هذه الأوامر تقرأ أو تكتب إعدادات OpenClaw فقط
• لا تتصل بخادم MCP الهدف
• لا تتحقق مما إذا كان الأمر أو عنوان URL أو النقل البعيد قابلًا للوصول الآن
• تقرر مكيّفات وقت التشغيل أشكال النقل التي تدعمها فعليًا وقت التنفيذ

​

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

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

• يقوم list بترتيب أسماء الخوادم.
• يطبع show من دون اسم كائن خادم MCP المهيأ بالكامل.
• يتوقع set قيمة كائن JSON واحدة في سطر الأوامر.
• يفشل unset إذا لم يكن الخادم المسمى موجودًا.

openclaw mcp list
openclaw mcp show context7 --json
openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'
openclaw mcp set docs '{"url":"https://mcp.example.com"}'
openclaw mcp unset context7

{
  "mcp": {
    "servers": {
      "context7": {
        "command": "uvx",
        "args": ["context7-mcp"]
      },
      "docs": {
        "url": "https://mcp.example.com"
      }
    }
  }
}

​

نقل stdio

​

نقل SSE / HTTP

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

​

نقل streamable HTTP

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

​

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

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