ويتشات

يتصل 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، ورفع الوسائط وتنزيلها، ورموز السياق، ومراقبة الحسابات.

التثبيت

التثبيت السريع:

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-weixinopenclaw pairing approve openclaw-weixin <CODE>

للاطلاع على نموذج التحكم في الوصول كاملًا، راجع الاقتران.

التوافق

يتحقق Plugin من إصدار OpenClaw المضيف عند بدء التشغيل.

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

openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

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

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

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

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

تحقق من التثبيت والحالة:

openclaw plugins listopenclaw channels status --probeopenclaw --version

إذا ظهرت القناة على أنها مثبّتة لكنها لا تتصل، فتأكد من أن Plugin مفعّل ثم أعد التشغيل:

openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw gateway restart

إذا تكررت إعادة تشغيل Gateway بعد تمكين WeChat، فحدّث كلًا من OpenClaw وPlugin:

npm view @tencent-weixin/openclaw-weixin versionopenclaw plugins install "@tencent-weixin/openclaw-weixin" --forceopenclaw gateway restart

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

التعطيل المؤقت:

openclaw config set plugins.entries.openclaw-weixin.enabled falseopenclaw gateway restart

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

• نظرة عامة على القنوات: قنوات المحادثة
• الاقتران: الاقتران
• توجيه القنوات: توجيه القنوات
• بنية Plugins: بنية Plugins
• حزمة تطوير Plugin القناة: حزمة تطوير Plugin القناة
• الحزمة الخارجية: @tencent-weixin/openclaw-weixin