Skip to main content
يتصل OpenClaw بـ WeChat من خلال Plugin القناة الخارجي من Tencent: @tencent-weixin/openclaw-weixin. الحالة: Plugin خارجي، يتولى فريق Tencent Weixin صيانته. تُدعم المحادثات المباشرة والوسائط. لا تعلن البيانات الوصفية لإمكانات Plugin عن دعم المحادثات الجماعية (إذ تعلن عن المحادثات المباشرة فقط).

​
التسمية

  • WeChat هو الاسم الظاهر للمستخدم في هذه الوثائق.
  • Weixin هو الاسم الذي تستخدمه حزمة Tencent ومعرّف Plugin.
  • openclaw-weixin هو معرّف قناة OpenClaw (ويعمل weixin وwechat كاسمين مستعارين).
  • @tencent-weixin/openclaw-weixin هي حزمة npm.
استخدم openclaw-weixin في أوامر CLI ومسارات الإعدادات.

​
آلية العمل

لا توجد شيفرة WeChat في مستودع OpenClaw الأساسي. يوفّر OpenClaw عقد Plugin العام للقنوات، بينما يوفّر Plugin الخارجي بيئة التشغيل الخاصة بـ WeChat:
  1. يثبّت openclaw plugins install الحزمة @tencent-weixin/openclaw-weixin.
  2. يكتشف Gateway بيان Plugin ويحمّل نقطة دخوله.
  3. يسجّل Plugin معرّف القناة openclaw-weixin.
  4. يبدأ openclaw channels login --channel openclaw-weixin تسجيل الدخول عبر رمز QR.
  5. يخزّن Plugin بيانات اعتماد الحساب ضمن دليل حالة OpenClaw (~/.openclaw افتراضيًا).
  6. عند بدء Gateway، يشغّل Plugin مراقب Weixin لكل حساب مُعدّ.
  7. تُوحّد رسائل WeChat الواردة عبر عقد القناة، وتُوجّه إلى وكيل OpenClaw المحدد، ثم تُرسل الردود عبر مسار الإرسال الصادر في Plugin.
هذا الفصل مهم: تظل نواة OpenClaw مستقلة عن القنوات. ويتولى Plugin الخارجي تسجيل الدخول إلى WeChat، واستدعاءات واجهة Tencent iLink API، ورفع الوسائط وتنزيلها، ورموز السياق، ومراقبة الحسابات.

​
التثبيت

التثبيت السريع:
التثبيت اليدوي:
أعد تشغيل Gateway بعد التثبيت:

​
تسجيل الدخول

شغّل تسجيل الدخول عبر رمز QR على الجهاز نفسه الذي يشغّل Gateway:
امسح رمز QR باستخدام WeChat على هاتفك وأكّد تسجيل الدخول. يحفظ Plugin رمز الحساب محليًا بعد نجاح المسح. لإضافة حساب WeChat آخر، شغّل أمر تسجيل الدخول نفسه مجددًا. عند استخدام عدة حسابات، اعزل جلسات الرسائل المباشرة حسب الحساب والقناة والمرسل:

​
التحكم في الوصول

تستخدم الرسائل المباشرة نموذج الاقتران وقائمة السماح المعتادين في OpenClaw لـ Plugins القنوات. وافق على المرسلين الجدد:
للاطلاع على نموذج التحكم في الوصول كاملًا، راجع الاقتران.

​
التوافق

يتحقق Plugin من إصدار OpenClaw المضيف عند بدء التشغيل. إذا أبلغ Plugin بأن إصدار OpenClaw لديك قديم جدًا، فإما أن تحدّث OpenClaw أو تثبّت السلسلة القديمة من Plugin:

​
العملية المرافقة

يمكن لـ Plugin WeChat تشغيل مهام مساعدة بجانب Gateway أثناء مراقبة واجهة Tencent iLink API. في المشكلة #68451، كشف مسار المهام المساعدة هذا خللًا في التنظيف العام للنسخ القديمة من Gateway في OpenClaw: كان بإمكان عملية فرعية محاولة تنظيف عملية Gateway الأصلية، مما تسبب في حلقات إعادة تشغيل عند استخدام مديري العمليات مثل systemd. يستثني تنظيف بدء التشغيل الحالي في OpenClaw العملية الحالية وأسلافها، لذلك لا يمكن لمساعد القناة إنهاء Gateway الذي شغّله. هذا الإصلاح عام؛ وليس مسارًا خاصًا بـ WeChat في النواة.

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

تحقق من التثبيت والحالة:
إذا ظهرت القناة على أنها مثبّتة لكنها لا تتصل، فتأكد من أن Plugin مفعّل ثم أعد التشغيل:
إذا تكررت إعادة تشغيل Gateway بعد تمكين WeChat، فحدّث كلًا من OpenClaw وPlugin:
إذا أبلغ بدء التشغيل بأن حزمة Plugin المثبّتة requires compiled runtime output for TypeScript entry، فهذا يعني أن حزمة npm نُشرت دون ملفات بيئة تشغيل JavaScript المترجمة التي يحتاجها OpenClaw. حدّث Plugin أو أعد تثبيته بعد أن ينشر ناشره حزمة مصححة، أو عطّل Plugin أو ألغِ تثبيته مؤقتًا. التعطيل المؤقت:

​
الوثائق ذات الصلة