​

Matrix

​

الإضافة المدمجة

openclaw plugins install @openclaw/matrix

openclaw plugins install ./path/to/local/matrix-plugin

​

الإعداد

1. تأكد من توفر إضافة Matrix.
   • إصدارات OpenClaw المجمعة الحالية تتضمنها بالفعل.
   • يمكن للتثبيتات الأقدم/المخصصة إضافتها يدويًا باستخدام الأوامر أعلاه.
2. أنشئ حساب Matrix على خادمك المنزلي.
3. هيئ channels.matrix باستخدام أحد الخيارين:
   • homeserver + accessToken، أو
   • homeserver + userId + password.
4. أعد تشغيل Gateway.
5. ابدأ رسالة مباشرة مع البوت أو ادعه إلى غرفة.

openclaw channels add
openclaw configure --section channels

• عنوان URL للخادم المنزلي
• طريقة المصادقة: access token أو كلمة مرور
• معرّف المستخدم فقط عند اختيار المصادقة بكلمة المرور
• اسم الجهاز اختياريًا
• ما إذا كنت تريد تمكين E2EE
• ما إذا كنت تريد تهيئة وصول غرفة Matrix الآن

• إذا كانت متغيرات بيئة مصادقة Matrix موجودة بالفعل للحساب المحدد، وكان هذا الحساب لا يحتوي بالفعل على بيانات مصادقة محفوظة في الإعداد، فإن المعالج يعرض اختصار env ويكتب فقط enabled: true لذلك الحساب.
• عند إضافة حساب Matrix آخر بشكل تفاعلي، يتم تطبيع اسم الحساب الذي أدخلته إلى معرّف الحساب المستخدم في الإعداد ومتغيرات env. على سبيل المثال، تصبح Ops Bot هي ops-bot.
• تقبل مطالبات قائمة السماح للرسائل المباشرة قيم @user:server الكاملة مباشرة. ولا تعمل أسماء العرض إلا عندما يعثر البحث الحي في الدليل على تطابق واحد دقيق؛ وإلا يطلب منك المعالج إعادة المحاولة باستخدام معرّف Matrix كامل.
• تقبل مطالبات قائمة السماح للغرف معرّفات الغرف والأسماء المستعارة مباشرة. ويمكنها أيضًا حل أسماء الغرف المنضم إليها حيًا، لكن الأسماء غير المحلولة لا يتم الاحتفاظ بها إلا كما كُتبت أثناء الإعداد ويتم تجاهلها لاحقًا بواسطة حل قائمة السماح في وقت التشغيل. فضّل !room:server أو #alias:server.
• تستخدم هوية الغرفة/الجلسة في وقت التشغيل معرّف غرفة Matrix الثابت. ولا تُستخدم الأسماء المستعارة المعلنة للغرفة إلا كمدخلات بحث، وليس كمفتاح جلسة طويل الأمد أو هوية مجموعة ثابتة.
• لحل أسماء الغرف قبل حفظها، استخدم openclaw channels resolve --channel matrix "Project Room".

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_xxx",
      dm: { policy: "pairing" },
    },
  },
}

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      userId: "@bot:example.org",
      password: "replace-me", // pragma: allowlist secret
      deviceName: "OpenClaw Gateway",
    },
  },
}

• MATRIX_HOMESERVER
• MATRIX_ACCESS_TOKEN
• MATRIX_USER_ID
• MATRIX_PASSWORD
• MATRIX_DEVICE_ID
• MATRIX_DEVICE_NAME

• MATRIX_<ACCOUNT_ID>_HOMESERVER
• MATRIX_<ACCOUNT_ID>_ACCESS_TOKEN
• MATRIX_<ACCOUNT_ID>_USER_ID
• MATRIX_<ACCOUNT_ID>_PASSWORD
• MATRIX_<ACCOUNT_ID>_DEVICE_ID
• MATRIX_<ACCOUNT_ID>_DEVICE_NAME

