💬

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 の設定

openclaw.json ファイルに Zalo 設定を追加します：

{
  "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 は最初に承認が必要な場合があります。