Zalo الشخصي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Plugin المضمّن

• التثبيت عبر CLI: openclaw plugins install @openclaw/zalouser
• إصدار مثبّت: openclaw plugins install @openclaw/zalouser@2026.5.2
• أو من نسخة مصدرية: openclaw plugins install ./path/to/local/zalouser-plugin
• التفاصيل: Plugins

​

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

1. تأكد من توفر Plugin الخاص بـ Zalo Personal.
   • تتضمنه إصدارات OpenClaw المعبأة الحالية بالفعل.
   • يمكن للتثبيتات الأقدم/المخصصة إضافته يدويًا باستخدام الأوامر أعلاه.
2. سجّل الدخول (QR، على جهاز Gateway):
   • openclaw channels login --channel zalouser
   • امسح رمز QR باستخدام تطبيق Zalo للهاتف المحمول.
3. فعّل القناة:

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

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

​

ما هو

• يعمل بالكامل داخل العملية عبر zca-js.
• يستخدم مستمعي أحداث أصليين لاستقبال الرسائل الواردة.
• يرسل الردود مباشرة عبر JS API (نص/وسائط/رابط).
• مصمم لحالات استخدام “الحساب الشخصي” حيث لا تتوفر Zalo Bot API.

​

التسمية

​

العثور على المعرّفات (الدليل)

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

​

الحدود

• يُجزّأ النص الصادر إلى نحو 2000 حرف (حدود عميل Zalo).
• البث محظور افتراضيًا.

​

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

• openclaw pairing list zalouser
• openclaw pairing approve zalouser <code>

​

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

• الافتراضي: channels.zalouser.groupPolicy = "open" (المجموعات مسموحة). استخدم channels.defaults.groupPolicy لتجاوز الافتراضي عند عدم تعيينه.
• قيّد الوصول إلى قائمة سماح باستخدام:
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (يجب أن تكون المفاتيح معرّفات مجموعات مستقرة؛ تُحل الأسماء إلى معرّفات عند بدء التشغيل فقط عند تمكين channels.zalouser.dangerouslyAllowNameMatching: true)
  • channels.zalouser.groupAllowFrom (يتحكم في المرسلين داخل المجموعات المسموح بها الذين يمكنهم تشغيل الروبوت؛ يمكن الإشارة إلى مجموعات وصول المرسلين الثابتة باستخدام accessGroup:<name>)
• احظر كل المجموعات: channels.zalouser.groupPolicy = "disabled".
• يمكن لمعالج الإعداد المطالبة بقوائم سماح المجموعات.
• عند بدء التشغيل، يحل OpenClaw أسماء المجموعات/المستخدمين في قوائم السماح إلى معرّفات ويسجل الربط فقط عند تمكين channels.zalouser.dangerouslyAllowNameMatching: true.
• مطابقة قائمة سماح المجموعات تكون بالمعرّفات فقط افتراضيًا. تُتجاهل الأسماء غير المحلولة للمصادقة ما لم يتم تمكين channels.zalouser.dangerouslyAllowNameMatching: true.
• channels.zalouser.dangerouslyAllowNameMatching: true هو وضع توافق لكسر القيود يعيد تمكين حل الأسماء القابلة للتغيير عند بدء التشغيل ومطابقة أسماء المجموعات وقت التشغيل.
• إذا لم يتم تعيين groupAllowFrom، يعود وقت التشغيل إلى allowFrom لفحوصات مرسلي المجموعات.
• تنطبق فحوصات المرسلين على رسائل المجموعات العادية وأوامر التحكم على حد سواء (مثل /new و/reset).

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["1471383327500481391"],
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}

​

بوابة الإشارات في المجموعات

• يتحكم channels.zalouser.groups.<group>.requireMention فيما إذا كانت ردود المجموعات تتطلب إشارة.
• ترتيب الحل: معرّف/اسم المجموعة المطابق تمامًا -> slug المجموعة المطبّع -> * -> الافتراضي (true).
• ينطبق هذا على المجموعات الموجودة في قائمة السماح وعلى وضع المجموعات المفتوحة.
• يُحسب اقتباس رسالة الروبوت كإشارة ضمنية لتفعيل المجموعة.
• يمكن لأوامر التحكم المصرح بها (مثل /new) تجاوز بوابة الإشارات.
• عندما يتم تخطي رسالة مجموعة لأن الإشارة مطلوبة، يخزنها OpenClaw كسجل مجموعة معلّق ويدرجها في رسالة المجموعة التالية التي تتم معالجتها.
• الحد الافتراضي لسجل المجموعات هو messages.groupChat.historyLimit (احتياطيًا 50). يمكنك تجاوزه لكل حساب باستخدام channels.zalouser.historyLimit.

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "*": { allow: true, requireMention: true },
        "Work Chat": { allow: true, requireMention: false },
      },
    },
  },
}

​

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

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

​

الكتابة، والتفاعلات، وإقرارات التسليم

• يرسل OpenClaw حدث كتابة قبل إرسال الرد (بأفضل جهد).
• إجراء تفاعل الرسالة react مدعوم لـ zalouser في إجراءات القنوات.
  • استخدم remove: true لإزالة رمز تعبيري محدد للتفاعل من رسالة.
  • دلالات التفاعل: التفاعلات
• للرسائل الواردة التي تتضمن بيانات وصفية للأحداث، يرسل OpenClaw إقرارات التسليم + المشاهدة (بأفضل جهد).

​

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

• openclaw channels status --probe
• إعادة تسجيل الدخول: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser

• استخدم المعرّفات الرقمية في allowFrom/groupAllowFrom ومعرّفات المجموعات المستقرة في groups. إذا كنت تحتاج عمدًا إلى أسماء الأصدقاء/المجموعات الدقيقة، فمكّن channels.zalouser.dangerouslyAllowNameMatching: true.

• أزل أي افتراضات قديمة حول عملية zca خارجية.
• تعمل القناة الآن بالكامل داخل OpenClaw من دون ملفات CLI تنفيذية خارجية.

​

ذات صلة

• نظرة عامة على القنوات — كل القنوات المدعومة
• الاقتران — مصادقة الرسائل المباشرة وتدفق الاقتران
• المجموعات — سلوك دردشة المجموعات وبوابة الإشارات
• توجيه القنوات — توجيه الجلسات للرسائل
• الأمان — نموذج الوصول والتقوية