إعدادات Microsoft Teams في OpenClaw
متغيرات بيئة المصادقة، وحدود السجل وسياق سلاسل المحادثات، وأوضاع ظهور السياق، والسحابة وعنوان URL للخدمة في السحابات الحكومية والصينية، وwebhook، وسياسات الرسائل المباشرة ومعرّفات الكائنات الثابتة، وحدود التقسيم والوسائط، والتجاوزات لكل فريق ولكل قناة، وبطاقات الترحيب، والتقييمات، وSSO
قناة Teams من أطول قنوات OpenClaw قائمةً بالمفاتيح، لأن عليها أن تغطي في كتلة واحدة السحابات الحكومية، والسجل المعتمد على Graph، والتجاوزات لكل فريق، وتدفقات الترحيب ببطاقات Adaptive Card. وإليك القائمة كما تجمعها الوثائق: متغيرات البيئة، وسياق السجل، ثم مفاتيح الإعدادات نفسها.
متغيرات البيئة والسجل
- لا يمكن أن تأتي من البيئة إلا المفاتيح المتعلقة بالمصادقة: معرّف التطبيق، وكلمة مرور التطبيق، ومعرّف المستأجر (tenant)، ونوع المصادقة بقيمة secret أو federated، ومسار الشهادة وبصمتها لطريقة الشهادة، وعلامة الهوية المدارة ومعرّف العميل لطريقة الهوية؛ أما المفاتيح الأخرى مثل سياسة المجموعات أو حد السجل فلا تضبط إلا في الإعدادات.
- يتحكم حد السجل في عدد رسائل القناة أو المجموعة الأخيرة التي تدرج في الموجّه، ويعود عند غيابه إلى حد سجل الدردشات الجماعية العام ثم إلى 50، وضبطه على صفر يعطّله.
- يضيف سياق سلسلة المحادثة عبر Graph الرسالة الأصلية وما يصل إلى أقدم 50 ردًا إلى جانب سجل القناة الأخير، ويستبعد الرسالة التي أطلقت الرد، ويبقي السجل منفصلًا عن نص أمر المرسل كي لا تنفَّذ الأوامر المقتبسة في السجل، ويقتطع الرسائل الطويلة المجلوبة إلى بدايتها ونهايتها ضمن الحد المخصص لكل رسالة.
- يتبع سياق سلاسل المحادثات والمرفقات المقتبسة مفتاح ظهور السياق، ويعود عند غيابه إلى القيم الافتراضية للقناة ثم إلى all، إذ يرشّح allowlist كليهما وفق قوائم السماح للمرسلين، بينما يرشّح allowlist-quote سجل سلسلة المحادثة ويسمح بالسياق المقتبس؛ ويحدَّد سجل الرسائل المباشرة بعدد أدوار المستخدم مع إمكانية تجاوزه لكل مستخدم.
معرّفات كائنات AAD الثابتة تمنح أيضًا صلاحية إجراءات الموافقة.
السحابات، وwebhook، والوصول، والحدود
علامة التفعيل، ومعرّف التطبيق، وكلمة مرور التطبيق، ومعرّف المستأجر هي الأساسيات. يختار مفتاح السحابة بيئة Teams SDK: العامة افتراضيًا، أو حكومة الولايات المتحدة، أو DoD، أو الصين، ويضبط مع عنوان URL للخدمة في السحابات الحكومية؛ وتستخدم الصين الإعداد المسبق في SDK ومراجع المحادثات المخزنة في Azure China، مع تعطيل الأدوات المساعدة المعتمدة على Graph إلى أن يصدر توجيه Graph في Azure China، أما عنوان URL للخدمة فهو حد Bot Connector للعمليات الاستباقية، وله قيمة افتراضية في السحابة العامة ويضبط صراحة في GCC أو GCC High أو DoD. منفذ webhook الافتراضي هو 3978، ومساره الافتراضي هو مسار الرسائل. وتقبل سياسة الرسائل المباشرة القيم pairing أو allowlist أو open أو disabled، والقيمة الافتراضية pairing، وتفضّل قائمة السماح للرسائل المباشرة معرّفات كائنات AAD، التي تمنح أيضًا صلاحية إجراءات الموافقة، ويحوّل معالج الإعداد الأسماء إلى معرّفات حين يتوفر الوصول إلى Graph، وتحدد الوجهة الافتراضية مقصد الرسائل الصادرة ويمكنها بالمثل منح صلاحية الموافقات، أما مفتاح مطابقة الأسماء الخطر فهو مفتاح الطوارئ الذي يعيد تفعيل المطابقة بقيم UPN أو أسماء العرض القابلة للتغيير، والتوجيه المباشر بأسماء الفرق أو القنوات. وحد تقسيم النص افتراضيًا 4000، وهو سقف صارم لا يتجاوزه النص مهما ضبطت، ووضع التقسيم newline يقسم عند الأسطر الفارغة قبل اعتبار الطول، وقائمة السماح لمضيفي الوسائط تضم افتراضيًا نطاقات Microsoft وTeams، وقائمة السماح لمصادقة الوسائط تحدد أين يجوز إرفاق ترويسات Authorization عند إعادة المحاولة، والرجوع إلى Graph للوسائط يفعّل عمليات البحث في Graph حين يغفل HTML علامات الملفات، وسقف حجم الوسائط يعود إلى القيمة الافتراضية للوكيل.
التجاوزات، والبطاقات، والتقييمات، وSSO
- اشتراط الإشارة قيمته الافتراضية true، ونمط الرد يختار thread أو top-level، ويمكن تجاوز كليهما لكل فريق ولكل قناة ضمن خريطة teams المفهرسة بمعرّف الفريق ومعرّف المحادثة، إلى جانب سياسات أدوات لكل فريق ولكل قناة بقيم allow وdeny وalso-allow، وسياسات أدوات لكل مرسل مفهرسة ببادئات صريحة هي channel وid وe164 وusername وname، وبحرف البدل.
- نوع المصادقة، ومسار الشهادة وبصمتها، وعلامة الهوية المدارة، ومعرّف العميل تطابق ما في صفحة المصادقة، ويحدد معرّف موقع SharePoint الموقع المستخدم لرفع الملفات في الدردشات الجماعية والقنوات.
- تعرض بطاقة الترحيب وبطاقة الترحيب الجماعية، مع مقترحات البدء، بطاقة Adaptive Card عند أول تواصل في رسالة مباشرة أو في مجموعة، وتضيف بادئة الرد نصًا قبل الردود الصادرة، والتقييم بالإعجاب وعدم الإعجاب مفعّل افتراضيًا مع متابعة للمراجعة بعد التقييم السلبي وفترة تهدئة لها، وتهيئ كتلتا SSO والمصادقة المفوضة اتصال OAuth في Bot Framework ونطاقات Graph المفوضة، علمًا بأن تفعيل SSO يتطلب اسم اتصال.
تنتمي هذه المفاتيح إلى مقال القناة OpenClaw على Microsoft Teams، وللطرق الموحدة (federated) التي تقف خلف مفاتيح المصادقة راجع مصادقة Microsoft Teams في OpenClaw.
المعرّفات لا الأسماء
تشترك ثلاثة مفاتيح في القائمة في مبدأ واحد: معرّفات الكائنات ثابتة والأسماء ليست كذلك، لذا ينبغي أن تحمل قوائم السماح والموافقات والوجهات المعرّف، ولا يوجد مفتاح مطابقة الأسماء إلا لإبقاء تثبيت قديم عاملًا ريثما يتم نقله. وللأذونات التي تحتاجها الأدوات المساعدة المعتمدة على Graph راجع بيان Microsoft Teams وأذوناته في OpenClaw، وللقواعد المشتركة بين القنوات للمحادثات الجماعية التي تدقق فيها هذه التجاوزات راجع الدردشات الجماعية في OpenClaw.
على Diali
Microsoft Teams ليست من القنوات التي تربطها Diali اليوم، وهي: WhatsApp وTelegram وDiscord وSlack وMattermost وMatrix وSMS والصوت. المساعد هو OpenClaw المستضاف على Diali، ويعرض دليل ربط قناتك الأولى في خمس دقائق القنوات التي يمكنك ربطها بهذه السرعة.
- مفاتيح المصادقة وحدها تأتي من البيئة؛ والباقي في الإعدادات.
- سياق سلسلة المحادثة يجلب الرسالة الأصلية وخمسين ردًا، ولا ينفّذ أوامرها أبدًا.
- 4000 حرف لكل جزء، بسقف صارم.
كفاك قراءة، ابنِ وكيلك الخاص
جهز وكيلًا، واختر قناة، واجعله يعمل داخل التطبيق المفتوح لديك دائمًا.
