​

WhatsApp (قناة الويب)

​

التثبيت (عند الطلب)

• الإعداد (openclaw onboard) و openclaw channels add --channel whatsapp يطالبان بتثبيت إضافة WhatsApp أول مرة تحددها فيها.
• يوفّر openclaw channels login --channel whatsapp أيضًا تدفق التثبيت عندما لا تكون الإضافة موجودة بعد.
• قناة التطوير + سحب git: يُستخدم مسار الإضافة المحلي افتراضيًا.
• Stable/Beta: تُستخدم حزمة npm ‏@openclaw/whatsapp افتراضيًا.

openclaw plugins install @openclaw/whatsapp

​

إعداد سريع

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+15551234567"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

openclaw channels login --channel whatsapp

openclaw channels login --channel whatsapp --account work

openclaw gateway

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>

​

أنماط النشر

{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
  },
}

​

نموذج التشغيل

• تتولى البوابة مقبس WhatsApp وحلقة إعادة الاتصال.
• تتطلب عمليات الإرسال الصادرة مستمع WhatsApp نشطًا للحساب المستهدف.
• يتم تجاهل محادثات الحالة والبث (@status, @broadcast).
• تستخدم المحادثات المباشرة قواعد جلسة الرسائل الخاصة (session.dmScope؛ والقيمة الافتراضية main تدمج الرسائل الخاصة في الجلسة الرئيسية للوكيل).
• جلسات المجموعات معزولة (agent:<agentId>:whatsapp:group:<jid>).
• يراعي نقل WhatsApp Web متغيرات بيئة الوكيل القياسية على مضيف البوابة (HTTPS_PROXY, HTTP_PROXY, NO_PROXY / والمتغيرات المكافئة بالأحرف الصغيرة). يُفضَّل إعداد الوكيل على مستوى المضيف بدلًا من إعدادات وكيل WhatsApp الخاصة بالقناة.

​

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

​

سلوك الرقم الشخصي والدردشة الذاتية

• تخطي إيصالات القراءة في دورات الدردشة الذاتية
• تجاهل سلوك التشغيل التلقائي لإشارة JID الذي قد يؤدي بخلاف ذلك إلى تنبيهك أنت نفسك
• إذا لم يتم تعيين messages.responsePrefix، فستكون بادئة ردود الدردشة الذاتية افتراضيًا [{identity.name}] أو [openclaw]

​

تسوية الرسائل والسياق

[Replying to <sender> id:<stanzaId>]
<quoted body or media placeholder>
[/Replying]

{
  channels: {
    whatsapp: {
      sendReadReceipts: false,
    },
  },
}

{
  channels: {
    whatsapp: {
      accounts: {
        work: {
          sendReadReceipts: false,
        },
      },
    },
  },
}

​

التسليم، والتقسيم، والوسائط

​

مستوى التفاعلات

{
  channels: {
    whatsapp: {
      reactionLevel: "ack",
    },
  },
}

​

تفاعلات الإقرار

{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions", // always | mentions | never
      },
    },
  },
}

• تُرسل فورًا بعد قبول الوارد (قبل الرد)
• يتم تسجيل الإخفاقات لكنها لا تمنع تسليم الرد العادي
• يتفاعل وضع المجموعة mentions في الدورات التي يتم تشغيلها بالإشارة؛ ويعمل تفعيل المجموعة always كتجاوز لهذا الفحص
• يستخدم WhatsApp ‏channels.whatsapp.ackReaction (ولا يُستخدم هنا الإرثي messages.ackReaction)

​

الحسابات المتعددة وبيانات الاعتماد

​

الأدوات والإجراءات وكتابة الإعدادات

• يتضمن دعم أدوات الوكيل إجراء تفاعل WhatsApp ‏(react).
• بوابات الإجراءات:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• تكون عمليات كتابة الإعدادات التي تبدأها القناة مفعّلة افتراضيًا (يمكن تعطيلها عبر channels.whatsapp.configWrites=false).

​

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

openclaw channels login --channel whatsapp
openclaw channels status

openclaw doctor
openclaw logs --follow

​

مؤشرات مرجعية للإعداد

• مرجع الإعداد - WhatsApp

• الوصول: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups
• التسليم: textChunkLimit, chunkMode, mediaMaxMb, sendReadReceipts, ackReaction, reactionLevel
• الحسابات المتعددة: accounts.<id>.enabled, accounts.<id>.authDir, والتجاوزات على مستوى الحساب
• العمليات: configWrites, debounceMs, web.enabled, web.heartbeatSeconds, web.reconnect.*
• سلوك الجلسة: session.dmScope, historyLimit, dmHistoryLimit, dms.<id>.historyLimit

​

ذو صلة

• الاقتران
• المجموعات
• الأمان
• توجيه القنوات
• التوجيه متعدد الوكلاء
• استكشاف الأخطاء وإصلاحها