OpenClawSkills
GitHub
チャンネル • 5分で読める

Zalo Personal

zca-cli（QR ログイン）で Zalo 個人アカウントに接続：機能と設定。

ステータス：実験的。この統合は zca-cli 経由で Zalo 個人アカウント を自動化します。

Tutorial.alert.info

警告：これは非公式統合であり、アカウントの制限/禁止につながる可能性があります。リスクを評価した上で自己責任で使用してください。
Tutorial.step

プラグインのインストールが必要

Zalo Personalはプラグインとして提供されており、コアインストールには含まれていません。

- CLIインストール：openclaw plugins install @openclaw/zalouser

- またはソースからチェックアウトしてインストール：openclaw plugins install ./extensions/zalouser

- Details: ''/plugin''

Tutorial.step

Prerequisite: zca-cli

Gatewayマシンは PATH で PATH バイナリを見つけられる必要があります。

- Verify: zca --version

- ない場合は、zca-cliをインストール（extensions/zalouser/README.md または上流のzca-cliドキュメントを参照）。

Tutorial.step

初心者向けクイック設定

1. プラグインをインストール（上記参照）。

2. ログイン（QRコード；Gatewayマシンで実行）：

- openclaw channels login --channel zalouser

- Zaloモバイルアプリで端末のQRコードをスキャン。

3. チャンネルを有効化：

4. Gatewayを再起動（またはオンボーディングを完了）。

5. DMはデフォルトでペアリング：最初の連絡でペアリングコードを受け取り、承認後にメッセージを処理。

Json5
{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}
Tutorial.step

これは何ですか

- zca listen を使用して受信メッセージを受信。

- zca msg ... を使用して返信を送信（テキスト/メディア/リンク）。

- Zalo Bot APIを使用できない個人アカウントシナリオ向け。

Tutorial.step

命名に関する注意

チャンネルIDは zalouser を使用し、これはZalo 個人ユーザーアカウント（非公式）を自動化していることを明示しています。zalo は将来の公式Zalo API統合のために予約されています。

Tutorial.step

IDの検索（directory）

directory CLIを使用して連絡先/グループと対応するIDを検索：

Bash
openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"
Tutorial.step

Limitations

- 送信テキストは約2000文字ごとに分割（Zaloクライアント制限）。

- ストリーミングはデフォルトで無効。

Tutorial.step

アクセス制御（DM）

channels.zalouser.dmPolicy は pairing | allowlist | open | disabled をサポート（デフォルト pairing）。

channels.zalouser.allowFrom はユーザーIDまたは名前を受け入れます。ウィザードは可能な場合、zca friend find 経由で名前をIDに解決します。

Approve:

- openclaw pairing list zalouser

- openclaw pairing approve zalouser <code>

Tutorial.step

グループアクセス（オプション）

- デフォルト：channels.zalouser.groupPolicy = "open"（グループを許可）。未設定の場合、channels.defaults.groupPolicy でデフォルトを上書き可能。

- 許可リストに制限する場合：

- channels.zalouser.groupPolicy = "allowlist"

- channels.zalouser.groups（キーはグループIDまたは名前）

- すべてのグループを無効化：channels.zalouser.groupPolicy = "disabled"。

- 設定ウィザードでグループ許可リストの入力を促すことができます。

- 起動時、OpenClawは許可リスト内のグループ/ユーザー名をベストエフォートでIDに解決し、マッピングをログに記録；失敗したエントリはそのまま残ります。

Example:

Json5
{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}
Tutorial.step

マルチアカウント

アカウントはzcaプロファイルにマップされます。例：

Json5
{
  channels: {
    zalouser: {
      enabled: true,
      defaultAccount: "default",
      accounts: {
        work: { enabled: true, profile: "work" },
      },
    },
  },
}
Tutorial.step

トラブルシューティング

zca が見つかりません：

- zca-cliをインストールし、Gatewayプロセスの PATH で見つかることを確認。

ログインが永続化されません：

- Run: openclaw channels status --probe

- 再ログイン：

openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser