Zalo 個人帳號（外掛）

透過外掛為 OpenClaw 提供 Zalo 個人帳號支援，使用原生 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：從本機資料夾安裝（開發用）

openclaw plugins install ./extensions/zalouser
cd ./extensions/zalouser && 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，用於訊息表情回應。