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.list[].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、複数人 DM は mpim:history です。

関連項目

Was this useful?
On this page

On this page