• MATRIX_OPS_HOMESERVER
• MATRIX_OPS_ACCESS_TOKEN

• MATRIX_OPS_X2D_BOT_HOMESERVER
• MATRIX_OPS_X2D_BOT_ACCESS_TOKEN

​

مثال على التهيئة

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_xxx",
      encryption: true,

      dm: {
        policy: "pairing",
        threadReplies: "off",
      },

      groupPolicy: "allowlist",
      groupAllowFrom: ["@admin:example.org"],
      groups: {
        "!roomid:example.org": {
          requireMention: true,
        },
      },

      autoJoin: "allowlist",
      autoJoinAllowlist: ["!roomid:example.org"],
      threadReplies: "inbound",
      replyToMode: "off",
      streaming: "partial",
    },
  },
}

​

معاينات البث

{
  channels: {
    matrix: {
      streaming: "partial",
    },
  },
}

• القيمة الافتراضية هي streaming: "off". ينتظر OpenClaw الرد النهائي ثم يرسله مرة واحدة.
• ينشئ streaming: "partial" رسالة معاينة واحدة قابلة للتعديل لكتلة المساعد الحالية بدلًا من إرسال عدة رسائل جزئية.
• يفعّل blockStreaming: true رسائل تقدم Matrix منفصلة. ومع streaming: "partial"، تحتفظ Matrix بالمسودة الحية للكتلة الحالية وتحافظ على الكتل المكتملة كرسائل منفصلة.
• عندما تكون streaming: "partial" وblockStreaming معطلة، لا تقوم Matrix إلا بتعديل المسودة الحية وترسل الرد المكتمل عند انتهاء تلك الكتلة أو الدورة.
• إذا لم تعد المعاينة تتسع لحدث Matrix واحد، يوقف OpenClaw بث المعاينة ويرجع إلى الإرسال النهائي العادي.
• تواصل ردود الوسائط إرسال المرفقات بشكل طبيعي. وإذا تعذر إعادة استخدام معاينة قديمة بأمان، يقوم OpenClaw بتنقيحها قبل إرسال رد الوسائط النهائي.
• تعديلات المعاينة تستهلك استدعاءات إضافية إلى Matrix API. اترك البث معطلًا إذا كنت تريد السلوك الأكثر تحفظًا فيما يتعلق بحدود المعدل.

​

التشفير والتحقق

​

غرف بوت إلى بوت

{
  channels: {
    matrix: {
      allowBots: "mentions", // true | "mentions"
      groups: {
        "!roomid:example.org": {
          requireMention: true,
        },
      },
    },
  },
}

• يقبل allowBots: true الرسائل من حسابات Matrix bot أخرى مهيأة في الغرف المسموح بها والرسائل المباشرة.
• يقبل allowBots: "mentions" تلك الرسائل فقط عندما تشير بوضوح إلى هذا البوت في الغرف. وتظل الرسائل المباشرة مسموحًا بها.
• تتجاوز groups.<room>.allowBots الإعداد على مستوى الحساب لغرفة واحدة.
• يواصل OpenClaw تجاهل الرسائل من معرّف مستخدم Matrix نفسه لتجنب حلقات الرد الذاتي.
• لا تكشف Matrix هنا عن علامة bot أصلية؛ ويتعامل OpenClaw مع “منشأ بواسطة bot” على أنه “أرسلته حساب Matrix آخر مهيأ على Gateway OpenClaw هذا”.

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_xxx",
      encryption: true,
      dm: { policy: "pairing" },
    },
  },
}

openclaw matrix verify status

openclaw matrix verify status --verbose

openclaw matrix verify status --include-recovery-key --json

openclaw matrix verify bootstrap

openclaw matrix verify bootstrap --verbose

openclaw matrix verify bootstrap --force-reset-cross-signing

openclaw matrix verify device "<your-recovery-key>"

openclaw matrix verify device "<your-recovery-key>" --verbose

openclaw matrix verify backup status

openclaw matrix verify backup status --verbose

