WeChat

يتصل OmeniaClaw بـ WeChat عبر Plugin القناة الخارجي من Tencent @tencent-weixin/OmeniaClaw-weixin.

الحالة: Plugin خارجي. المحادثات المباشرة والوسائط مدعومة. محادثات المجموعات غير معلنة في بيانات تعريف الإمكانات الخاصة بالـ Plugin الحالي.

التسمية

• WeChat هو الاسم الظاهر للمستخدم في هذه الوثائق.
• Weixin هو الاسم المستخدم في حزمة Tencent وفي معرّف الـ Plugin.
• OmeniaClaw-weixin هو معرّف قناة OmeniaClaw.
• @tencent-weixin/OmeniaClaw-weixin هي حزمة npm.

استخدم OmeniaClaw-weixin في أوامر CLI ومسارات الإعداد.

كيف يعمل

لا تعيش شيفرة WeChat في مستودع نواة OmeniaClaw. يوفر OmeniaClaw عقد Plugin القناة العام، ويوفر الـ Plugin الخارجي وقت التشغيل المخصص لـ WeChat:

1. يثبّت OmeniaClaw plugins install الحزمة @tencent-weixin/OmeniaClaw-weixin.
2. يكتشف Gateway بيان الـ Plugin ويحمل نقطة دخول الـ Plugin.
3. يسجل الـ Plugin معرّف القناة OmeniaClaw-weixin.
4. يبدأ OmeniaClaw channels login --channel OmeniaClaw-weixin تسجيل الدخول عبر رمز QR.
5. يخزن الـ Plugin بيانات اعتماد الحساب ضمن دليل حالة OmeniaClaw.
6. عند بدء Gateway، يبدأ الـ Plugin مراقب Weixin لكل حساب مكوّن.
7. تُطبّع رسائل WeChat الواردة عبر عقد القناة، وتُوجّه إلى وكيل OmeniaClaw المحدد، ثم تُرسل مرة أخرى عبر مسار الخروج في الـ Plugin.

هذا الفصل مهم: يجب أن تبقى نواة OmeniaClaw حيادية تجاه القنوات. تسجيل دخول WeChat، واستدعاءات Tencent iLink API، ورفع/تنزيل الوسائط، ورموز السياق، ومراقبة الحسابات كلها مملوكة للـ Plugin الخارجي.

التثبيت

تثبيت سريع:

npx -y @tencent-weixin/OmeniaClaw-weixin-cli install

تثبيت يدوي:

OmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin"OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled true

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

OmeniaClaw gateway restart

تسجيل الدخول

شغّل تسجيل الدخول عبر QR على الجهاز نفسه الذي يشغّل Gateway:

OmeniaClaw channels login --channel OmeniaClaw-weixin

امسح رمز QR باستخدام WeChat على هاتفك وأكّد تسجيل الدخول. يحفظ الـ Plugin رمز الحساب محليًا بعد نجاح المسح.

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

OmeniaClaw config set session.dmScope per-account-channel-peer

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

تستخدم الرسائل المباشرة نموذج الاقتران وقائمة السماح العادي في OmeniaClaw للـ Plugins الخاصة بالقنوات.

وافِق على المرسلين الجدد:

OmeniaClaw pairing list OmeniaClaw-weixinOmeniaClaw pairing approve OmeniaClaw-weixin <CODE>

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

التوافق

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

إذا أبلغ الـ Plugin أن إصدار OmeniaClaw لديك قديم جدًا، فإما أن تحدّث OmeniaClaw أو تثبّت خط الـ Plugin القديم:

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

عملية جانبية

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

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

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

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

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

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

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled trueOmeniaClaw gateway restart

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

npm view @tencent-weixin/OmeniaClaw-weixin versionOmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin" --forceOmeniaClaw gateway restart

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

تعطيل مؤقت:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled falseOmeniaClaw gateway restart

وثائق ذات صلة

• نظرة عامة على القنوات: قنوات الدردشة
• الاقتران: الاقتران
• توجيه القنوات: توجيه القنوات
• معمارية الـ Plugin: معمارية الـ Plugin
• SDK Plugin القناة: SDK Plugin القناة
• الحزمة الخارجية: @tencent-weixin/OmeniaClaw-weixin