Zalo Personal (غير رسمي) - قناة دردشة

هذا التكامل يقوم بأتمتة حساب Zalo شخصي عبر zca-cli.

مكون إضافي مطلوب

Zalo Personal يأتي كمكون إضافي وليس مجمعاً مع التثبيت الأساسي.

• التثبيت عبر CLI: openclaw plugins install @openclaw/zalouser
• أو من checkout المصدر: openclaw plugins install ./extensions/zalouser

المتطلبات الأساسية: zca-cli

يجب أن يكون لدى جهاز Gateway الملف الثنائي zca متاحاً في PATH.

• التحقق: zca --version
• إذا كان مفقوداً، قم بتثبيت zca-cli (راجع extensions/zalouser/README.md أو وثائق zca-cli الأصلية).

الإعداد السريع (للمبتدئين)

1. تثبيت المكون الإضافي (انظر أعلاه).
2. تسجيل الدخول (QR، على جهاز Gateway):

   openclaw channels login --channel zalouser

   امسح رمز QR في الطرفية باستخدام تطبيق Zalo للهاتف المحمول.

3. تمكين القناة:

   {
     channels: {
       zalouser: {
         enabled: true,
         dmPolicy: "pairing",
       },
     },
   }

4. إعادة تشغيل Gateway (أو إنهاء الإعداد).
5. الوصول للرسائل المباشرة يُعيّن افتراضياً على pairing؛ وافق على رمز الاقتران عند أول اتصال.

ما هو؟

• يستخدم zca listen لاستقبال الرسائل الواردة.
• يستخدم zca msg ... لإرسال الردود (نص/وسائط/رابط).
• مصمم لحالات استخدام "الحساب الشخصي" حيث Zalo Bot API غير متاح.

التسمية

معرف القناة هو zalouser لتوضيح أن هذا يقوم بأتمتة حساب مستخدم Zalo الشخصي (غير رسمي). نحتفظ بـ zalo لتكامل Zalo API رسمي محتمل في المستقبل.

إيجاد المعرفات (الدليل)

استخدم دليل CLI لاكتشاف النظراء/المجموعات ومعرفاتهم:

openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"

الحدود

• يتم تقسيم النص الصادر إلى ~2000 حرف (حدود عميل Zalo).
• البث المباشر محظور افتراضياً.

التحكم في الوصول (الرسائل المباشرة)

channels.zalouser.dmPolicy يدعم: pairing | allowlist | open | disabled (افتراضي: pairing).

channels.zalouser.allowFrom يقبل معرفات المستخدمين أو الأسماء. يحل المعالج الأسماء إلى معرفات عبر zca friend find عند توفرها.

الموافقة عبر:

openclaw pairing list zalouser
openclaw pairing approve zalouser <CODE>

الوصول للمجموعات (اختياري)

افتراضياً: channels.zalouser.groupPolicy = "open" (المجموعات مسموحة).

تقييد إلى قائمة بيضاء مع:

• channels.zalouser.groupPolicy = "allowlist"
• channels.zalouser.groups (المفاتيح هي معرفات المجموعات أو الأسماء)

حظر جميع المجموعات: channels.zalouser.groupPolicy = "disabled".

مثال

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}

متعدد الحسابات

الحسابات تُعيّن إلى ملفات تعريف zca. مثال:

{
  channels: {
    zalouser: {
      enabled: true,
      defaultAccount: "default",
      accounts: {
        work: { enabled: true, profile: "work" },
      },
    },
  },
}

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

openclaw channels status --probe

openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser