mirror of https://github.com/hanzoai/bot.git synced 2026-11-01 18:02:28 +00:00

Files

T

zeekay 0f9ecb370f docs: rebrand READMEs from upstream OpenClaw to Hanzo Bot

Strip upstream marketing surfaces (logo picture, EXFOLIATE tagline,
sponsor block pointing at upstream's OpenAI/Vercel/Blacksmith/Convex
relationship) and rewrite refs:

  openclaw → hanzo-bot               (CLI name from package.bin)
  OpenClaw → Hanzo Bot               (display name)
  openclaw/openclaw → hanzoai/bot
  openclaw.ai → hanzo.ai
  docs.openclaw.ai → docs.hanzo.ai
  discord.gg/clawd → hanzo.ai#community
  openclaw/nix-openclaw → hanzoai/nix-bot

Touches the top-level README plus the in-tree READMEs that carried the
same upstream copy (apps/*, assets/chrome-extension, docs/security,
docs/.i18n, extensions/*, scripts/shell-helpers, src/hooks/bundled).

Residual OPENCLAW_* env-var refs are intentionally left — they document
the runtime config keys the code still reads. Renaming those needs a
matching code change with a config migration.

2026-05-11 15:35:22 -07:00

2.5 KiB

Raw Permalink Blame History

@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

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.

2.5 KiB Raw Permalink Blame History