--- read_when: - 常時稼働のグループまたはチャンネルルームを設定する - エージェントに最終テキストを自動投稿させず、ルーム内の会話を監視させたい場合 - ルームにメッセージが表示されない場合の入力中表示とトークン使用量のデバッグ sidebarTitle: Ambient room events summary: エージェントがメッセージツールで送信しない限り、対応しているグループルームからは通知を伴わないコンテキストを提供できるようにする title: 周囲のルームイベント x-i18n: generated_at: "2026-07-26T09:52:29Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 32 provider: openai source_hash: 15c083c139058c9bd2c651794965bd8252d74691e536db2ad2a2ae0b4ac886e8 source_path: channels/ambient-room-events.md workflow: 16 --- アンビエントルームイベントを使用すると、OpenClaw はメンションのないグループまたはチャンネルの会話を静かなコンテキストとして処理できます。エージェントはメモリとセッション状態を更新できますが、エージェントが明示的に `message` ツールを呼び出さない限り、ルームには何も投稿されません。 常時稼働のグループチャットでは、`messages.groupChat.unmentionedInbound: "room_event"` と `messages.groupChat.visibleReplies: "message_tool"` を組み合わせます。エージェントは会話を聞き、返信が有用なタイミングを判断します。従来の `NO_REPLY` と回答するプロンプトパターンは不要です。 現在サポートされているのは、Discord のギルドチャンネル、Slack のチャンネルとプライベートチャンネル、Slack の複数人 DM、Telegram のグループまたはスーパーグループです。その他のグループチャンネルでは、そのチャンネルのページにアンビエントルームイベントをサポートすると記載されていない限り、既存のグループ動作が維持されます。 ## 推奨設定 グローバルなグループチャット動作を設定します。 ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, } ``` 次に、そのルームのメンションゲートを無効にして、ルームを常時稼働にします。ルームは引き続き、通常の `groupPolicy`、ルームの許可リスト、送信者の許可リストを通過する必要があります。 設定を保存すると、Gateway は `messages` の設定をホット適用します。ファイル監視または設定の再読み込みが無効な場合（`gateway.reload.mode: "off"`）にのみ再起動してください。 ## 変更される動作 `messages.groupChat.unmentionedInbound: "room_event"` の場合: - 許可されたグループまたはチャンネルでメンションのないメッセージは、静かなルームイベントになります - メンション付きメッセージは、引き続きユーザーリクエストとして扱われます - テキスト制御コマンドとネイティブコマンドは、引き続きユーザーリクエストとして扱われます - 中止または停止のリクエストは、引き続きユーザーリクエストとして扱われます - ダイレクトメッセージは、引き続きユーザーリクエストとして扱われます ルームイベントでは、可視配信が厳格に制御されます。アシスタントの最終テキストは非公開です。ルームに投稿するには、エージェントが `message(action=send)` を呼び出す必要があります。 ルームイベントでは、入力中表示とライフサイクル状態のリアクションが引き続き抑制されます。唯一の明示的な受信確認の例外は `messages.ackReactionScope: "all"` で、設定された確認リアクションを送信します。ルームを完全に無音に保つ必要がある場合は、より限定的なスコープまたは `"off"` を使用してください。 ## Discord の例 ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { discord: { groupPolicy: "allowlist", guilds: { "": { requireMention: false, users: [""], }, }, }, }, } ``` 1 つのチャンネルだけをアンビエントにする場合は、Discord のチャンネル別設定を使用します。`groupPolicy: "allowlist"` では、チャンネルを記載することで許可されます（`enabled: false` はエントリを無効にします）。 ```json5 { channels: { discord: { groupPolicy: "allowlist", guilds: { "": { channels: { "": { requireMention: false, }, }, }, }, }, }, } ``` ## Slack の例 Slack のチャンネル許可リストでは ID が優先されます。`#channel-name` ではなく、`C12345678` のようなチャンネル ID を使用してください。`channels.slack.channels` の下にチャンネルを記載することで許可されます（`enabled: false` はエントリを無効にします）。 ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { slack: { groupPolicy: "allowlist", channels: { "": { requireMention: false, }, }, }, }, } ``` ## Telegram の例 Telegram グループでは、ボットが通常のグループメッセージを参照できる必要があります。`requireMention: false` の場合は、BotFather のプライバシーモードを無効にするか、グループのすべての通信をボットに配信する別の Telegram 設定を使用してください。 ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { telegram: { groups: { "": { groupPolicy: "open", requireMention: false, }, }, }, }, } ``` Telegram のグループ ID は通常、`-1001234567890` のような負の数です。`openclaw logs --follow` から `chat.id` を読み取るか、グループメッセージを ID 確認用ボットに転送するか、Bot API の `getUpdates` を確認してください。 ## エージェント固有のポリシー 複数のエージェントが同じルームを共有しているものの、メンションのない会話をアンビエントコンテキストとして扱うエージェントを 1 つだけにする場合は、エージェントのオーバーライドを使用します。 ```json5 { messages: { groupChat: { visibleReplies: "message_tool", }, }, agents: { list: [ { id: "main", groupChat: { unmentionedInbound: "room_event", mentionPatterns: ["@openclaw", "openclaw"], }, }, ], }, } ``` エージェント固有の `agents.entries.*.groupChat.unmentionedInbound` 値は、そのエージェントについて `messages.groupChat.unmentionedInbound` をオーバーライドします。 ## 可視返信モード 通常のグループまたはチャンネルのユーザーリクエストでは、`messages.groupChat.visibleReplies` のデフォルトは `"automatic"` です。明示的なメッセージツール呼び出しなしでアシスタントの最終テキストを可視状態で投稿する場合は、このデフォルトを維持してください。 アンビエントな常時稼働ルームでは、特に GPT-5.6 Sol のような最新世代のツール使用の信頼性が高いモデルを使用する場合、引き続き `messages.groupChat.visibleReplies: "message_tool"` を推奨します。これにより、エージェントはメッセージツールを呼び出して、発言するタイミングを判断できます。モデルがツールを呼び出さずに最終テキストを返した場合、OpenClaw はその最終テキストを非公開に保ち、配信抑制のメタデータをログに記録します。 ほかのグループリクエストで自動返信を使用している場合でも、ルームイベントには厳格な制御が適用されます。メンションのないアンビエントルームイベントを可視出力するには、常に `message(action=send)` が必要です。 ## 履歴 `messages.groupChat.historyLimit` は、グローバルなグループ履歴のデフォルトを設定します（未設定の場合は 50。正の整数である必要があります）。チャンネルでは `channels..historyLimit` を使用してオーバーライドでき、一部のチャンネルではアカウント別の履歴上限もサポートされています。そのチャンネルのグループ履歴コンテキストを無効にするには、チャンネルレベルの `historyLimit: 0` を設定します。 ルームイベントをサポートするチャンネルでは、最近のアンビエントルームメッセージがコンテキストとして保持されます。Telegram は、`historyLimit` を上限とするグループ別の常時稼働ローリングウィンドウを保持します。ユーザーリクエストのターンでは、ボットが最後に記録した返信より後のエントリが選択されます。一方、ルームイベントのターンでは、モデルが自身の最近の投稿を参照できるよう、最近のウィンドウ全体が渡されます。廃止された Telegram の `includeGroupHistoryContext` モードキーは、`openclaw doctor --fix` によって削除されます。 ## トラブルシューティング ルームに入力中表示またはトークン使用量が表示されるものの、メッセージが可視状態で表示されない場合: 1. チャンネルの許可リストと送信者の許可リストで、ルームが許可されていることを確認します。 2. 想定しているルームレベルで `requireMention: false` が設定されていることを確認します。 3. `messages.groupChat.unmentionedInbound` またはエージェントのオーバーライドが `"room_event"` であるか確認します。 4. 抑制された最終ペイロードのメタデータまたは `didSendViaMessagingTool: false` がログに記録されていないか確認します。 5. 通常のグループリクエストで最終返信を自動投稿する場合は、`messages.groupChat.visibleReplies: "automatic"` を維持するか復元してください。`message_tool` を使用するアンビエントルームでは、ツールを確実に呼び出すモデルまたはランタイムを使用してください。 Telegram のアンビエントルームがまったくトリガーされない場合は、BotFather のプライバシーモードを確認し、Gateway が通常のグループメッセージを受信していることを確認してください。 Slack のアンビエントルームがトリガーされない場合は、チャンネルキーが Slack のチャンネル ID であること、およびアプリにそのルーム種別用の履歴スコープがあることを確認してください。`channels:history`（公開）、`groups:history`（プライベート）、または `mpim:history`（複数人 DM）。 ## 関連項目 - [グループ](/ja-JP/channels/groups) - [Discord](/ja-JP/channels/discord) - [Slack](/ja-JP/channels/slack) - [Telegram](/ja-JP/channels/telegram) - [チャンネルのトラブルシューティング](/ja-JP/channels/troubleshooting) - [チャンネル設定リファレンス](/ja-JP/gateway/config-channels)