Sử dụng Zalo trên OpenClaw, cách thức kết nối

OpenClaw hỗ trợ kết nối Zalo qua hai cách chính:

• Zalo Bot API (chính thức, dùng cho bot/official account – khuyến nghị cho sử dụng ổn định, ít rủi ro).
• Zalo Personal (zalouser – không chính thức, dùng tài khoản Zalo cá nhân của bạn, có nguy cơ bị khóa tài khoản).

Dưới đây là hướng dẫn chi tiết cho từng cách (dựa trên tài liệu chính thức của OpenClaw).

1. Kết nối Zalo Bot API (Chính thức – Khuyến nghị)

Cách này dùng Bot Token từ nền tảng Zalo, phù hợp cho bot hỗ trợ hoặc sử dụng lâu dài.

Các bước thực hiện:

1. Tạo Bot trên Zalo:
   • Truy cập: https://bot.zaloplatforms.com
   • Đăng nhập và tạo bot mới.
   • Copy Bot Token (thường có dạng numeric_id:secret).
2. Cài đặt plugin (nếu cần):
   • Plugin Zalo thường đã được bundle sẵn trong phiên bản OpenClaw mới nhất.
   • Nếu chưa có, chạy lệnh:

     text

     openclaw plugins install @openclaw/zalo

3. Cấu hình token:
   • Cách nhanh (environment variable):

     text

     export ZALO_BOT_TOKEN="your_bot_token_here"

   • Cách khuyến nghị (thêm vào file config openclaw.json hoặc tương đương):

     JSON

     {
       "channels": {
         "zalo": {
           "enabled": true,
           "accounts": {
             "default": {
               "botToken": "your_bot_token_here",
               "dmPolicy": "pairing"
             }
           }
         }
       }
     }

4. Khởi động lại gateway:

   text

   openclaw restart

5. Phê duyệt truy cập (Pairing):
   • Mặc định dùng chính sách pairing: Khi bạn chat lần đầu với bot từ Zalo, nó sẽ gửi mã pairing code.
   • Chạy lệnh để kiểm tra và phê duyệt:

     text

     openclaw pairing list zalo
     openclaw pairing approve zalo 

   • Sau khi approve, bạn có thể chat bình thường với OpenClaw qua Zalo.

Lưu ý:

• Hỗ trợ tốt tin nhắn văn bản (giới hạn ~2000 ký tự).
• Media (ảnh, file) hỗ trợ hạn chế.
• Không hỗ trợ group chat với Marketplace bot.

2. Kết nối Zalo Personal (zalouser – Tài khoản cá nhân)

Cách này dùng chính tài khoản Zalo cá nhân của bạn (thông qua QR code), tiện cho sử dụng cá nhân nhưng rủi ro cao (có thể bị Zalo khóa tài khoản vì không chính thức).

Các bước thực hiện:

1. Cài đặt plugin (nếu cần):

   text

   openclaw plugins install @openclaw/zalouser

   (Thường đã bundle sẵn).
2. Đăng nhập Zalo:
   • Trong giao diện chat mặc định của OpenClaw, bạn có thể yêu cầu:

     "help me login to zalouser" hoặc tương tự.

   • OpenClaw sẽ hiển thị mã QR.
   • Mở app Zalo trên điện thoại → Quét QR để xác thực (approve).
   • Chờ quá trình login hoàn tất.
3. Cấu hình (tùy chọn):

   JSON

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

4. Khởi động lại và phê duyệt:
   • Restart gateway.
   • Khi chat lần đầu từ Zalo cá nhân, sẽ nhận pairing code → Approve bằng lệnh:

     text

     openclaw pairing list zalouser
     openclaw pairing approve zalouser 

Lưu ý quan trọng:

• Đây là tích hợp experimental (thử nghiệm), dùng zca-js nội bộ.
• Rủi ro: Tài khoản Zalo cá nhân có thể bị khóa nếu Zalo phát hiện tự động hóa.
• Hỗ trợ tốt hơn về media và group chat so với Bot API.

Mẹo chung

• Sau khi kết nối thành công, bạn có thể chat trực tiếp với OpenClaw qua Zalo như chat với bạn bè (ví dụ: yêu cầu thực hiện task, tự động hóa công việc...).
• Kiểm tra trạng thái channel: openclaw channels status --probe
• Xem log nếu có lỗi: openclaw logs --follow
• Để dùng mượt mà, nên chạy OpenClaw trên server/VPS 24/7.

Nếu bạn gặp lỗi cụ thể (ví dụ: không thấy QR, token invalid...), hãy cung cấp thêm chi tiết để mình hỗ trợ chi tiết hơn. Bạn có thể tham khảo thêm docs chính thức tại docs.openclaw.ai/channels/zalo hoặc các video hướng dẫn trên YouTube (tìm "Hướng dẫn kết nối Zalo OpenClaw").