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