Hunter Miller 0b3f4a27ba docs: update all plugin docs to reflect bundled + auto-install

Updated docs for all bundled plugins to reflect:
- Plugins are bundled with Clawdbot
- Dependencies auto-install on first load when enabled
- npm install is an alternative, not required
- Simplified setup steps

Updated channels:
- line, matrix, mattermost, msteams, nextcloud-talk, nostr, zalo, zalouser

Updated plugins:
- voice-call, zalouser

2026-01-26 12:55:13 -06:00

1.9 KiB

Raw Blame History

summary

read_when

Zalo Personal plugin: QR login + messaging via zca-cli (plugin install + channel config + CLI + tool)

You want Zalo Personal (unofficial) support in Clawdbot

You are configuring or developing the zalouser plugin

Zalo Personal (plugin)

Zalo Personal support for Clawdbot 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.

Plugin setup

Zalo Personal is bundled with Clawdbot. Its dependencies are automatically installed on first load when you enable the plugin.

To enable, add zalouser to your plugins allow list:

{
  plugins: {
    allow: ["zalouser"]
  }
}

Alternatively, install explicitly from npm:

clawdbot plugins install @clawdbot/zalouser

Restart the Gateway afterwards.

Prerequisite: zca-cli

The Gateway machine must have zca on PATH:

zca --version

Config

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

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

CLI

clawdbot channels login --channel zalouser
clawdbot channels logout --channel zalouser
clawdbot channels status --probe
clawdbot message send --channel zalouser --target <threadId> --message "Hello from Clawdbot"
clawdbot directory peers list --channel zalouser --query "name"

Agent tool

Tool name: zalouser

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

1.9 KiB Raw Blame History