ملخص: يمكنك ربط OpenClaw بـ WeChat عن طريق تثبيت المكون الإضافي @tencent-weixin/openclaw-weixin، ومسح رمز الاستجابة السريعة (QR) لتفويض حسابك، ثم إعادة تشغيل البوابة. يستغرق الإعداد بالكامل أقل من 5 دقائق. المكون الإضافي مجاني ومفتوح المصدر ويدعم حسابات WeChat متعددة في وقت واحد.
مقدمة
قد يبدو تشغيل مساعد ذكاء اصطناعي على WeChat معقدًا. تتطلب معظم الحلول اشتراكات باهظة في واجهة برمجة التطبيقات (API)، أو إعدادات خادم معقدة، أو حسابات مؤسسية. OpenClaw يغير ذلك.
يقوم المكون الإضافي @tencent-weixin/openclaw-weixin بربط حسابك الشخصي على WeChat ببوابة الذكاء الاصطناعي لـ OpenClaw في دقائق. لا حاجة لحساب مؤسسي. لا توجد رسوم شهرية. فقط امسح رمز QR ضوئيًا وستكون جاهزًا.
يرشدك هذا الدليل خلال الإعداد الكامل — من تثبيت المكون الإضافي إلى التعامل مع حسابات متعددة وعزل سياقات المحادثة. بحلول النهاية، سيحتوي WeChat الخاص بك على مساعد ذكاء اصطناعي يعمل بكامل طاقته على OpenClaw.
المتطلبات الأساسية
قبل البدء، تحتاج إلى:
- تثبيت OpenClaw (الإصدار
>=2026.3.22للمكون الإضافي v2.0.x) - توفر
openclawCLI في محطتك الطرفية - حساب WeChat (يعمل الحساب الشخصي — لا يتطلب حساب مؤسسي)
- تثبيت Node.js (لمثبت التثبيت بنقرة واحدة)
تحقق من إصدار OpenClaw الخاص بك:
openclaw --version
إذا كنت تستخدم إصدارًا أقدم، فقم بالتحديث أولاً. يتطلب المكون الإضافي v2.0.x الإصدار >=2026.3.22 من 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 لتفعيل المكون الإضافي:
openclaw gateway restart
هذا كل شيء. حسابك على WeChat متصل الآن بـ OpenClaw. سيتم معالجة الرسائل المرسلة إلى WeChat الخاص بك بواسطة وكيل الذكاء الاصطناعي.
الخطوة 4: إضافة حسابات WeChat متعددة (اختياري)
يدعم OpenClaw حسابات WeChat متعددة في وقت واحد. لإضافة حساب آخر، ما عليك سوى تشغيل أمر تسجيل الدخول مرة أخرى:
openclaw channels login --channel openclaw-weixin
كل مسح لرمز QR ينشئ إدخال حساب جديد. تعمل جميع الحسابات بالتوازي دون تداخل مع بعضها البعض.
الخطوة 5: عزل سياقات المحادثة (اختياري)
بشكل افتراضي، تشترك جميع القنوات في نفس سياق محادثة الذكاء الاصطناعي. هذا يعني أن محادثاتك على WeChat والقنوات الأخرى (Telegram، Discord، إلخ) تشترك في نفس ذاكرة الذكاء الاصطناعي.
إذا كنت تريد أن يكون لكل حساب WeChat سياقه المعزول الخاص به:
openclaw config set agents.mode per-channel-per-peer
مع هذا الإعداد، تحصل كل تركيبة من "حساب WeChat + جهة اتصال" على ذاكرة ذكاء اصطناعي مستقلة خاصة بها. لن تتداخل المحادثات بين الحسابات المختلفة مع بعضها البعض.
كيف يعمل المكون الإضافي تحت الغطاء
للمطورين الذين يرغبون في فهم المكون الإضافي أو توسيعه، إليك كيفية تواصله مع بوابة OpenClaw.
رؤوس المصادقة
تستخدم جميع طلبات API هذه الرؤوس:
| الرأس | القيمة |
|---|---|
Content-Type |
application/json |
AuthorizationType |
ilink_bot_token |
Authorization |
Bearer <token> |
X-WECHAT-UIN |
وحدة uint32 عشوائية مشفرة بـ base64 |
نقاط نهاية API الأساسية
يستخدم المكون الإضافي 5 نقاط نهاية HTTP JSON:
| نقطة النهاية | المسار | الغرض |
|---|---|---|
| getUpdates | getupdates |
استطلاع طويل للرسائل الجديدة |
| sendMessage | sendmessage |
إرسال نص/صورة/فيديو/ملف |
| getUploadUrl | getuploadurl |
الحصول على عنوان URL لتحميل 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 |
تحميل الوسائط (الصور، الملفات، مقاطع الفيديو)
يتم تشفير ملفات الوسائط باستخدام AES-128-ECB قبل التحميل. تتبع العملية:
- استدعاء
getUploadUrlببيانات تعريف الملف (الحجم، MD5) - استقبال معلمات تحميل CDN الموقعة مسبقًا
- تشفير الملف باستخدام AES-128-ECB
- التحميل إلى CDN باستخدام عنوان URL الموقّع مسبقًا
- الاستشهاد بملف CDN في
sendMessage
المشكلات الشائعة والإصلاحات
المكون الإضافي يرفض التحميل
الخطأ: المكون الإضافي يرفض التحميل عند التشغيل
الإصلاح: تحقق من إصدار OpenClaw الخاص بك. يتطلب المكون الإضافي v2.0.x الإصدار >=2026.3.22.
openclaw --version
# إذا كان قديمًا، قم بتحديث OpenClaw أولاً
انتهاء صلاحية رمز QR
الخطأ: انتهى وقت رمز QR قبل المسح
الإصلاح: أعد تشغيل أمر تسجيل الدخول. تنتهي صلاحية رموز QR بعد حوالي 30 ثانية.
openclaw channels login --channel openclaw-weixin
الرسائل لم يتم استلامها
الخطأ: رسائل WeChat لا تصل إلى OpenClaw
الإصلاح: أعد تشغيل البوابة بعد تسجيل الدخول.
openclaw gateway restart
حسابات متعددة تخلط السياقات
الخطأ: تظهر استجابات الذكاء الاصطناعي من حساب واحد في حساب آخر
الإصلاح: تمكين عزل السياق لكل قناة.
openclaw config set agents.mode per-channel-per-peer
حالات الاستخدام في العالم الحقيقي
مساعد ذكاء اصطناعي شخصي
ربط WeChat الشخصي الخاص بك بـ OpenClaw والحصول على مساعد ذكاء اصطناعي للرد على الرسائل عندما تكون مشغولاً. قم بإعداد عزل السياق بحيث تتلقى كل جهة اتصال ردودًا مخصصة بناءً على سجل محادثاتها.
دعم عملاء الشركات الصغيرة
تشغيل حسابات WeChat متعددة لخطوط عمل مختلفة. يتعامل كل حساب مع استفسارات عملائه الخاصة بذاكرة ذكاء اصطناعي معزولة. لا يوجد تلوث متقاطع بين الحسابات.
اختبار المطورين
استخدم واجهة برمجة التطبيقات HTTP JSON لإنشاء تكاملات مخصصة. بروتوكول الخلفية للمكون الإضافي موثق بالكامل، مما يسهل توسيع أو استبدال السلوك الافتراضي.
الخلاصة
يستغرق إعداد OpenClaw مع WeChat أقل من 5 دقائق. قم بتثبيت المكون الإضافي، امسح رمز QR، أعد تشغيل البوابة — تم. الإعداد المجاني يدعم حسابات متعددة، عزل السياق، ودعم وسائط متعددة كامل (صور، صوت، ملفات، فيديو).
للمطورين، تجعل واجهة برمجة التطبيقات HTTP JSON الموثقة التكاملات المخصصة مباشرة.
ابدأ بمثبت التثبيت بنقرة واحدة:
npx -y @tencent-weixin/openclaw-weixin-cli install
الخطوة التالية: بمجرد تشغيل روبوت WeChat الخاص بك، ستحتاج على الأرجح إلى ربطه بواجهات برمجة تطبيقات خارجية — بوابات الدفع، أنظمة إدارة علاقات العملاء (CRMs)، خدمات الطقس، إلخ. اختبر واجهات برمجة التطبيقات الخاصة بك باستخدام Apidog للتأكد من أن الروبوت يرسل البيانات الصحيحة في كل مرة. تتوفر طبقة مجانية، لا يلزم وجود بطاقة ائتمان.
الأسئلة الشائعة
س: هل يعمل هذا مع حسابات WeChat الشخصية؟
ج: نعم. على عكس معظم أدوات أتمتة WeChat، يعمل هذا المكون الإضافي مع الحسابات الشخصية. لا يلزم وجود حساب مؤسسي أو رسمي.
س: هل المكون الإضافي مجاني؟
ج: نعم. المكون الإضافي @tencent-weixin/openclaw-weixin مجاني ومفتوح المصدر. كل ما تحتاجه هو تثبيت OpenClaw يعمل.
س: هل يمكنني تشغيل عدة حسابات WeChat في نفس الوقت؟
ج: نعم. قم بتشغيل openclaw channels login --channel openclaw-weixin لكل حساب. تعمل جميع الحسابات في وقت واحد.
س: ماذا يحدث إذا أعدت تشغيل جهاز الكمبيوتر الخاص بي؟
ج: يتم حفظ بيانات اعتماد تسجيل الدخول محليًا. لا تحتاج إلى مسح رمز QR مرة أخرى بعد إعادة التشغيل. فقط أعد تشغيل البوابة باستخدام openclaw gateway restart.
س: هل يمكنني بناء تكاملات مخصصة فوق هذا؟
ج: نعم. يكشف المكون الإضافي عن واجهة برمجة تطبيقات HTTP JSON موثقة بخمس نقاط نهاية: getUpdates، sendMessage، getUploadUrl، getConfig، و sendTyping. إذا كان روبوتك يحتاج إلى استدعاء خدمات خارجية، فاستخدم Apidog لاختبار والتحقق من تكاملات واجهة برمجة التطبيقات الخاصة بك قبل الانتقال إلى العمل الفعلي.