OpenClaw

OpenClaw Zalo Personal チャンネル

メッセージング
普通

非公式の zca-cli ツールを使用して、OpenClaw を個人の Zalo アカウントに接続します。Zalo Bot Platform 統合とは異なり、このチャネルでは AI アシスタントが実際の Zalo 個人アカウントを通じて動作します — グループチャット、メディア、フレンドリストをサポート。QR コードをスキャンして認証するだけで、新しいデバイスをリンクするのと同じように簡単です。

基本情報
難易度普通
カテゴリメッセージング
対応機能数3 / 6

Zalo Personal 対応機能

テキストメッセージ

対応

メディア・ファイル

対応

リアクション

非対応

スレッド

非対応

音声メッセージ

非対応

グループチャット

対応

Zalo Personal 前提条件

  • Zalo 個人アカウント（標準アカウント、Official Account ではない）
  • zca バイナリがインストールされ、システム PATH で利用可能であること
  • OpenClaw Gateway が実行中で設定済みであること
  • ログイン時の QR コードスキャン用の Zalo モバイルアプリ

Zalo Personal クイックセットアップ

1

zalouser プラグインと zca-cli をインストール

'openclaw plugins install @openclaw/zalouser' で OpenClaw プラグインをインストールします。次に zca-cli ツールをインストールし、PATH に含まれることを確認します。'zca --version' で検証してください。

2

QR コードでログイン

'openclaw channels login --channel zalouser' を実行してターミナルに QR コードを表示します。スマートフォンで Zalo アプリを開き、QR コードをスキャンして認証を完了します。

3

設定してチャットを開始

zalouser チャネル設定を ~/.openclaw/openclaw.json に追加し、dmPolicy と groupPolicy を設定します。'openclaw start' で Gateway を起動し、Zalo アカウントにメッセージを送信してテストします。

Zalo Personal 設定例

config.json
{
  "channels": {
    "zalouser": {
      "enabled": true,
      "dmPolicy": "pairing",
      "groupPolicy": "open"
    }
  }
}

Zalo Personal 詳細ドキュメント

アーキテクチャ概要

OpenClaw は zca-cli ツールを通じて Zalo に接続します — これは Zalo 個人アカウント用の非公式コマンドラインクライアントです。Zalo Bot Platform 統合（HTTP API を使用）とは異なり、このチャネルは zca バイナリを使用してインバウンドメッセージをリッスンし、アウトバウンドの返信を送信します。 Gateway はバックグラウンドで 'zca listen' プロセスを実行してリアルタイムでメッセージを受信し、'zca msg' を使用して返信を送信します。このアプローチは完全にローカルで動作します — パブリック URL、Webhook、HTTPS 証明書は不要です。 個人アカウントを使用するため、Bot はグループチャットに参加し、フレンドリストにアクセスし、メディアを送信できます — 公式 Bot Platform では利用できない機能です。
これは非公式の統合です。使用するとアカウントの停止や BAN のリスクがあります。メインの個人アカウントではなく、専用アカウントを使用してください。
zca-cli ツールはプロトコル層を処理します。Zalo サービスとの互換性を維持するために最新版に保ってください。
これは非公式ツールを使用した実験的な統合です。Zalo はサードパーティの自動化を使用するアカウントを停止または BAN する可能性があります。自己責任でご利用ください。

zca-cli のインストール

zca-cli バイナリはこのチャネルの前提条件です。Gateway が Zalo Personal チャネルを使用するには、インストールされてシステム PATH でアクセス可能である必要があります。 インストール後、ターミナルで 'zca --version' を実行して正常に動作することを確認してください。コマンドが見つからない場合は、PATH の設定を確認するか再インストールしてください。
terminal
zca --version
zca がインストールされているが PATH にない場合は、シェルプロファイル（~/.bashrc、~/.zshrc など）でそのディレクトリを PATH に追加できます。

QR コード認証