openclaw matrix verify backup restore

openclaw matrix verify backup restore --verbose

openclaw matrix verify backup reset --yes

openclaw matrix verify status --account assistant
openclaw matrix verify backup restore --account assistant
openclaw matrix devices list --account assistant

​

ما معنى “تم التحقق”

• Locally trusted: هذا الجهاز موثوق به من قبل العميل الحالي فقط
• Cross-signing verified: يفيد SDK بأن الجهاز تم التحقق منه عبر cross-signing
• Signed by owner: تم توقيع الجهاز بواسطة مفتاح self-signing الخاص بك

​

ماذا يفعل bootstrap

• يهيئ التخزين السري، مع إعادة استخدام مفتاح استرداد موجود متى أمكن
• يهيئ cross-signing ويرفع مفاتيح cross-signing العامة الناقصة
• يحاول وسم الجهاز الحالي وتوقيعه عبر cross-signing
• ينشئ نسخة احتياطية جديدة لمفاتيح الغرف على الخادم إذا لم تكن موجودة بالفعل

​

خط أساس جديد للنسخ الاحتياطي

openclaw matrix verify backup reset --yes
openclaw matrix verify backup status --verbose
openclaw matrix verify status

​

سلوك بدء التشغيل

• يعيد OpenClaw تلقائيًا استخدام حساب Matrix نفسه، وaccess token نفسه، وهوية الجهاز نفسها متى أمكن.
• قبل تشغيل أي تغييرات ترحيل Matrix قابلة للتنفيذ، ينشئ OpenClaw أو يعيد استخدام لقطة استرداد ضمن ~/Backups/openclaw-migrations/.
• إذا كنت تستخدم عدة حسابات Matrix، فاضبط channels.matrix.defaultAccount قبل الترقية من تخطيط التخزين المسطح القديم لكي يعرف OpenClaw أي حساب يجب أن يستقبل هذه الحالة القديمة المشتركة.
• إذا كانت الإضافة السابقة تخزن محليًا مفتاح فك تشفير النسخ الاحتياطي لمفاتيح غرف Matrix، فسيقوم بدء التشغيل أو openclaw doctor --fix باستيراده إلى تدفق مفتاح الاسترداد الجديد تلقائيًا.
• إذا تغير access token الخاص بـ Matrix بعد إعداد الترحيل، فإن بدء التشغيل يفحص الآن جذور تخزين تجزئة الرموز المجاورة بحثًا عن حالة استعادة قديمة معلقة قبل التخلي عن الاستعادة التلقائية للنسخ الاحتياطي.
• إذا تغير access token الخاص بـ Matrix لاحقًا للحساب نفسه والخادم المنزلي نفسه والمستخدم نفسه، فإن OpenClaw يفضل الآن إعادة استخدام جذر تخزين تجزئة الرمز الأكثر اكتمالًا بدلًا من البدء من دليل حالة Matrix فارغ.
• عند بدء تشغيل Gateway التالي، تتم استعادة مفاتيح الغرف المنسوخة احتياطيًا تلقائيًا إلى مخزن التشفير الجديد.
• إذا كانت الإضافة القديمة تحتوي على مفاتيح غرف محلية فقط ولم تُنسخ احتياطيًا مطلقًا، فسيحذر OpenClaw بوضوح. ولا يمكن تصدير هذه المفاتيح تلقائيًا من مخزن rust crypto السابق، لذلك قد يظل بعض السجل المشفر القديم غير متاح حتى تتم استعادته يدويًا.
• راجع ترحيل Matrix للتدفق الكامل للترقية، والقيود، وأوامر الاسترداد، ورسائل الترحيل الشائعة.

​

نموذج مخزن التشفير في Node

