💬

Zalo 集成

將 OpenClaw 連接到 Zalo，讓您的 AI 助手即時響應消息。

簡要說明

✓ 前置條件：Node.js 22+，已安裝 OpenClaw
✓ 配置：在 openclaw.json 中添加 Zalo 配置
✓ 耗時：約 10 分鐘
✓ 需要：Zalo 賬號 + OA (官方賬號)

前置條件

1.

已安裝 OpenClaw

如果您還沒有安裝，請先按照安裝指南操作。
2.

Zalo 官方賬號 (OA)

您需要在 oa.zalo.me 創建 Zalo 官方賬號。
3.

Zalo API 憑據

從 Zalo OA 管理後臺獲取您的 OA ID 和 API 密鑰。

設置步驟

步驟 1：創建 Zalo 官方賬號

如果您還沒有 OA：

訪問 oa.zalo.me
註冊官方賬號（按照嚮導操作）
驗證您的賬號
從管理後臺獲取您的 OA ID

步驟 2：配置 openclaw.json

將 Zalo 配置添加到您的 openclaw.json 文件中：

{
  "channels": {
    "zalo": {
      "enabled": true,
      "oaId": "您的_oa_id",
      "apiKey": "您的_api_key",
      "allowFrom": ["*"]
    }
  }
}

步驟 3：啟動 OpenClaw

啟動啟用 Zalo 的 OpenClaw：

openclaw start

機器人將連接到 Zalo 並準備好接收消息。

步驟 4：測試您的 AI 助手

打開 Zalo 並搜索您的官方賬號：

打開 Zalo 應用
搜索您的 OA 名稱
發送消息開始對話

🎉 連接成功！您的 Zalo AI 助手已準備就緒。

高級配置

允許特定用戶

限制誰可以與您的 AI 助手交互：

{
  "channels": {
    "zalo": {
      "enabled": true,
      "oaId": "您的_oa_id",
      "apiKey": "您的_api_key",
      "allowFrom": ["user_id_1", "user_id_2"]
    }
  }
}

Webhook 配置

對於高級功能，請在 Zalo OA 管理後臺配置 webhook：

進入 OA 管理後臺 → 高級設置 → Webhook
將 webhook URL 設置為您的 OpenClaw 服務器
啟用您想要接收的事件

故障排除

API 密鑰無效？

檢查 Zalo OA 管理後臺中的 API 密鑰。確保您的賬號已啟用 API。

消息未收到？

驗證您的 openclaw.json 中 Zalo 頻道的 "enabled" 設置為 true，並檢查日誌。

OA 未找到？

確保您的官方賬號已驗證並處於活躍狀態。新 OA 可能需要先審批。