English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk 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 설정을 핫 리로드합니다. 파일 감시 또는 설정 리로드가 비활성화된 경우에만 다시 시작하세요.

변경 사항

messages.groupChat.unmentionedInbound: "room_event"를 사용하면 다음과 같이 동작합니다.

  • 멘션되지 않은 허용 그룹 또는 채널 메시지는 조용한 룸 이벤트가 됩니다
  • 멘션된 메시지는 사용자 요청으로 유지됩니다
  • 텍스트 명령과 네이티브 명령은 사용자 요청으로 유지됩니다
  • 중단 또는 중지 요청은 사용자 요청으로 유지됩니다
  • 직접 메시지는 사용자 요청으로 유지됩니다

룸 이벤트는 엄격한 표시 전달을 사용합니다. 최종 어시스턴트 텍스트는 비공개입니다. 에이전트가 룸에 게시하려면 message(action=send)를 호출해야 합니다.

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

하나의 채널만 앰비언트로 만들어야 할 때는 채널별 Discord 설정을 사용합니다.

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

Slack 예시

Slack 채널 허용 목록은 ID 우선입니다. #channel-name이 아니라 C12345678 같은 채널 ID를 사용하세요.

json5
{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    slack: {      groupPolicy: "allowlist",      channels: {        "<SLACK_CHANNEL_ID>": {          allow: true,          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를 검사하세요.

에이전트별 정책

여러 에이전트가 같은 룸을 공유하지만 하나의 에이전트만 멘션되지 않은 대화를 앰비언트 컨텍스트로 처리해야 할 때는 에이전트 오버라이드를 사용합니다.

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"입니다. 명시적인 메시지 도구 호출 없이 최종 어시스턴트 텍스트가 표시되도록 게시되기를 원할 때는 이 기본값을 유지하세요.

앰비언트 상시 룸에는 messages.groupChat.visibleReplies: "message_tool"가 여전히 권장됩니다. 특히 GPT 5.5처럼 최신 세대의 도구 신뢰성이 높은 모델에서 그렇습니다. 이 설정은 에이전트가 메시지 도구를 호출하여 말할 시점을 결정하게 합니다. 모델이 도구를 호출하지 않고 최종 텍스트를 반환하면 OpenClaw는 해당 최종 텍스트를 비공개로 유지하고 억제된 전달 메타데이터를 기록합니다.

다른 그룹 요청이 자동 답장을 사용하더라도 룸 이벤트는 엄격하게 유지됩니다. 멘션되지 않은 앰비언트 룸 이벤트는 표시 출력에 여전히 message(action=send)가 필요합니다.

기록

messages.groupChat.historyLimit는 전역 그룹 기록 기본값을 제어합니다. 채널은 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 scope가 있는지 확인하세요.

관련 항목

Was this useful?
On this page

On this page