Zalo Personal 外掛

透過使用原生 zca-js 的外掛，讓 OpenClaw 支援 Zalo Personal， 以自動化一般 Zalo 使用者帳號。不需要外部 zca/openzca 命令列介面執行檔。

非官方自動化可能導致帳號遭停權或封鎖。請自行承擔風險。

​

命名

頻道 ID 為 zalouser，用以明確表示這會自動化個人 Zalo 使用者帳號（非官方）。另一個 zalo 頻道 ID 則是官方內建的 Zalo Bot／網路鉤子整合，請參閱 Zalo。

​

執行位置

此外掛會在閘道程序內執行。若使用遠端閘道， 請在該主機上安裝並設定，然後重新啟動閘道。

​

安裝

​

從 npm 安裝

openclaw plugins install @openclaw/zalouser

使用不含版本的套件名稱即可跟隨目前的官方發布標籤；只有在需要可重現的安裝時， 才鎖定確切版本。之後請重新啟動閘道。

​

從本機資料夾安裝（開發）

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

之後請重新啟動閘道。

​

設定

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

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

如需私訊／群組存取控制、多帳號設定、環境變數與疑難排解資訊， 請參閱 Zalo Personal 頻道設定。

​

命令列介面

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

​

Agent 工具

工具名稱：zalouser

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

頻道訊息動作（並非 Agent 工具）也支援以 react 回應訊息。

​

相關內容

• Zalo Personal 頻道設定
• Zalo（官方 Bot／網路鉤子頻道）
• 建置外掛
• ClawHub