認証は Zalo モバイルアプリで QR コードをスキャンして行います — 新しいデバイスをリンクする方法と同様です。API トークンや Bot トークンは不要です。 ログインコマンドを実行してターミナルに QR コードを表示します。スマートフォンで Zalo を開き、QR スキャナーに移動してコードをスキャンします。セッションが確立され、認証情報がローカルに保存されます。 再起動後にログインが持続しない場合は、ログアウトして再ログインしてセッションをリフレッシュしてください。
terminal
# ログイン
openclaw channels login --channel zalouser

# ログインが持続しない場合、再認証
openclaw channels logout --channel zalouser
openclaw channels login --channel zalouser
QR コードスキャン中はスマートフォンをインターネットに接続したままにしてください。セッションは Zalo のサーバーを通じて検証されます。

DM ポリシー

DM（ダイレクトメッセージ）ポリシーは、プライベートメッセージで AI アシスタントとやり取りできるユーザーを制御します。OpenClaw は 4 つのポリシーをサポートしています： • pairing（デフォルト）— 新しい連絡先が初めてメッセージを送信するとペアリングコードを受け取ります。'openclaw pairing approve zalouser <code>' で承認します。コードは 1 時間後に期限切れになります。 • allowlist — allowFrom リストにあるユーザー ID または名前のみが Bot とやり取りできます。名前は 'zca friend find' で ID に解決されます。 • open — アカウントにメッセージを送信した誰もが応答を受け取ります。 • disabled — DM 処理を完全に無効にします。
openclaw.json
{
  "channels": {
    "zalouser": {
      "dmPolicy": "allowlist",
      "allowFrom": ["123456789", "友達の名前"]
    }
  }
}
'open' ポリシーは誰でも個人アカウントとやり取りできるようにします。これは連絡先に見える実際の Zalo アカウントなので、注意して使用してください。

グループチャット管理

Zalo Bot Platform 統合とは異なり、Zalo Personal はグループチャットを完全にサポートしています。デフォルトでは groupPolicy は 'open' に設定されており、Bot はすべてのグループ会話で応答します。 'allowlist' ポリシーと groups マッピングを使用してグループアクセスを制限できます。グループは数値 ID または名前で参照できます。 groupPolicy を 'disabled' に設定すると、すべてのグループメッセージを完全に無視します。
openclaw.json
{
  "channels": {
    "zalouser": {
      "groupPolicy": "allowlist",
      "groups": {
        "123456789": { "allow": true },
        "仕事チャット": { "allow": true }
      }
    }
  }
}
'openclaw directory groups list --channel zalouser --query "名前"' を使用してグループ ID と名前を検索できます。
グループ名は大文字と小文字を区別します。Zalo アプリに表示される正確な名前を使用してください。

メッセージ処理

OpenClaw は Zalo Personal を通じてテキストメッセージ、画像、ファイル、リンクの送信をサポートしています。テキストメッセージは Zalo のクライアント制限に従い、約 2,000 文字で自動的に分割されます。 連絡先やグループからのインバウンドメッセージは 'zca listen' プロセスで受信され、AI に転送されます。アウトバウンドの返信は 'zca msg' を使用して送信されます。 文字数制限のため、ストリーミング応答はデフォルトでブロックされています。
長い AI 応答は約 2,000 文字の境界で自動的に複数のメッセージに分割されます。
メディア送信機能はインストールされている zca-cli のバージョンに依存します。最高の互換性のために最新版に保ってください。

マルチアカウント設定

OpenClaw は異なる zca プロファイルにマッピングすることで、複数の Zalo 個人アカウントの同時実行をサポートしています。各アカウントには独自のプロファイル名、DM ポリシー、グループ設定があります。 異なる目的（例：仕事用アカウントと個人用アカウント）で別々の AI アシスタントを運用したい場合に便利です。
openclaw.json
{
  "channels": {
    "zalouser": {
      "enabled": true,
      "defaultAccount": "default",
      "accounts": {
        "work": {
          "enabled": true,
          "profile": "work"
        },
        "personal": {
          "enabled": true,
          "profile": "personal"
        }
      }
    }
  }
}

ディレクトリとディスカバリー

Zalo Personal チャネルは、アカウント上の友達やグループを発見するためのディレクトリコマンドを提供します。これらはアローリスト用のユーザー ID やグループポリシー用のグループ ID を検索するのに便利です。 自分のプロフィールの表示、名前による友達検索、名前によるグループ検索がすべてコマンドラインから行えます。
terminal
# プロフィールを表示
openclaw directory self --channel zalouser

# 友達を検索
openclaw directory peers list --channel zalouser --query "名前"

# グループを検索
openclaw directory groups list --channel zalouser --query "仕事"

Zalo Personal 設定リファレンス

enabled
Type: booleanDefault: false

Zalo Personal チャネルを有効または無効にする

dmPolicy
Type: stringDefault: "pairing"

Bot に DM できるユーザーを制御。オプション：pairing、allowlist、open、disabled

allowFrom
Type: string[]Default: []

Bot とやり取りを許可するユーザー ID または名前のリスト（dmPolicy が allowlist の場合）

groupPolicy
Type: stringDefault: "open"

グループチャットの動作を制御。オプション：open、allowlist、disabled

groups
Type: objectDefault: {}

グループ ID または名前から権限オブジェクトへのマップ（groupPolicy が allowlist の場合）

defaultAccount
Type: stringDefault: "default"

使用するデフォルトの zca プロファイル名

accounts.<id>.enabled
Type: booleanDefault: true

マルチアカウントモードで特定のアカウントを有効または無効にする

accounts.<id>.profile
Type: stringDefault: ""

特定アカウントの zca プロファイル名

Zalo Personal よくある質問

Zalo Personal トラブルシューティング

zca コマンドが見つからない

zca-cli バイナリがインストールされていないか、システム PATH にありません。

zca-cli をインストールし、PATH に含まれることを確認してください。'zca --version' で検証します。インストール済みだが見つからない場合は、~/.bashrc または ~/.zshrc でインストールディレクトリを PATH に追加してください。
QR コードログインが失敗するかセッションが持続しない

Zalo セッションが期限切れになったか、初期認証が完了していない可能性があります。

ログアウトして再ログインしてみてください：'openclaw channels logout --channel zalouser' の後 'openclaw channels login --channel zalouser'。QR スキャン中にスマートフォンのインターネット接続が安定していることを確認してください。
Bot がグループメッセージに応答しない

groupPolicy が 'disabled' に設定されているか、'allowlist' に設定されているがグループがリストに含まれていない可能性があります。

groupPolicy の設定を確認してください。'allowlist' を使用している場合は、グループ ID または名前が groups 設定にリストされていることを確認します。'openclaw directory groups list --channel zalouser' を使用して正しいグループ ID を確認してください。
メッセージが受信されない

zca listen プロセスが実行されていないか、セッションが期限切れになっている可能性があります。

'openclaw channels status --probe' を実行して接続を診断します。セッションが期限切れの場合は、QR コードログインで再認証してください。Gateway ログで具体的なエラーメッセージを確認してください。
アカウントが停止または BAN された

Zalo がアカウント上の非公式な自動化を検出しました。

これは非公式統合を使用する際の既知のリスクです。Zalo サポートに連絡してアカウントの復旧を試みてください。グループチャットはサポートされませんが BAN のリスクがない、公式の Zalo Bot Platform 統合（zalo チャネル）への切り替えを検討してください。
完全なドキュメントを見るすべてのチャンネルに戻る

関連チャンネル

WhatsApp

Medium

OpenClaw を Baileys プロトコルでQRコード接続

セットアップガイド

Telegram

Easy

OpenClaw の grammY フレームワーク経由Bot API連携

セットアップガイド

Discord

Easy

OpenClaw の discord.js Bot Token連携

セットアップガイド