Zalo Personal 外掛程式

Zalo Personal (外掛程式)

透過外掛程式為 OpenClaw 提供 Zalo Personal 支援，使用原生 zca-js 來自動化一般的 Zalo 使用者帳戶。

警告： 非官方的自動化可能導致帳戶停權/封鎖。使用風險請自行承擔。

命名

頻道 ID 為 zalouser，以明確表示此功能自動化的是 Zalo 個人帳戶（非官方）。我們保留 zalo 給未來潛在的官方 Zalo API 整合。

執行位置

此外掛程式執行於 Gateway 程序內部。

如果您使用遠端 Gateway，請在 執行 Gateway 的機器上 安裝/設定它，然後重新啟動 Gateway。

不需要外部的 zca/openzca CLI 執行檔。

安裝

選項 A：從 npm 安裝

openclaw plugins install @openclaw/zalouser

之後請重新啟動 Gateway。

選項 B：從本機資料夾安裝（開發用）

PLUGIN_SRC=./path/to/local/zalouser-plugin
openclaw plugins install "$PLUGIN_SRC"
cd "$PLUGIN_SRC" && pnpm install

之後請重新啟動 Gateway。

設定

頻道設定位於 channels.zalouser 之下（而非 plugins.entries.*）：

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

CLI

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

Agent 工具

工具名稱：zalouser

動作：send、image、link、friends、groups、me、status

頻道訊息動作也支援 react 用於訊息回應。