• استخدام fake-indexeddb كطبقة واجهة IndexedDB المتوقعة من SDK
• استعادة محتويات IndexedDB الخاصة بـ Rust crypto من crypto-idb-snapshot.json قبل initRustCrypto
• حفظ محتويات IndexedDB المحدثة مرة أخرى إلى crypto-idb-snapshot.json بعد التهيئة وأثناء وقت التشغيل
• تسلسل استعادة اللقطة وحفظها مقابل crypto-idb-snapshot.json باستخدام قفل ملف استشاري حتى لا يتسابق حفظ وقت تشغيل Gateway وصيانة CLI على ملف اللقطة نفسه

• إضافة دعم SecretRef لمواد مفاتيح Matrix الدائمة بحيث يمكن جلب مفاتيح الاسترداد والأسرار ذات الصلة بتشفير المخزن من موفري أسرار OpenClaw بدلًا من الملفات المحلية فقط

​

إدارة الملف الشخصي

openclaw matrix profile set --name "OpenClaw Assistant"
openclaw matrix profile set --avatar-url https://cdn.example.org/avatar.png

​

إشعارات التحقق التلقائية

• إشعارات طلب التحقق
• إشعارات جاهزية التحقق (مع إرشادات صريحة “تحقق عبر emoji”)
• إشعارات بدء التحقق واكتماله
• تفاصيل SAS (emoji والأرقام العشرية) عند توفرها

​

نظافة الأجهزة

openclaw matrix devices list

openclaw matrix devices prune-stale

​

إصلاح الغرفة المباشرة

openclaw matrix direct inspect --user-id @alice:example.org

openclaw matrix direct repair --user-id @alice:example.org

• يفضل رسالة مباشرة 1:1 صارمة تم ربطها بالفعل في m.direct
• وإلا يعود إلى أي رسالة مباشرة 1:1 صارمة منضم إليها حاليًا مع ذلك المستخدم
• وإذا لم توجد رسالة مباشرة سليمة، فإنه ينشئ غرفة مباشرة جديدة ويعيد كتابة m.direct للإشارة إليها

​

سلاسل الرسائل

• يبقي threadReplies: "off" الردود في المستوى الأعلى ويبقي الرسائل الواردة المترابطة على جلسة الأصل.
• يرد threadReplies: "inbound" داخل سلسلة فقط عندما تكون الرسالة الواردة بالفعل في تلك السلسلة.
• يبقي threadReplies: "always" ردود الغرفة داخل سلسلة متجذرة في الرسالة المشغلة ويوجه تلك المحادثة عبر الجلسة المطابقة ذات النطاق الخاص بالسلسلة من أول رسالة مشغلة.
• تتجاوز dm.threadReplies الإعداد الأعلى مستوى للرسائل المباشرة فقط. على سبيل المثال، يمكنك إبقاء سلاسل الغرف معزولة مع إبقاء الرسائل المباشرة مسطحة.
• تتضمن الرسائل الواردة ضمن السلاسل رسالة جذر السلسلة كسياق إضافي للوكيل.
• ترث رسائل أدوات الإرسال الآن سلسلة Matrix الحالية تلقائيًا عندما يكون الهدف هو الغرفة نفسها، أو هدف مستخدم الرسائل المباشرة نفسه، ما لم يتم توفير threadId صراحة.
• الروابط التشغيلية لسلاسل الرسائل مدعومة في Matrix. تعمل الآن /focus و/unfocus و/agents و/session idle و/session max-age و/acp spawn المرتبطة بالسلسلة في غرف Matrix والرسائل المباشرة.
• ينشئ /focus في غرفة/رسالة مباشرة Matrix من المستوى الأعلى سلسلة Matrix جديدة ويربطها بالجلسة الهدف عندما تكون threadBindings.spawnSubagentSessions=true.
• يؤدي تشغيل /focus أو /acp spawn --thread here داخل سلسلة Matrix موجودة إلى ربط تلك السلسلة الحالية بدلًا من ذلك.

​

روابط محادثات ACP

