2Anh Zalo Bot

What 2Anh Zalo Bot does

Zalo has no bot API for personal accounts, and the README says the Python libraries zlapi and zca-py are unusable, so this project keeps the JavaScript zca-js library as a sidecar and connects it to a Python Hermes platform plugin over a local WebSocket. The sidecar holds the Zalo session with QR login, cookies and reconnects; the plugin handles permissions, group tag filtering and feeding messages into the agent.

The bot shares tools, memory, skills and cron with your Hermes agent. A dashboard offers per-group permissions, group insights, server health and one-touch updates with backup and rollback. Owner-only tools are checked at call time, dangerous actions can require a six-character code, and the bridge uses token authentication and rate limiting to avoid account locks. The README is in Vietnamese with an English version.

Key features

• Zalo as a Hermes platform alongside Telegram, Discord and Slack
• zca-js sidecar linked to a Python plugin over local WebSocket
• Dashboard with chat sessions, per-group permissions and group insights
• Owner-only tools with optional confirmation codes
• Token-authenticated bridge with rate limiting
• One-touch update with automatic backup and rollback

When to use it

• Running a Hermes assistant in Vietnamese Zalo group chats
• Teachers drafting tests and lesson plans in class groups
• Controlling which features group members can use

Who it is for: Hermes Agent users in Vietnam who want their agent reachable on Zalo.

How it fits with Hermes Agent

Built specifically as a Hermes Agent platform plugin and Node sidecar that exposes Zalo like the built-in messaging platforms.

Note: The README is mainly in Vietnamese, and Zalo has no official personal-account bot API, so the bridge relies on the unofficial zca-js library.

FAQ