كيفية استخدام OpenClaw مع WeChat مجانًا؟

ملخص: يمكنك ربط OpenClaw بـ WeChat في أقل من 5 دقائق عبر تثبيت المكون الإضافي @tencent-weixin/openclaw-weixin، وتفويض حسابك عبر رمز QR، ثم إعادة تشغيل بوابة OpenClaw. المكون الإضافي مجاني، مفتوح المصدر، ويدعم حسابات WeChat متعددة في نفس الوقت.

جرّب Apidog اليوم

مقدمة

تشغيل مساعد ذكاء اصطناعي على WeChat غالبًا ما يتطلب اشتراكات مدفوعة في API أو إعدادات خادم معقدة أو حسابات مؤسسية. مع OpenClaw يمكنك تجاوز هذه التعقيدات.

المكون الإضافي @tencent-weixin/openclaw-weixin يسمح بربط حسابك الشخصي على WeChat ببوابة OpenClaw الذكية خلال دقائق، بدون رسوم شهرية أو متطلبات حساب مؤسسي. فقط امسح رمز QR وابدأ مباشرة.

في هذا الدليل ستتعلم خطوة بخطوة كيفية تثبيت المكون الإضافي، تفويض حسابات متعددة، عزل سياقات المحادثة، وضبط الإعدادات، لتشغيل مساعد ذكاء اصطناعي متكامل على WeChat.

💡إذا كان روبوت WeChat الخاص بك يحتاج إلى استدعاء واجهات برمجة تطبيقات خارجية (الطقس، المدفوعات، CRM)، ستحتاج إلى أداة اختبار API. استخدم Apidog Free لتصميم واختبار وتوثيق واجهات برمجة التطبيقات الخاصة بك قبل ربطها بالروبوت.

المتطلبات الأساسية

تأكد من توفر التالي قبل البدء:

• OpenClaw (الإصدار >=2026.3.22 مطلوب للمكون الإضافي v2.0.x)
• CLI الخاص بـ openclaw مثبت على جهازك
• حساب WeChat شخصي (لا يحتاج لحساب رسمي أو مؤسسي)
• Node.js (مطلوب لمثبت التثبيت السريع)

للتحقق من نسخة OpenClaw لديك:

openclaw --version

إذا كان الإصدار أقدم، حدّث OpenClaw قبل المتابعة.

توافق المكون الإضافي

إصدار المكون الإضافي	إصدار OpenClaw	الحالة
2.0.x	>=2026.3.22	نشط
1.0.x	>=2026.1.0 <2026.3.22	صيانة

يتحقق المكون الإضافي من التوافق عند التشغيل. إذا كان إصدار OpenClaw غير متوافق، لن يتم تحميل المكون.

الخطوة 1: تثبيت المكون الإضافي

الخيار أ: التثبيت السريع (موصى به)

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

هذا الأمر يقوم بتثبيت وضبط كل شيء تلقائياً.

الخيار ب: التثبيت اليدوي

للتثبيت بشكل يدوي إذا تعذر التثبيت السريع:

1. تثبيت المكون الإضافي:

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

2. تفعيل المكون الإضافي:

   openclaw config set plugins.entries.openclaw-weixin.enabled true
   

الخطوة 2: مسح رمز QR لتفويض WeChat

بعد تثبيت المكون الإضافي، سجل الدخول إلى حساب WeChat الخاص بك:

openclaw channels login --channel openclaw-weixin

سيظهر رمز QR. افتح WeChat على هاتفك وامسح الرمز. أكد التفويض.

يتم حفظ بيانات الدخول محليًا. فقط كرر المسح إذا قمت بتسجيل الخروج يدوياً.

الخطوة 3: إعادة تشغيل البوابة

بعد التفويض، فعّل المكون الإضافي بإعادة تشغيل البوابة:

openclaw gateway restart

الآن أصبح WeChat متصلًا بـ OpenClaw. جميع رسائل WeChat تُعالَج بواسطة وكيل الذكاء الاصطناعي.

الخطوة 4: إضافة حسابات WeChat متعددة (اختياري)

لإضافة حسابات إضافية، أعد تنفيذ أمر تسجيل الدخول لكل حساب:

openclaw channels login --channel openclaw-weixin

كل حساب يعمل بشكل مستقل ولا يوجد تداخل بين الحسابات.

الخطوة 5: عزل سياقات المحادثة (اختياري)

افتراضيًا، كل القنوات تشارك نفس سياق الذكاء الاصطناعي. لعزل سياق كل حساب:

openclaw config set agents.mode per-channel-per-peer

بهذا ستحصل كل جهة اتصال على ذاكرة مستقلة.

كيف يعمل المكون الإضافي تحت الغطاء

للتخصيص أو التوسعة البرمجية، هذه نظرة على بروتوكول API للمكون:

رؤوس المصادقة

كل طلبات API تستخدم الرؤوس التالية:

الرأس	القيمة
Content-Type	application/json
AuthorizationType	ilink_bot_token
Authorization	Bearer <token>
X-WECHAT-UIN	uint32 عشوائية مشفرة base64

نقاط نهاية API الأساسية

المكون يستخدم 5 نقاط نهاية JSON HTTP:

نقطة النهاية	المسار	الغرض
getUpdates	getupdates	استطلاع رسائل جديدة
sendMessage	sendmessage	إرسال نص/صورة/فيديو/ملف
getUploadUrl	getuploadurl	عنوان CDN لتحميل الوسائط
getConfig	getconfig	تكوين الحساب
sendTyping	sendtyping	إظهار/إخفاء مؤشر الكتابة

استقبال الرسائل (الاستطلاع الطويل)

مثال طلب واستجابة:

// طلب
{
  "get_updates_buf": ""
}

// استجابة
{
  "ret": 0,
  "msgs": [...],
  "get_updates_buf": "<new_cursor>",
  "longpolling_timeout_ms": 35000
}

كرر تمرير get_updates_buf للاستمرار في جلب الرسائل الجديدة فقط.

إرسال الرسائل

{
  "msg": {
    "to_user_id": "<target_user_id>",
    "context_token": "<session_context_token>",
    "item_list": [
      {
        "type": 1,
        "text_item": { "text": "Hello!" }
      }
    ]
  }
}

أنواع الرسائل

النوع	القيمة
TEXT	1
IMAGE	2
VOICE	3
FILE	4
VIDEO	5

تحميل الوسائط (صور، ملفات، فيديو)

خطوات تحميل ملف وسائط:

1. طلب getUploadUrl مع معلومات الملف (حجم، MD5)
2. استلام رابط CDN موقّع
3. تشفير الملف بـ AES-128-ECB
4. رفع الملف للرابط الموقع
5. إرسال الملف عبر sendMessage

المشكلات الشائعة والإصلاحات

المكون الإضافي يرفض التحميل

الحل: تحقق من إصدار OpenClaw، المكون v2.0.x يتطلب >=2026.3.22:

openclaw --version
# إذا كان الإصدار قديم، حدّث OpenClaw

انتهاء صلاحية رمز QR

الحل: أعد تشغيل أمر تسجيل الدخول. رمز QR صالح لمدة ~30 ثانية.

openclaw channels login --channel openclaw-weixin

الرسائل لم تُستلم

الحل: أعد تشغيل البوابة بعد تسجيل الدخول.

openclaw gateway restart

حسابات متعددة تخلط السياقات

الحل: فعّل عزل السياق:

openclaw config set agents.mode per-channel-per-peer

حالات الاستخدام في العالم الفعلي

مساعد ذكاء اصطناعي شخصي

اربط WeChat الشخصي بـ OpenClaw لجعل الذكاء الاصطناعي يرد نيابة عنك، مع عزل سياق لكل جهة اتصال.

دعم عملاء الشركات الصغيرة

شغّل عدة حسابات WeChat لأقسام مختلفة، كل منها بذاكرة مستقلة لعملائها.

اختبار المطورين

أنشئ تكاملات مخصصة عبر HTTP JSON API. البروتوكول موثق بالكامل وقابل للتوسع.

الخلاصة

إعداد OpenClaw مع WeChat لا يستغرق سوى دقائق: ثبّت المكون الإضافي، امسح رمز QR، أعد تشغيل البوابة. يدعم حسابات متعددة، عزل سياق، ووسائط متعددة.

للتكاملات البرمجية، البروتوكول وثائقي وواضح. ابدأ بـ:

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

نصيحة إضافية: بعد تفعيل روبوت WeChat، اختبر أي API خارجي (دفع، CRM، الطقس) باستخدام Apidog حتى تتأكد من صحة الطلبات والاستجابات. تتوفر طبقة مجانية ولا تحتاج بطاقة ائتمان.

الأسئلة الشائعة

س: هل يعمل مع حسابات WeChat الشخصية؟

ج: نعم. المكون الإضافي يدعم الحسابات الشخصية بدون الحاجة لحساب رسمي.

س: هل المكون الإضافي مجاني؟

ج: نعم، @tencent-weixin/openclaw-weixin مجاني ومفتوح المصدر. فقط OpenClaw مطلوب.

س: هل يمكنني تشغيل عدة حسابات WeChat؟

ج: نعم. نفذ openclaw channels login --channel openclaw-weixin لكل حساب.

س: ماذا لو أعدت تشغيل الجهاز؟

ج: بيانات الدخول محفوظة محليًا. فقط أعد تشغيل البوابة بـ openclaw gateway restart.

س: هل يمكنني بناء تكاملات مخصصة؟

ج: نعم. المكون يوفر API HTTP JSON موثق (getUpdates، sendMessage، getUploadUrl، getConfig، sendTyping). لاختبار تكاملاتك مع API، استخدم Apidog قبل تطبيقها فعليًا.