• شغّل /acp spawn codex --bind here داخل رسالة Matrix المباشرة، أو الغرفة، أو السلسلة الموجودة التي تريد الاستمرار في استخدامها.
• في رسالة Matrix مباشرة أو غرفة من المستوى الأعلى، تظل الرسالة المباشرة/الغرفة الحالية هي واجهة الدردشة وتوجَّه الرسائل المستقبلية إلى جلسة ACP التي تم إنشاؤها.
• داخل سلسلة Matrix موجودة، يربط --bind here تلك السلسلة الحالية في مكانها.
• يعيد /new و/reset تعيين جلسة ACP المرتبطة نفسها في مكانها.
• يغلق /acp close جلسة ACP ويزيل الربط.

• لا ينشئ --bind here سلسلة Matrix فرعية.
• لا تكون threadBindings.spawnAcpSessions مطلوبة إلا لـ /acp spawn --thread auto|here، حيث يحتاج OpenClaw إلى إنشاء سلسلة Matrix فرعية أو ربطها.

​

تهيئة ربط السلاسل

• threadBindings.enabled
• threadBindings.idleHours
• threadBindings.maxAgeHours
• threadBindings.spawnSubagentSessions
• threadBindings.spawnAcpSessions

• اضبط threadBindings.spawnSubagentSessions: true للسماح للأمر /focus في المستوى الأعلى بإنشاء سلاسل Matrix جديدة وربطها.
• اضبط threadBindings.spawnAcpSessions: true للسماح للأمر /acp spawn --thread auto|here بربط جلسات ACP بسلاسل Matrix.

​

التفاعلات

• تخضع أدوات التفاعل الصادر للبوابة channels["matrix"].actions.reactions.
• يضيف react تفاعلًا إلى حدث Matrix محدد.
• تسرد reactions ملخص التفاعلات الحالي لحدث Matrix محدد.
• تؤدي emoji="" إلى إزالة تفاعلات حساب البوت نفسه على ذلك الحدث.
• تؤدي remove: true إلى إزالة تفاعل emoji المحدد فقط من حساب البوت.

• channels["matrix"].accounts.<accountId>.ackReaction
• channels["matrix"].ackReaction
• messages.ackReaction
• الرجوع الاحتياطي إلى emoji الخاص بهوية الوكيل

• channels["matrix"].accounts.<accountId>.ackReactionScope
• channels["matrix"].ackReactionScope
• messages.ackReactionScope

• channels["matrix"].accounts.<accountId>.reactionNotifications
• channels["matrix"].reactionNotifications
• الافتراضي: own

• يؤدي reactionNotifications: "own" إلى تمرير أحداث m.reaction المضافة عندما تستهدف رسائل Matrix التي أنشأها البوت.
• يؤدي reactionNotifications: "off" إلى تعطيل أحداث نظام التفاعل.
• لا تزال إزالة التفاعلات غير تُركّب كأحداث نظام لأن Matrix تعرضها كتنقيحات، وليس كعمليات إزالة m.reaction مستقلة.

​

سياق السجل

• يتحكم channels.matrix.historyLimit في عدد رسائل الغرف الحديثة التي تُضمَّن كـ InboundHistory عندما تشغّل رسالة غرفة Matrix الوكيل.
• ويرجع احتياطيًا إلى messages.groupChat.historyLimit. اضبطه على 0 للتعطيل.
• يكون سجل غرف Matrix خاصًا بالغرفة فقط. وتستمر الرسائل المباشرة باستخدام سجل الجلسة العادي.
• سجل غرف Matrix يكون للمعلّق فقط: يخزّن OpenClaw رسائل الغرفة التي لم تشغّل ردًا بعد، ثم يلتقط هذه النافذة عندما تصل إشارة أو مشغّل آخر.
• لا تُضمَّن رسالة المشغّل الحالية في InboundHistory؛ بل تبقى في نص الإدخال الرئيسي لتلك الدورة.
• تعيد محاولات الحدث Matrix نفسه استخدام لقطة السجل الأصلية بدلًا من الانجراف إلى رسائل غرفة أحدث.

​

ظهور السياق

