Files
bot/docs/plugins/zalouser.md
zooqueen adb8e1f802 feat: merge upstream improvements via rebrand bridge
Squash merge of 1,462 upstream commits with openclaw→hanzo-bot
naming transforms applied. Conflicts resolved favoring our main
branch to preserve existing customizations.

Key upstream additions:
- iOS Security Stack (concurrency locks, runtime guards, TTS fallback)
- Discord CDN hostname allowlisting for SSRF protection
- Discord mention handling improvements
- Various bug fixes and stability improvements
2026-03-03 09:38:30 -08:00

1.9 KiB

summary, read_when, title
summary read_when title
Zalo Personal plugin: QR login + messaging via native zca-js (plugin install + channel config + tool)
You want Zalo Personal (unofficial) support in Hanzo Bot
You are configuring or developing the zalouser plugin
Zalo Personal Plugin

Zalo Personal (plugin)

Zalo Personal support for Hanzo Bot via a plugin, using zca-cli to automate a normal Zalo user account.

Warning: Unofficial automation may lead to account suspension/ban. Use at your own risk.

Naming

Channel id is zalouser to make it explicit this automates a personal Zalo user account (unofficial). We keep zalo reserved for a potential future official Zalo API integration.

Where it runs

This plugin runs inside the Gateway process.

If you use a remote Gateway, install/configure it on the machine running the Gateway, then restart the Gateway.

No external zca/openzca CLI binary is required.

Install

Option A: install from npm

hanzo-bot plugins install @bot/zalouser

Restart the Gateway afterwards.

Option B: install from a local folder (dev)

hanzo-bot plugins install ./extensions/zalouser
cd ./extensions/zalouser && pnpm install

Restart the Gateway afterwards.

Config

Channel config lives under channels.zalouser (not plugins.entries.*):

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

CLI

hanzo-bot channels login --channel zalouser
hanzo-bot channels logout --channel zalouser
hanzo-bot channels status --probe
hanzo-bot message send --channel zalouser --target <threadId> --message "Hello from Hanzo Bot"
hanzo-bot directory peers list --channel zalouser --query "name"

Agent tool

Tool name: zalouser

Actions: send, image, link, friends, groups, me, status

Channel message actions also support react for message reactions.