Ambient room events：消息从哪扇门跑进来

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Ambient room events let OpenClaw process unmentioned 大家一起的房间 or 消息通道 chatter as quiet context. The 机器人朋友 can update mem…。

Ambient room events let OpenClaw process unmentioned group or channel chatter as quiet context. The agent can update memory and session state, but the room stays silent unless the agent explicitly calls the message tool.

For always-on group chats, this is the recommended mode: combine messages.groupChat.unmentionedInbound: "room_event" with messages.groupChat.visibleReplies: "message_tool". Use it when the agent should listen, decide when a reply is useful, and avoid the old prompt pattern of answering NO_REPLY.

Supported today: Discord guild channels, Slack channels and private channels, Slack multi-person DMs, and Telegram groups or supergroups. Other group channels keep their existing group behavior unless their channel page says they support ambient room events.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Set the global 大家一起的房间-chat behavior: Then 设置说明书ure the room itself as always-on by disabling mention gating for that r…。

Set the global group-chat behavior:

{
  messages: {
    groupChat: {
      unmentionedInbound: "room_event",
      visibleReplies: "message_tool",
      historyLimit: 50,
    },
  },
}

Then configure the room itself as always-on by disabling mention gating for that room. The channel must still be allowed by its normal groupPolicy, room allowlist, and sender allowlist.

After saving the config, the Gateway hot-reloads messages settings. Restart only when file watching or config reload is disabled.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：With 小纸条消息s.大家一起的房间Chat.unmentionedInbound: "room_event": Room events use strict visible delivery. Final assistant text…。

With messages.groupChat.unmentionedInbound: "room_event":

• unmentioned allowed group or channel messages become quiet room events
• mentioned messages stay user requests
• text commands and native commands stay user requests
• abort or stop requests stay user requests
• direct messages stay user requests

Room events use strict visible delivery. Final assistant text is private. The agent must call message(action=send) to post in the room.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Use per-消息通道 Discord 设置说明书 when only one 消息通道 should be ambient:。

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

Use per-channel Discord config when only one channel should be ambient:

{
  channels: {
    discord: {
      guilds: {
        "
DISCORD_SERVER_ID
": {
          channels: {
            "
DISCORD_CHANNEL_ID_OR_NAME
": {
              allow: true,
              requireMention: false,
            },
          },
        },
      },
    },
  },
}

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Slack 消息通道 allowlists are ID-first. Use 消息通道 IDs such as C12345678, not #消息通道-name.

Slack channel allowlists are ID-first. Use channel IDs such as C12345678, not #channel-name.

{
  messages: {
    groupChat: {
      unmentionedInbound: "room_event",
      visibleReplies: "message_tool",
      historyLimit: 50,
    },
  },
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "
SLACK_CHANNEL_ID
": {
          allow: true,
          requireMention: false,
        },
      },
    },
  },
}

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：For Telegram 大家一起的房间s, the bot must be able to see normal 大家一起的房间 小纸条消息s. If requireMention: false, disable BotFather p…。

For Telegram groups, the bot must be able to see normal group messages. If requireMention: false, disable BotFather privacy mode or use another Telegram setup that delivers full group traffic to the bot.

{
  messages: {
    groupChat: {
      unmentionedInbound: "room_event",
      visibleReplies: "message_tool",
      historyLimit: 50,
    },
  },
  channels: {
    telegram: {
      groups: {
        "
TELEGRAM_GROUP_CHAT_ID
": {
          groupPolicy: "open",
          requireMention: false,
        },
      },
    },
  },
}

Telegram group IDs are usually negative numbers such as -1001234567890. Read chat.id from openclaw logs --follow, forward a group message to an ID helper bot, or inspect Bot API getUpdates.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Use an 机器人朋友 override when several 机器人朋友s share the same room but only one should treat unmentioned chatter as ambient…。

Use an agent override when several agents share the same room but only one should treat unmentioned chatter as ambient context:

{
  messages: {
    groupChat: {
      visibleReplies: "message_tool",
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          unmentionedInbound: "room_event",
          mentionPatterns: ["@openclaw", "openclaw"],
        },
      },
    ],
  },
}

The agent-specific agents.list[].groupChat.unmentionedInbound value overrides messages.groupChat.unmentionedInbound for that agent.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：小纸条消息s.大家一起的房间Chat.visibleReplies defaults to "automatic" for normal 大家一起的房间/消息通道 user requests. Keep that default when…。

messages.groupChat.visibleReplies defaults to "automatic" for normal group/channel user requests. Keep that default when you want final assistant text to post visibly without requiring an explicit message-tool call.

For ambient always-on rooms, messages.groupChat.visibleReplies: "message_tool" is still recommended, especially with latest-generation, tool-reliable models such as GPT 5.5. It lets the agent decide when to speak by calling the message tool. If the model returns final text without calling the tool, OpenClaw keeps that final text private and logs suppressed delivery metadata.

Room events stay strict even when other group requests use automatic replies. Unmentioned ambient room events still require message(action=send) for visible output.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：小纸条消息s.大家一起的房间Chat.historyLimit controls the global 大家一起的房间 history default. 消息通道s can override it with 消息通道s.<消息通道>.hi…。

messages.groupChat.historyLimit controls the global group history default. Channels can override it with channels.<channel>.historyLimit, and some channels also support per-account history limits.

Set historyLimit: 0 to disable group history context.

Supported room-event channels keep recent ambient room messages as context. Discord keeps room-event history until a visible Discord send succeeds, so quiet context is not lost before message-tool delivery.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If the room shows typing or token usage but no visible 小纸条消息: 1. Confirm the room is allowed by the 消息通道 allowlist and…。

If the room shows typing or token usage but no visible message:

1. Confirm the room is allowed by the channel allowlist and sender allowlist. 2. Confirm requireMention: false is set at the room level you expect. 3. Check whether messages.groupChat.unmentionedInbound or the agent override is "room_event". 4. Inspect logs for suppressed final payload metadata or didSendViaMessagingTool: false. 5. For normal group requests, keep or restore messages.groupChat.visibleReplies: "automatic" if you want final replies posted automatically. For ambient rooms using message_tool, use a model/runtime that reliably calls tools.

If Telegram ambient rooms do not trigger at all, check BotFather privacy mode and verify the Gateway is receiving normal group messages.

If Slack ambient rooms do not trigger, verify the channel key is the Slack channel ID and the app has the required channels:history or groups:history scope for that room type.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：---。

• Groups
• Discord
• Slack
• Telegram
• Channel troubleshooting
• Channel configuration reference

---