• contextVisibility: "all" هي القيمة الافتراضية. ويتم الاحتفاظ بالسياق الإضافي كما ورد.
• يقوم contextVisibility: "allowlist" بتصفية السياق الإضافي إلى المرسلين المسموح لهم بواسطة فحوصات قائمة سماح الغرفة/المستخدم النشطة.
• يتصرف contextVisibility: "allowlist_quote" مثل allowlist، لكنه يحتفظ مع ذلك برد مقتبس صريح واحد.

​

مثال على سياسة الرسائل المباشرة والغرف

{
  channels: {
    matrix: {
      dm: {
        policy: "allowlist",
        allowFrom: ["@admin:example.org"],
        threadReplies: "off",
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["@admin:example.org"],
      groups: {
        "!roomid:example.org": {
          requireMention: true,
        },
      },
    },
  },
}

openclaw pairing list matrix
openclaw pairing approve matrix <CODE>

​

موافقات exec

• channels.matrix.execApprovals.enabled
• channels.matrix.execApprovals.approvers (اختياري؛ يرجع احتياطيًا إلى channels.matrix.dm.allowFrom)
• channels.matrix.execApprovals.target (dm | channel | both، الافتراضي: dm)
• channels.matrix.execApprovals.agentFilter
• channels.matrix.execApprovals.sessionFilter

• تتحكم channels.matrix.execApprovals.* في التوجيه الأصلي للرسائل المباشرة/القنوات لموافقات exec فقط.
• لا تزال موافقات الإضافات تستخدم /approve المشترك في الدردشة نفسها بالإضافة إلى أي إعادة توجيه مهيأة في approvals.plugin.
• لا يزال بإمكان Matrix إعادة استخدام channels.matrix.dm.allowFrom لتفويض موافقات الإضافات عندما تتمكن من استنتاج الموافقين بأمان، لكنها لا تعرض مسار توزيع أصلي منفصل لموافقات الإضافات عبر الرسائل المباشرة/القنوات.

• يؤدي target: "dm" إلى إرسال مطالبات الموافقة إلى الرسائل المباشرة للموافقين
• يؤدي target: "channel" إلى إعادة إرسال المطالبة إلى غرفة أو رسالة Matrix المباشرة الأصلية
• يؤدي target: "both" إلى الإرسال إلى الرسائل المباشرة للموافقين وإلى غرفة أو رسالة Matrix المباشرة الأصلية

• channels.matrix.accounts.<account>.execApprovals

​

مثال على تعدد الحسابات

{
  channels: {
    matrix: {
      enabled: true,
      defaultAccount: "assistant",
      dm: { policy: "pairing" },
      accounts: {
        assistant: {
          homeserver: "https://matrix.example.org",
          accessToken: "syt_assistant_xxx",
          encryption: true,
        },
        alerts: {
          homeserver: "https://matrix.example.org",
          accessToken: "syt_alerts_xxx",
          dm: {
            policy: "allowlist",
            allowFrom: ["@ops:example.org"],
            threadReplies: "off",
          },
        },
      },
    },
  },
}

​

الخوادم المنزلية الخاصة/الشبكات المحلية

{
  channels: {
    matrix: {
      homeserver: "http://matrix-synapse:8008",
      allowPrivateNetwork: true,
      accessToken: "syt_internal_xxx",
    },
  },
}

openclaw matrix account add \
  --account ops \
  --homeserver http://matrix-synapse:8008 \
  --allow-private-network \
  --access-token syt_ops_xxx

​

تمرير حركة Matrix عبر وكيل

{
  channels: {
    matrix: {
      homeserver: "https://matrix.example.org",
      accessToken: "syt_bot_xxx",
      proxy: "http://127.0.0.1:7890",
    },
  },
}

​

حل الأهداف

• المستخدمون: @user:server أو user:@user:server أو matrix:user:@user:server
• الغرف: !room:server أو room:!room:server أو matrix:room:!room:server
• الأسماء المستعارة: #alias:server أو channel:#alias:server أو matrix:channel:#alias:server

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

​

مرجع التهيئة

• enabled: تمكين القناة أو تعطيلها.
• name: تسمية اختيارية للحساب.
• defaultAccount: معرّف الحساب المفضل عند تهيئة عدة حسابات Matrix.
• homeserver: عنوان URL للخادم المنزلي، مثل https://matrix.example.org.
• allowPrivateNetwork: السماح لهذا الحساب في Matrix بالاتصال بخوادم منزلية خاصة/داخلية. فعّل هذا عندما يُحل الخادم المنزلي إلى localhost أو عنوان IP ضمن LAN/Tailscale أو مضيف داخلي مثل matrix-synapse.
• proxy: عنوان URL اختياري لوكيل HTTP(S) لحركة Matrix. ويمكن للحسابات المسماة تجاوز الافتراضي في المستوى الأعلى عبر proxy خاص بها.
• userId: معرّف مستخدم Matrix كامل، مثل @bot:example.org.
• accessToken: access token للمصادقة القائمة على الرمز المميز. تُدعم القيم النصية الصريحة وقيم SecretRef لكل من channels.matrix.accessToken وchannels.matrix.accounts.<id>.accessToken عبر موفري env/file/exec. راجع Secrets Management.
• password: كلمة المرور لتسجيل الدخول القائم على كلمة المرور. تُدعم القيم النصية الصريحة وقيم SecretRef.
• deviceId: معرّف جهاز Matrix صريح.
• deviceName: اسم عرض الجهاز لتسجيل الدخول بكلمة المرور.
• avatarUrl: عنوان URL للصورة الرمزية الذاتية المخزن لمزامنة الملف الشخصي وتحديثات set-profile.
• initialSyncLimit: حد أحداث المزامنة عند بدء التشغيل.
• encryption: تمكين E2EE.
• allowlistOnly: فرض سلوك قائمة السماح فقط على الرسائل المباشرة والغرف.
• allowBots: السماح بالرسائل من حسابات Matrix OpenClaw أخرى مهيأة (true أو "mentions").
• groupPolicy: open أو allowlist أو disabled.
• contextVisibility: وضع ظهور السياق الإضافي للغرفة (all أو allowlist أو allowlist_quote).
• groupAllowFrom: قائمة سماح لمعرّفات المستخدمين لحركة الغرف.
• يجب أن تكون إدخالات groupAllowFrom معرّفات مستخدم Matrix كاملة. ويتم تجاهل الأسماء غير المحلولة في وقت التشغيل.
• historyLimit: الحد الأقصى لرسائل الغرف المضمّنة كسياق سجل للمجموعات. يرجع احتياطيًا إلى messages.groupChat.historyLimit. اضبط 0 للتعطيل.
• replyToMode: off أو first أو all.
• markdown: تهيئة Markdown اختيارية لتصيير نص Matrix الصادر.
• streaming: off (الافتراضي) أو partial أو true أو false. تؤدي partial وtrue إلى تمكين معاينات مسودة أحادية الرسالة مع تحديثات تعديل في المكان.
• blockStreaming: يؤدي true إلى تمكين رسائل تقدم منفصلة للكتل المكتملة للمساعد أثناء تفعيل بث معاينة المسودة.
• threadReplies: off أو inbound أو always.
• threadBindings: تجاوزات لكل قناة لتوجيه الجلسات المرتبطة بالسلاسل ودورة حياتها.
• startupVerification: وضع طلب التحقق الذاتي التلقائي عند بدء التشغيل (if-unverified أو off).
• startupVerificationCooldownHours: فترة التهدئة قبل إعادة محاولة طلبات التحقق التلقائية عند بدء التشغيل.
• textChunkLimit: حجم تجزئة الرسائل الصادرة.
• chunkMode: length أو newline.
• responsePrefix: بادئة رسائل اختيارية للردود الصادرة.
• ackReaction: تجاوز اختياري لتفاعل الإقرار لهذه القناة/الحساب.
• ackReactionScope: تجاوز اختياري لنطاق تفاعل الإقرار (group-mentions أو group-all أو direct أو all أو none أو off).
• reactionNotifications: وضع إشعارات التفاعل الواردة (own أو off).
• mediaMaxMb: الحد الأقصى لحجم الوسائط بالميغابايت لمعالجة وسائط Matrix. ويُطبّق على الإرسال الصادر ومعالجة الوسائط الواردة.
• autoJoin: سياسة الانضمام التلقائي للدعوات (always أو allowlist أو off). الافتراضي: off.
• autoJoinAllowlist: الغرف/الأسماء المستعارة المسموح بها عندما تكون autoJoin هي allowlist. تُحل إدخالات الأسماء المستعارة إلى معرّفات غرف أثناء معالجة الدعوات؛ ولا يثق OpenClaw في حالة الاسم المستعار التي تدعيها الغرفة المدعو إليها.
• dm: كتلة سياسة الرسائل المباشرة (enabled أو policy أو allowFrom أو threadReplies).
• يجب أن تكون إدخالات dm.allowFrom معرّفات مستخدم Matrix كاملة ما لم تكن قد قمت بحلها بالفعل عبر البحث الحي في الدليل.
• dm.threadReplies: تجاوز لسياسة السلاسل في الرسائل المباشرة فقط (off أو inbound أو always). ويتجاوز إعداد threadReplies الأعلى مستوى لكل من موضع الرد وعزل الجلسة في الرسائل المباشرة.
• execApprovals: تسليم موافقات exec الأصلية في Matrix (enabled أو approvers أو target أو agentFilter أو sessionFilter).
• execApprovals.approvers: معرّفات مستخدمي Matrix المسموح لهم بالموافقة على طلبات exec. وهو اختياري عندما تكون dm.allowFrom تحدد الموافقين بالفعل.
• execApprovals.target: dm | channel | both (الافتراضي: dm).
• accounts: تجاوزات مسماة لكل حساب. وتعمل القيم العليا في channels.matrix كقيم افتراضية لهذه الإدخالات.
• groups: خريطة سياسات لكل غرفة. فضّل معرّفات الغرف أو الأسماء المستعارة؛ ويتم تجاهل أسماء الغرف غير المحلولة في وقت التشغيل. تستخدم هوية الجلسة/المجموعة معرّف الغرفة الثابت بعد الحل، بينما تظل التسميات المقروءة للبشر مأخوذة من أسماء الغرف.
• groups.<room>.account: يقيّد إدخال غرفة موروثًا واحدًا إلى حساب Matrix محدد في الإعدادات متعددة الحسابات.
• groups.<room>.allowBots: تجاوز على مستوى الغرفة للمرسلين من البوتات المهيأة (true أو "mentions").
• groups.<room>.users: قائمة سماح للمرسلين لكل غرفة.
• groups.<room>.tools: تجاوزات السماح/المنع للأدوات لكل غرفة.
• groups.<room>.autoReply: تجاوز على مستوى الغرفة لبوابة الإشارات. تؤدي true إلى تعطيل متطلبات الإشارة لتلك الغرفة؛ وتفرض false إعادتها.
• groups.<room>.skills: مرشح Skills اختياري على مستوى الغرفة.
• groups.<room>.systemPrompt: مقتطف system prompt اختياري على مستوى الغرفة.
• rooms: اسم مستعار قديم لـ groups.
• actions: بوابات الأدوات لكل إجراء (messages أو reactions أو pins أو profile أو memberInfo أو channelInfo أو verification).

​

ذو صلة

• Channels Overview — جميع القنوات المدعومة
• Pairing — مصادقة الرسائل المباشرة وتدفق الاقتران
• Groups — سلوك الدردشة الجماعية وبوابة الإشارات
• Channel Routing — توجيه الجلسات للرسائل
• Security — نموذج الوصول والتقوية