ClawBot زالو

OpenClaw از طریق Plugin خارجی @zalo-platforms/openclaw-zaloclawbot که در کاتالوگ فهرست شده است، به Zalo ClawBot متصل می‌شود. ورود با کد QR یک Zalo Mini App انجام می‌شود؛ شناسه Plugin در پیکربندی openclaw-zaloclawbot است.

سازگاری

پیش‌نیازها

• Node.js >= 22
• OpenClaw نصب‌شده (openclaw CLI در دسترس باشد)
• یک حساب Zalo روی دستگاه همراه برای اسکن کد QR ورود

نصب با onboard (توصیه‌شده)

openclaw onboard

از منوی کانال، Zalo ClawBot را انتخاب کنید. راه‌انداز، Plugin را از کاتالوگ رسمی نصب می‌کند (با صحت‌سنجی یکپارچگی)، کد QR ورود را در ترمینال نمایش می‌دهد و پس از اسکن آن با برنامه Zalo، راه‌اندازی کانال را تکمیل می‌کند.

نصب دستی

برای افزودن کانال به Gateway که قبلاً راه‌اندازی شده است:

1. نصب Plugin

openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"

از همین نسخه دقیق و ثابت استفاده کنید تا OpenClaw هنگام نصب، بسته را با هش یکپارچگی کاتالوگ اعتبارسنجی کند.

2. فعال‌کردن Plugin در پیکربندی

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

3. ایجاد کد QR و ورود

openclaw channels login --channel openclaw-zaloclawbot

کد QR نمایش‌داده‌شده در ترمینال را با برنامه موبایل Zalo اسکن کنید، شرایط استفاده را در Zalo Mini App بپذیرید و نشست را مجاز کنید.

4. راه‌اندازی مجدد Gateway

openclaw gateway restart

نحوه کار

برخلاف کانال استاندارد Zalo که نیازمند ثبت Zalo Official Account (OA) اختصاصی و پیکربندی اطلاعات اعتبارسنجی ایستای توسعه‌دهنده است، Zalo ClawBot یک دستیار شخصی وابسته به مالک روی زیرساخت رسمی مشترک است:

1. راه‌اندازی اولیه: کد QR به یک Zalo Mini App منتهی می‌شود که ربات خصوصی و تازه تأمین‌شده‌ای را زیر یک OA رسمی مشترک، مستقیماً به شناسه کاربری Zalo شما متصل می‌کند.
2. حریم خصوصی وابسته به مالک: ربات فقط با مالک خود ارتباط برقرار می‌کند. پیام‌های کاربران دیگر در سطح پلتفرم حذف می‌شوند.
3. مسیر API رسمی: Plugin از APIهای Zalo Bot Platform استفاده می‌کند، نه خودکارسازی مرورگر یا نشست وب.

جزئیات داخلی

Plugin از طریق یک حلقه long-polling پایدار (getUpdates) با Zalo ارتباط برقرار می‌کند. Webhookها به‌طور پیش‌فرض برای اجرای محلی Gateway در دسکتاپ یا ترمینال غیرفعال هستند. پیام‌ها در سمت کلاینت پردازش و به محیط اجرای عامل محلی شما نگاشت می‌شوند.

Plugin اطلاعات اعتبارسنجی ربات را در دایرکتوری وضعیت OpenClaw مدیریت می‌کند. این دایرکتوری را حساس در نظر بگیرید و همان سیاست کنترل دسترسی و پشتیبان‌گیری سایر وضعیت OpenClaw را برای آن نیز اعمال کنید.

محیط اجرای این Plugin کاملاً در بسته خارجی @zalo-platforms/openclaw-zaloclawbot قرار دارد؛ جزئیات رفتاری زیر، فراتر از نصب و پیکربندی، مطابق گزارش نگه‌دارندگان Plugin است و با کد منبع هسته OpenClaw اعتبارسنجی نشده است.

عیب‌یابی

• پایان مهلت ورود با QR: توکن ورود (zbsk) برای حفظ امنیت پس از 5 دقیقه منقضی می‌شود. اگر کد QR پیش از اسکن منقضی شد، فرمان ورود را دوباره اجرا کنید تا کد جدیدی ایجاد شود.
• Gateway بارگذاری نمی‌شود: تأیید کنید نسخه میزبان OpenClaw شما 2026.4.10 یا بالاتر است. نسخه‌های قدیمی‌تر از دفتر ثبت نصب Plugin خارجی npm که این شناسه نیاز دارد، پشتیبانی نمی‌کنند.

مرتبط

• نمای کلی کانال‌ها - همه کانال‌های پشتیبانی‌شده
• Zalo - کانال همراه Zalo Bot Creator / Marketplace
• جفت‌سازی - احراز هویت پیام مستقیم و جریان جفت‌سازی
• Pluginها - نصب و مدیریت Pluginها