@zalo-platforms/openclaw-zaloclawbot Plugin を介して Zalo ClawBot に接続します。ログインには Zalo Mini App の QR コードを使用します。設定内の Plugin ID は openclaw-zaloclawbot です。
互換性
前提条件
- Node.js >= 22
- OpenClaw がインストール済み（
openclawCLI が利用可能） - ログイン用 QR コードをスキャンするための、モバイル端末上の Zalo アカウント
onboard を使用したインストール（推奨）
手動インストール
すでにオンボーディング済みの Gateway にチャンネルを追加するには、次の手順を実行します。1. Plugin をインストールする
2. 設定で Plugin を有効にする
3. QR コードを生成してログインする
4. Gateway を再起動する
仕組み
独自の Zalo Official Account（OA）を登録して固定の開発者認証情報を設定する必要がある標準の Zalo チャンネルとは異なり、Zalo ClawBot は共有の公式インフラストラクチャ上で動作する、所有者に紐付けられたパーソナルアシスタントです。- オンボーディング： QR コードから Zalo Mini App が開き、新たにプロビジョニングされたプライベートボットが共有の公式 OA 配下で Zalo ユーザー ID に直接紐付けられます。
- 所有者に紐付けられたプライバシー： ボットは所有者とのみ通信します。他のユーザーからのメッセージはプラットフォームレベルで破棄されます。
- 公式 API 経路： Plugin はブラウザーや Web セッションの自動化ではなく、Zalo Bot Platform API を使用します。
内部の仕組み
Plugin は永続的なロングポーリングループ（getUpdates）を介して Zalo と通信します。ローカルのデスクトップまたはターミナルで Gateway を実行する場合、Webhook はデフォルトで無効です。メッセージはクライアント側で処理され、ローカルのエージェントランタイムにマッピングされます。
Plugin は OpenClaw の状態ディレクトリ内でボットの認証情報を管理します。このディレクトリは機密情報として扱い、OpenClaw のその他の状態と同じアクセス制御およびバックアップポリシーの対象にしてください。
この Plugin のランタイムはすべて外部の @zalo-platforms/openclaw-zaloclawbot パッケージ内にあります。以下のインストールおよび設定以外の動作の詳細は Plugin のメンテナーから報告されたものであり、OpenClaw コアのソースに照らして検証されていません。
トラブルシューティング
- QR ログインのタイムアウト： セキュリティ上の理由により、ログイントークン（
zbsk）は 5 分後に期限切れになります。スキャンする前に QR コードが期限切れになった場合は、ログインコマンドを再実行して新しいコードを生成してください。 - Gateway の読み込みに失敗する： OpenClaw ホストのバージョンが
2026.4.10以上であることを確認してください。これより古いバージョンは、この ID に必要な外部 npm Plugin のインストール台帳をサポートしていません。