OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Configuration

周囲のルームイベント

アンビエントルームイベントを使用すると、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: {        "<DISCORD_SERVER_ID>": {          requireMention: false,          users: ["<YOUR_DISCORD_USER_ID>"],        },      },    },  },}

1 つのチャンネルだけをアンビエントにする場合は、Discord のチャンネル別設定を使用します。groupPolicy: "allowlist" では、チャンネルを記載することで許可されます（enabled: false はエントリを無効にします）。

json5
{  channels: {    discord: {      groupPolicy: "allowlist",      guilds: {        "<DISCORD_SERVER_ID>": {          channels: {            "<DISCORD_CHANNEL_ID_OR_NAME>": {              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: {        "<SLACK_CHANNEL_ID>": {          requireMention: false,        },      },    },  },}

Telegram の例

Telegram グループでは、ボットが通常のグループメッセージを参照できる必要があります。requireMention: false の場合は、BotFather のプライバシーモードを無効にするか、グループのすべての通信をボットに配信する別の Telegram 設定を使用してください。

json5
{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    telegram: {      groups: {        "<TELEGRAM_GROUP_CHAT_ID>": {          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.<channel>.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）。

関連項目

Was this useful?
On this page

On this page