الانتقال إلى المحتوى الرئيسي

​
WeChat

يتصل OpenClaw بـ WeChat من خلال Plugin القناة الخارجي @tencent-weixin/openclaw-weixin التابع لـ Tencent. الحالة: Plugin خارجي. المحادثات المباشرة والوسائط مدعومة. الدردشات الجماعية غير معلن عنها في بيانات قدرات Plugin الحالية.

​
التسمية

  • WeChat هو الاسم الظاهر للمستخدم في هذه الوثائق.
  • Weixin هو الاسم المستخدم من قِبل حزمة Tencent ومعرّف Plugin.
  • openclaw-weixin هو معرّف قناة OpenClaw.
  • @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 ويحمّل نقطة إدخال Plugin.
  3. يسجّل Plugin معرّف القناة openclaw-weixin.
  4. يبدأ openclaw channels login --channel openclaw-weixin تسجيل الدخول عبر QR.
  5. يخزّن Plugin بيانات اعتماد الحساب ضمن دليل حالة OpenClaw.
  6. عند بدء تشغيل Gateway، يبدأ Plugin مراقبة Weixin لكل حساب تم تكوينه.
  7. تتم تسوية رسائل WeChat الواردة عبر عقد القناة، وتوجيهها إلى وكيل OpenClaw المحدد، ثم إرسالها مرة أخرى عبر مسار الإرسال الصادر الخاص بـ Plugin.
هذا الفصل مهم: يجب أن يظل OpenClaw الأساسي غير مرتبط بأي قناة بعينها. تسجيل دخول WeChat، واستدعاءات Tencent iLink API، ورفع/تنزيل الوسائط، ورموز السياق، ومراقبة الحسابات كلها مملوكة لـ Plugin الخارجي.

​
التثبيت

التثبيت السريع: 
npx -y @tencent-weixin/openclaw-weixin-cli install
التثبيت اليدوي: 
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
أعد تشغيل Gateway بعد التثبيت: 
openclaw gateway restart

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

شغّل تسجيل الدخول عبر QR على نفس الجهاز الذي يشغّل Gateway: 
openclaw channels login --channel openclaw-weixin
امسح رمز QR باستخدام WeChat على هاتفك وأكّد تسجيل الدخول. يحفظ Plugin رمز الحساب محليًا بعد نجاح المسح. لإضافة حساب WeChat آخر، شغّل أمر تسجيل الدخول نفسه مرة أخرى. بالنسبة إلى الحسابات المتعددة، اعزل جلسات الرسائل المباشرة حسب الحساب والقناة والمرسل: 
openclaw config set session.dmScope per-account-channel-peer

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

تستخدم الرسائل المباشرة نموذج الاقتران وقائمة السماح المعتادَين في OpenClaw لـ Plugins القنوات. اعتمد المرسلين الجدد: 
openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>
للاطلاع على نموذج التحكم الكامل في الوصول، راجع الاقتران.

​
التوافق

يفحص Plugin إصدار OpenClaw على المضيف عند بدء التشغيل.
سطر Pluginإصدار OpenClawوسم npm
2.x>=2026.3.22latest
1.x>=2026.1.0 <2026.3.22legacy
إذا أبلغ Plugin أن إصدار OpenClaw لديك قديم جدًا، فإمّا أن تحدّث OpenClaw أو تثبّت سطر Plugin القديم: 
openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

​
عملية Sidecar

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

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

تحقق من التثبيت والحالة: 
openclaw plugins list
openclaw channels status --probe
openclaw --version
إذا ظهرت القناة على أنها مثبّتة لكنها لا تتصل، فتأكد من أن Plugin مفعّل ثم أعد التشغيل: 
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart
إذا كان Gateway يعيد التشغيل بشكل متكرر بعد تفعيل WeChat، فحدّث كلًا من OpenClaw و Plugin: 
npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart
تعطيل مؤقت: 
openclaw config set plugins.entries.openclaw-weixin.enabled false
openclaw gateway restart

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