グループ

OpenClaw は各サーフェスのグループチャットを一貫して扱います: Discord、iMessage、Matrix、Microsoft Teams、QQBot、Signal、Slack、Telegram、WhatsApp、Zalo。

エージェントが明示的に表示メッセージを送信しない限り静かなコンテキストを提供する常時稼働ルームについては、アンビエントルームイベントを参照してください。

初心者向け概要（2分）

OpenClaw は自分のメッセージングアカウント上に「存在」します。別個の WhatsApp ボットユーザーはありません。あなたがグループにいる場合、OpenClaw はそのグループを認識し、そこで応答できます。

デフォルトの動作:

• グループは制限されます（groupPolicy: "allowlist"）。
• メンションゲーティングを明示的に無効化しない限り、返信にはメンションが必要です。
• グループ/チャンネルでの表示返信は、デフォルトで message ツールを使用します。

つまり、許可リストに登録された送信者は、OpenClaw にメンションすることで OpenClaw をトリガーできます。

クイックフロー（グループメッセージで何が起きるか）:

groupPolicy? disabled -> dropgroupPolicy? allowlist -> group allowed? no -> droprequireMention? yes -> mentioned? no -> store for context onlymention/reply/command/DM -> user requestalways-on group chatter -> user request, or room event when configured

表示返信

通常のグループ/チャンネルリクエストでは、OpenClaw はデフォルトで messages.groupChat.visibleReplies: "automatic" を使用します。ルームを message-tool-only 出力にオプトインしない限り、最終的なアシスタントテキストはレガシーの表示返信パスを通じて投稿されます。

共有ルームで、エージェントが message(action=send) を呼び出して発言タイミングを決められるようにする場合は、messages.groupChat.visibleReplies: "message_tool" を使用します。これは GPT 5.5 のような最新世代でツール信頼性の高いモデルに支えられたグループルームで最も効果的です。モデルがそのツールを呼び損ね、内容のある最終テキストを返した場合、OpenClaw はその最終テキストをルームに投稿せず非公開のままにします。

ツールのみの配信を安定して理解できない弱いモデルやランタイムには "automatic" を使用します。automatic モードでは、エージェントの最終アシスタントテキストが表示ソース返信パスになるため、message(action=send) を一貫して呼び出せないモデルでも通常どおり回答できます。

automatic モードでは、通常のテキスト最終返信はルームに直接投稿されます。表示返信にファイル、画像、その他の添付が必要な場合、エージェントは最終テキスト返信に無理に通そうとする代わりに、その添付に message(action=send) を使用できます。

アクティブなツールポリシーで message ツールが利用できない場合、OpenClaw は応答を黙って抑制するのではなく、automatic の表示返信にフォールバックします。openclaw doctor はこの不一致について警告します。

ダイレクトチャットやその他のソースイベントでは、同じツールのみの表示返信動作をグローバルに適用するために messages.visibleReplies: "message_tool" を使用します。内部 WebChat のダイレクトターンは、Pi と Codex が同じ表示返信契約を受け取れるように、デフォルトで automatic の最終返信配信になります。表示出力に意図的に message(action=send) を要求するには、messages.visibleReplies: "message_tool" を設定します。messages.groupChat.visibleReplies は、グループ/チャンネルルーム向けのより具体的な上書きとして残ります。

これは、ほとんどの待機モードのターンでモデルに NO_REPLY と回答させる古いパターンを置き換えます。ツールのみモードでは、プロンプトは NO_REPLY 契約を定義しません。表示上何もしないことは、単に message ツールを呼び出さないことを意味します。

Plugin が所有する会話バインディングは例外です。Plugin がスレッドをバインドして受信ターンを引き受けると、Plugin が返す返信が表示バインディング応答になります。message(action=send) は不要です。その返信は Plugin ランタイム出力であり、非公開のモデル最終テキストではありません。

入力中インジケーターは、ダイレクトなグループリクエストでは引き続き送信されます。アンビエント常時稼働ルームイベントは、有効化されている場合でも、エージェントが message ツールを呼び出さない限り厳密かつ静かなままです。

セッションはデフォルトで冗長なツール/進行状況サマリーを抑制します。デバッグ中に現在のセッションでそれらのサマリーを表示するには /verbose on を使用し、最終返信のみの動作に戻すには /verbose off を使用します。同じ verbose 状態は、ダイレクトチャット、グループ、チャンネル、フォーラムトピック全体に適用されます。

メンションされていない常時稼働グループの会話をユーザーリクエストではなく静かなルームコンテキストとして送信するには、アンビエントルームイベントを使用します。

{  messages: {    groupChat: {      unmentionedInbound: "room_event",    },  },}

デフォルトは unmentionedInbound: "user_request" です。

メンションされたメッセージ、コマンド、中止リクエスト、DM はユーザーリクエストのままです。

グループ/チャンネルリクエストで表示出力を message ツール経由にするには:

{  messages: {    groupChat: {      visibleReplies: "message_tool",    },  },}

Gateway は、ファイルが保存された後に messages 設定をホットリロードします。デプロイでファイル監視または設定リロードが無効化されている場合のみ再起動してください。

すべてのソースチャットで表示出力を message ツール経由にするには:

{  messages: {    visibleReplies: "message_tool",  },}

ネイティブスラッシュコマンド（Discord、Telegram、およびネイティブコマンド対応のあるその他のサーフェス）は visibleReplies: "message_tool" を迂回し、チャンネルネイティブのコマンド UI が期待する応答を得られるよう常に表示で返信します。これは検証済みのネイティブコマンドターンにのみ適用されます。テキスト入力された /... コマンドや通常のチャットターンは、引き続き設定済みのグループデフォルトに従います。

コンテキスト可視性と許可リスト

グループの安全性には、2つの異なる制御が関係します。

• トリガー認可: 誰がエージェントをトリガーできるか（groupPolicy、groups、groupAllowFrom、チャンネル固有の許可リスト）。
• コンテキスト可視性: どの補足コンテキストがモデルに注入されるか（返信テキスト、引用、スレッド履歴、転送メタデータ）。

デフォルトでは、OpenClaw は通常のチャット動作を優先し、コンテキストをほぼ受信したまま保持します。つまり、許可リストは主に誰がアクションをトリガーできるかを決めるものであり、すべての引用や履歴スニペットに対する汎用の編集境界ではありません。

目的別設定:

再利用可能な送信者許可リストについては、アクセスグループを参照してください。

セッションキー

• グループセッションは agent:<agentId>:<channel>:group:<id> セッションキーを使用します（ルーム/チャンネルは agent:<agentId>:<channel>:channel:<id> を使用します）。
• Telegram フォーラムトピックは、各トピックが独自のセッションを持つように、グループ ID に :topic:<threadId> を追加します。
• ダイレクトチャットはメインセッション（または設定されている場合は送信者ごと）を使用します。
• Heartbeat はグループセッションではスキップされます。

パターン: 個人 DM + 公開グループ（単一エージェント）

はい。「個人」トラフィックが DM で、「公開」トラフィックが グループ であれば、これはうまく機能します。

理由: 単一エージェントモードでは、DM は通常 main セッションキー（agent:main:main）に到達します。一方、グループは常に 非 main セッションキー（agent:main:<channel>:group:<id>）を使用します。mode: "non-main" でサンドボックス化を有効にすると、それらのグループセッションは設定済みのサンドボックスバックエンドで実行され、メインの DM セッションはホスト上に残ります。バックエンドを選択しない場合、Docker がデフォルトです。

これにより、1つのエージェント「頭脳」（共有ワークスペース + メモリ）でありながら、2つの実行姿勢を持てます。

• DM: フルツール（ホスト）
• グループ: サンドボックス + 制限付きツール

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // groups/channels are non-main -> sandboxed        scope: "session", // strongest isolation (one container per group/channel)        workspaceAccess: "none",      },    },  },  tools: {    sandbox: {      tools: {        // If allow is non-empty, everything else is blocked (deny still wins).        allow: ["group:messaging", "group:sessions"],        deny: ["group:runtime", "group:fs", "group:ui", "nodes", "cron", "gateway"],      },    },  },}

{  agents: {    defaults: {      sandbox: {        mode: "non-main",        scope: "session",        workspaceAccess: "none",        docker: {          binds: [            // hostPath:containerPath:mode            "/home/user/FriendsShared:/data:ro",          ],        },      },    },  },}

関連:

• 設定キーとデフォルト: Gateway 設定
• ツールがブロックされる理由のデバッグ: Sandbox vs Tool Policy vs Elevated
• バインドマウントの詳細: サンドボックス化

表示ラベル

• UI ラベルは、利用可能な場合 displayName を使用し、<channel>:<token> としてフォーマットされます。
• #room はルーム/チャンネル用に予約されています。グループチャットは g-<slug>（小文字、スペース -> -、#@+._- は維持）を使用します。

グループポリシー

チャンネルごとにグループ/ルームメッセージの処理方法を制御します:

{  channels: {    whatsapp: {      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"      groupAllowFrom: ["+15551234567"],    },    telegram: {      groupPolicy: "disabled",      groupAllowFrom: ["123456789"], // numeric Telegram user id (wizard can resolve @username)    },    signal: {      groupPolicy: "disabled",      groupAllowFrom: ["+15551234567"],    },    imessage: {      groupPolicy: "disabled",      groupAllowFrom: ["chat_id:123"],    },    msteams: {      groupPolicy: "disabled",      groupAllowFrom: ["user@org.com"],    },    discord: {      groupPolicy: "allowlist",      guilds: {        GUILD_ID: { channels: { help: { allow: true } } },      },    },    slack: {      groupPolicy: "allowlist",      channels: { "#general": { allow: true } },    },    matrix: {      groupPolicy: "allowlist",      groupAllowFrom: ["@owner:example.org"],      groups: {        "!roomId:example.org": { enabled: true },        "#alias:example.org": { enabled: true },      },    },  },}

簡単なメンタルモデル（グループメッセージの評価順序）:

メンションゲーティング（デフォルト）

グループメッセージは、グループごとに上書きされない限りメンションが必要です。デフォルトはサブシステムごとに *.groups."*" の下にあります。

チャネルが返信メタデータをサポートしている場合、ボットメッセージへの返信は暗黙のメンションとして扱われます。引用メタデータを公開するチャネルでは、ボットメッセージの引用も暗黙のメンションとして扱われることがあります。現在の組み込みケースには、Telegram、WhatsApp、Slack、Discord、Microsoft Teams、ZaloUser が含まれます。

{  channels: {    whatsapp: {      groups: {        "*": { requireMention: true },        "123@g.us": { requireMention: false },      },    },    telegram: {      groups: {        "*": { requireMention: true },        "123456789": { requireMention: false },      },    },    imessage: {      groups: {        "*": { requireMention: true },        "123": { requireMention: false },      },    },  },  agents: {    list: [      {        id: "main",        groupChat: {          mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"],          historyLimit: 50,        },      },    ],  },}

設定済みメンションパターンのスコープ

設定済みの mentionPatterns は正規表現のフォールバックトリガーです。 プラットフォームがネイティブのボットメンションを公開しない場合、または openclaw: のようなプレーンテキストをメンションとして扱いたい場合に使用します。 ネイティブのプラットフォームメンションは別です。Discord、Slack、Telegram、Matrix、 または別のチャネルが、メッセージでボットが明示的にメンションされたことを証明できる場合、 設定済み正規表現パターンが拒否されていても、そのネイティブメンションは引き続きトリガーされます。

デフォルトでは、設定済みメンションパターンは、そのチャネルがプロバイダーと会話の事実を メンション検出に渡すすべての場所に適用されます。広範なパターンでエージェントが すべてのグループで起動しないようにするには、channels.<channel>.mentionPatterns で チャネルごとにスコープします。

正規表現メンションパターンをチャネルでデフォルト無効にし、 allowIn で特定のルームをオプトインする場合は mode: "deny" を使用します。

{  messages: {    groupChat: {      mentionPatterns: ["\\bopenclaw\\b", "\\bops bot\\b"],    },  },  channels: {    slack: {      mentionPatterns: {        mode: "deny",        allowIn: ["C0123OPS"],      },    },  },}

正規表現メンションパターンを広く適用し、ノイズの多いルームで denyIn によって 無効にする場合は、デフォルトの mode: "allow"（または mode の省略）を使用します。

{  messages: {    groupChat: {      mentionPatterns: ["\\bopenclaw\\b"],    },  },  channels: {    telegram: {      mentionPatterns: {        denyIn: ["-1001234567890", "-1001234567890:topic:42"],      },    },  },}

ポリシー解決:

現在サポートされているスコープ付き正規表現ポリシー:

そのチャネルが複数アカウントをサポートする場合、アカウントレベルのチャネル設定では channels.<channel>.accounts.<accountId>.mentionPatterns の下に同じポリシーを設定できます。 アカウントポリシーは、そのアカウントについてトップレベルのチャネルポリシーより優先されます。

グループ/チャネルのツール制限（任意）

一部のチャネル設定では、特定のグループ/ルーム/チャネル内で利用できるツールを制限できます。

• tools: グループ全体に対してツールを許可/拒否します。
• toolsBySender: グループ内で送信者ごとに上書きします。明示的なキープレフィックスを使用します: channel:<channelId>:<senderId>、id:<senderId>、e164:<phone>、username:<handle>、name:<displayName>、および "*" ワイルドカード。チャネル ID は正規の OpenClaw チャネル ID を使用します。teams などのエイリアスは msteams に正規化されます。レガシーのプレフィックスなしキーも引き続き受け入れられ、id: としてのみ一致します。

解決順序（最も具体的なものが優先）:

例（Telegram）:

{  channels: {    telegram: {      groups: {        "*": { tools: { deny: ["exec"] } },        "-1001234567890": {          tools: { deny: ["exec", "read", "write"] },          toolsBySender: {            "id:123456789": { alsoAllow: ["exec"] },          },        },      },    },  },}

グループ許可リスト

channels.whatsapp.groups、channels.telegram.groups、または channels.imessage.groups が設定されている場合、キーはグループ許可リストとして機能します。デフォルトのメンション動作を設定しながらすべてのグループを許可するには、"*" を使用します。

一般的な意図（コピー/ペースト）:

{  channels: { whatsapp: { groupPolicy: "disabled" } },}

{  channels: {    whatsapp: {      groups: {        "123@g.us": { requireMention: true },        "456@g.us": { requireMention: false },      },    },  },}

{  channels: {    whatsapp: {      groups: { "*": { requireMention: true } },    },  },}

{  channels: {    whatsapp: {      groupPolicy: "allowlist",      groupAllowFrom: ["+15551234567"],      groups: { "*": { requireMention: true } },    },  },}

有効化（所有者のみ）

グループ所有者はグループごとの有効化を切り替えられます。

• /activation mention
• /activation always

所有者は channels.whatsapp.allowFrom（未設定の場合はボット自身の E.164）によって決まります。コマンドは単独のメッセージとして送信してください。他のサーフェスは現在 /activation を無視します。

コンテキストフィールド

グループ受信ペイロードは次を設定します。

• ChatType=group
• GroupSubject（既知の場合）
• GroupMembers（既知の場合）
• WasMentioned（メンションゲートの結果）
• Telegram フォーラムトピックには MessageThreadId と IsForum も含まれます。

エージェントシステムプロンプトには、新しいグループセッションの最初のターンでグループ紹介が含まれます。これはモデルに、人間のように応答し、空行を最小限にし、通常のチャット間隔に従い、リテラルの \n シーケンスを入力しないよう促します。Telegram 以外のグループでは Markdown テーブルも推奨されません。Telegram のリッチテキストガイダンスは Telegram チャネルプロンプトから来ます。チャネル由来のグループ名と参加者ラベルは、インラインのシステム指示ではなく、フェンスされた信頼できないメタデータとしてレンダリングされます。

iMessage 固有事項

• ルーティングまたは許可リスト登録では chat_id:<id> を優先してください。
• チャット一覧: imsg chats --limit 20。
• グループ返信は常に同じ chat_id に返されます。

WhatsApp システムプロンプト

グループおよび直接プロンプトの解決、ワイルドカード動作、アカウントオーバーライドのセマンティクスを含む、正準の WhatsApp システムプロンプトルールについては WhatsApp を参照してください。

WhatsApp 固有事項

WhatsApp 専用の動作（履歴注入、メンション処理の詳細）については グループメッセージ を参照してください。

関連

• ブロードキャストグループ
• チャネルルーティング
• グループメッセージ
• ペアリング