メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

状態: 実験的。この連携は、OpenClaw 内のネイティブ zca-js を介して 個人用 Zalo アカウント を自動化します。
これは非公式の連携であり、アカウントの停止または禁止につながる可能性があります。自己責任で使用してください。

​
同梱 Plugin

Zalo Personal は現在の OpenClaw リリースに同梱 Plugin として含まれているため、通常の パッケージ化されたビルドでは別途インストールは不要です。 古いビルドを使用している場合、または Zalo Personal を除外したカスタムインストールを使用している場合は、 npm パッケージを直接インストールしてください。
  • CLI でインストール: openclaw plugins install @openclaw/zalouser
  • 固定バージョン: openclaw plugins install @openclaw/zalouser@2026.5.2
  • またはソースチェックアウトから: openclaw plugins install ./path/to/local/zalouser-plugin
  • 詳細: Plugins
外部の zca/openzca CLI バイナリは不要です。

​
クイックセットアップ（初心者向け）

  1. Zalo Personal Plugin が利用可能であることを確認します。
    • 現在のパッケージ化された OpenClaw リリースにはすでに同梱されています。
    • 古いインストールやカスタムインストールでは、上記のコマンドで手動追加できます。
  2. ログインします（QR、Gateway マシン上）:
    • openclaw channels login --channel zalouser
    • Zalo モバイルアプリで QR コードをスキャンします。
  3. チャネルを有効化します:
{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}
  1. Gateway を再起動します（またはセットアップを完了します）。
  2. DM アクセスのデフォルトはペアリングです。初回接触時にペアリングコードを承認します。

​
概要

  • zca-js を介して完全にプロセス内で実行されます。
  • ネイティブイベントリスナーを使用して受信メッセージを受け取ります。
  • JS API を通じて返信を直接送信します（テキスト/メディア/リンク）。
  • Zalo Bot API が利用できない「個人アカウント」のユースケース向けに設計されています。

​
命名

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

​
ID の検索（ディレクトリ）

ディレクトリ CLI を使用してピア/グループとその ID を検出します: 
openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"

​
制限

  • 送信テキストは約 2000 文字に分割されます（Zalo クライアントの制限）。
  • ストリーミングはデフォルトでブロックされます。

​
アクセス制御（DM）

channels.zalouser.dmPolicy は pairing | allowlist | open | disabled をサポートします（デフォルト: pairing）。 channels.zalouser.allowFrom には安定した Zalo ユーザー ID を使用してください。静的な送信者アクセスグループ（accessGroup:<name>）も参照できます。対話型セットアップ中に入力された名前は、Plugin のプロセス内連絡先検索を使用して ID に解決できます。 未加工の名前が設定に残っている場合、起動時の解決は channels.zalouser.dangerouslyAllowNameMatching: true が有効な場合にのみ行われます。このオプトインがない場合、実行時の送信者チェックは ID のみで行われ、未加工の名前は認可では無視されます。 次で承認します:
  • openclaw pairing list zalouser
  • openclaw pairing approve zalouser <code>

​
グループアクセス（任意）

  • デフォルト: channels.zalouser.groupPolicy = "open"（グループを許可）。未設定時のデフォルトを上書きするには channels.defaults.groupPolicy を使用します。
  • allowlist に制限するには:
    • channels.zalouser.groupPolicy = "allowlist"
    • channels.zalouser.groups（キーには安定したグループ ID を使用してください。名前は、channels.zalouser.dangerouslyAllowNameMatching: true が有効な場合にのみ起動時に ID へ解決されます）
    • channels.zalouser.groupAllowFrom（許可されたグループ内でどの送信者がボットをトリガーできるかを制御します。静的な送信者アクセスグループは accessGroup:<name> で参照できます）
  • すべてのグループをブロック: channels.zalouser.groupPolicy = "disabled"。
  • 設定ウィザードはグループ allowlist の入力を促すことができます。
  • 起動時、OpenClaw は channels.zalouser.dangerouslyAllowNameMatching: true が有効な場合にのみ、allowlist 内のグループ/ユーザー名を ID に解決し、そのマッピングをログに記録します。
  • グループ allowlist の照合はデフォルトで ID のみです。未解決の名前は、channels.zalouser.dangerouslyAllowNameMatching: true が有効でない限り、認証では無視されます。
  • channels.zalouser.dangerouslyAllowNameMatching: true は、変更され得る起動時の名前解決と実行時のグループ名照合を再有効化する緊急互換モードです。
  • groupAllowFrom が未設定の場合、実行時はグループ送信者チェックで allowFrom にフォールバックします。
  • 送信者チェックは通常のグループメッセージと制御コマンド（例: /new、/reset）の両方に適用されます。
例: 
{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["1471383327500481391"],
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}

​
グループメンションゲート

  • channels.zalouser.groups.<group>.requireMention は、グループ返信にメンションを必須とするかどうかを制御します。
  • 解決順序: 正確なグループ ID/名前 -> 正規化されたグループスラッグ -> * -> デフォルト（true）。
  • これは allowlist に登録されたグループとオープングループモードの両方に適用されます。
  • ボットメッセージを引用すると、グループ起動の暗黙的なメンションとして扱われます。
  • 認可済みの制御コマンド（例: /new）はメンションゲートをバイパスできます。
  • メンションが必要なためにグループメッセージがスキップされた場合、OpenClaw はそれを保留中のグループ履歴として保存し、次に処理されるグループメッセージに含めます。
  • グループ履歴の制限はデフォルトで messages.groupChat.historyLimit（フォールバック 50）です。アカウントごとに channels.zalouser.historyLimit で上書きできます。
例: 
{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "*": { allow: true, requireMention: true },
        "Work Chat": { allow: true, requireMention: false },
      },
    },
  },
}

​
マルチアカウント

アカウントは OpenClaw 状態内の zalouser プロファイルにマップされます。例: 
{
  channels: {
    zalouser: {
      enabled: true,
      defaultAccount: "default",
      accounts: {
        work: { enabled: true, profile: "work" },
      },
    },
  },
}

​
入力中表示、リアクション、配信確認

  • OpenClaw は返信をディスパッチする前に入力中イベントを送信します（ベストエフォート）。
  • メッセージリアクションアクション react は、チャネルアクション内の zalouser でサポートされています。
    • メッセージから特定のリアクション絵文字を削除するには remove: true を使用します。
    • リアクションの意味論: リアクション
  • イベントメタデータを含む受信メッセージについて、OpenClaw は配信済み + 既読確認を送信します（ベストエフォート）。

​
トラブルシューティング

ログインが保持されない:
  • openclaw channels status --probe
  • 再ログイン: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser
Allowlist/グループ名が解決されない:
  • allowFrom/groupAllowFrom では数値 ID を使用し、groups では安定したグループ ID を使用してください。完全一致の友達名/グループ名が意図的に必要な場合は、channels.zalouser.dangerouslyAllowNameMatching: true を有効にします。
古い CLI ベースのセットアップからアップグレードした場合:
  • 古い外部 zca プロセスに関する前提をすべて削除します。
  • このチャネルは現在、外部 CLI バイナリなしで OpenClaw 内で完全に実行されます。

​
関連