グループ

OpenClaw は、Discord、iMessage、Matrix、Microsoft Teams、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 onlyotherwise -> reply

表示される返信

グループ/チャンネルのルームでは、OpenClaw のデフォルトは messages.groupChat.visibleReplies: "message_tool" です。 openclaw doctor --fix は、これを省略している設定済みチャンネルの設定にこのデフォルトを書き込みます。 つまり、エージェントはターンを処理し、メモリ/セッション状態を更新できますが、通常の最終回答はルームへ自動的には投稿されません。見える形で発言するには、エージェントは message(action=send) を使います。

このデフォルトは、ツールを確実に呼び出すモデル/ランタイムに依存します。ログに assistant テキストが表示されているのに didSendViaMessagingTool: false の場合、モデルはメッセージツールを呼び出す代わりに非公開で回答しています。これは Discord/Slack/Telegram の送信失敗ではありません。グループ/チャンネルセッションにはツール呼び出しの信頼性が高いモデルを使うか、messages.groupChat.visibleReplies: "automatic" を設定して、従来の表示される最終返信を復元してください。

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

直接チャットとその他すべてのソースターンでは、messages.visibleReplies: "message_tool" を使うと、同じツール専用の表示返信動作をグローバルに適用できます。ハーネスも、これを未設定時のデフォルトとして選択できます。Codex ハーネスは Codex モードの直接チャットでこれを行います。messages.groupChat.visibleReplies は、グループ/チャンネルのルーム向けの、より具体的な上書きとして残ります。

これは、ほとんどの待機モードのターンでモデルに NO_REPLY と回答させる古いパターンを置き換えます。ツール専用モードでは、見える出力を何もしないとは、単にメッセージツールを呼び出さないことを意味します。

ツール専用モードでも、エージェントの作業中は入力中インジケーターが送信されます。これらのターンでは、エージェントがメッセージツールを呼び出すかどうかを決める前に通常の assistant メッセージテキストが存在しない可能性があるため、デフォルトのグループ入力モードは "message" から "instant" にアップグレードされます。明示的な入力モード設定は引き続き優先されます。

グループ/チャンネルのルームで従来の自動最終返信を復元するには:

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

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

すべてのソースチャットで、表示される出力をメッセージツール経由に要求するには:

{  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> を追加します。
• 直接チャットはメインセッション（または設定されている場合は送信者ごと）を使います。
• Heartbeats はグループセッションではスキップされます。

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

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

理由: 単一エージェントモードでは、DM は通常 メイン セッションキー（agent: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 設定
• ツールがブロックされる理由のデバッグ: サンドボックス vs ツールポリシー vs 昇格
• バインドマウントの詳細: サンドボックス化

表示ラベル

• 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: ["[email protected]"],    },    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 },        "[email protected]": { 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,        },      },    ],  },}

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

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

• 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"] },          },        },      },    },  },}

グループ allowlist

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

一般的な意図（コピー/貼り付け）:

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

{  channels: {    whatsapp: {      groups: {        "[email protected]": { requireMention: true },        "[email protected]": { 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 も含まれます。

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

iMessage 固有事項

• ルーティングまたは allowlist では chat_id:<id> を推奨します。
• チャット一覧: imsg chats --limit 20。
• グループ返信は常に同じ chat_id に返されます。

WhatsApp システムプロンプト

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

WhatsApp 固有事項

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

関連

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