mirror of
https://github.com/hanzoai/bot.git
synced 2026-10-30 17:24:26 +00:00
zeekayandHanzo Dev
06e4edb152
docs.bot.ai does not resolve, so every Docs: line the CLI printed, and the doctor and migrate guide links, went nowhere. DOCS_ROOT and the literal links now point at https://docs.hanzo.bot/docs, which hanzo-docs/docs publishes from this repo's docs/. The docs search command still names the old Mintlify MCP tool; nothing serves an equivalent yet. Co-authored-by: Hanzo Dev <[email protected]>
@hanzo/bot-zalouser
Hanzo Bot extension for Zalo Personal Account messaging via native zca-js integration.
Warning: Using Zalo automation may result in account suspension or ban. Use at your own risk. This is an unofficial integration.
Features
- Channel plugin integration with onboarding + QR login
- In-process listener/sender via
zca-js(no external CLI) - Multi-account support
- Agent tool integration (
zalouser) - DM/group policy support
Prerequisites
- Hanzo Bot Gateway
- Zalo mobile app (for QR login)
No external zca, openzca, or zca-cli binary is required.
Install
Option A: npm
hanzo-bot plugins install @hanzo/bot-zalouser
Option B: local source checkout
hanzo-bot plugins install ./extensions/zalouser
cd ./extensions/zalouser && pnpm install
Restart the Gateway after install.
Quick start
Login (QR)
hanzo-bot channels login --channel zalouser
Scan the QR code with the Zalo app on your phone.
Enable channel
channels:
zalouser:
enabled: true
dmPolicy: pairing # pairing | allowlist | open | disabled
Send a message
hanzo-bot message send --channel zalouser --target <threadId> --message "Hello from Hanzo Bot"
Configuration
Basic:
channels:
zalouser:
enabled: true
dmPolicy: pairing
Multi-account:
channels:
zalouser:
enabled: true
defaultAccount: default
accounts:
default:
enabled: true
profile: default
work:
enabled: true
profile: work
Useful commands
hanzo-bot channels login --channel zalouser
hanzo-bot channels login --channel zalouser --account work
hanzo-bot channels status --probe
hanzo-bot channels logout --channel zalouser
hanzo-bot directory self --channel zalouser
hanzo-bot directory peers list --channel zalouser --query "name"
hanzo-bot directory groups list --channel zalouser --query "work"
hanzo-bot directory groups members --channel zalouser --group-id <id>
Agent tool
The extension registers a zalouser tool for AI agents.
Available actions: send, image, link, friends, groups, me, status
Troubleshooting
- Login not persisted:
hanzo-bot channels logout --channel zalouser && hanzo-bot channels login --channel zalouser - Probe status:
hanzo-bot channels status --probe - Name resolution issues (allowlist/groups): use numeric IDs or exact Zalo names
Credits
Built on zca-js.