구성 — 채널

channels.* 아래의 채널별 구성 키: DM 및 그룹 액세스, 다중 계정 설정, 멘션 게이팅, Slack, Discord, Telegram, WhatsApp, Matrix, iMessage 및 기타 채널 Plugin용 채널별 키.

에이전트, 도구, Gateway 런타임 및 기타 최상위 키는 구성 참조를 참조하십시오.

채널

각 채널은 해당 구성 섹션이 존재하면 자동으로 시작됩니다(enabled: false인 경우 제외). Telegram과 iMessage는 핵심 openclaw 패키지에 포함되어 제공됩니다. 그 외 공식 채널(Discord, Slack, WhatsApp, Matrix, Microsoft Teams, IRC, Google Chat, Signal, Mattermost 등)은 openclaw plugins install <spec>을 사용하여 별도의 Plugin으로 설치합니다. 전체 목록과 설치 사양은 채널을 참조하십시오.

DM 및 그룹 액세스

모든 채널은 DM 정책과 그룹 정책을 지원합니다.

채널 모델 재정의

channels.modelByChannel을 사용하여 특정 채널 ID 또는 다이렉트 메시지 상대를 모델에 고정합니다. 값에는 provider/model 또는 구성된 모델 별칭을 사용할 수 있습니다. 채널 매핑은 세션에 활성 모델 재정의가 아직 없는 경우에만 적용됩니다(예: /model을 통해 설정된 재정의).

그룹/스레드 대화의 키는 채널별 그룹 ID, 토픽 ID 또는 채널 이름입니다. 다이렉트 메시지(DM) 대화의 키는 채널의 발신자 신원에서 파생된 상대 식별자입니다(nativeDirectUserId, origin.from, origin.to, OriginatingTo, From 또는 SenderId). 정확한 키 형식은 채널에 따라 다릅니다.

{  channels: {    modelByChannel: {      discord: {        "123456789012345678": "anthropic/claude-opus-4-6",      },      slack: {        C1234567890: "openai/gpt-5.6-sol",        "user:U12345": "openai/gpt-5.4-mini",      },      telegram: {        "-1001234567890": "openai/gpt-5.4-mini",        "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",        "123456789": "openai/gpt-4.1",      },    },  },}

DM 전용 키는 다이렉트 메시지 대화에서만 일치하며 그룹/스레드 라우팅에는 영향을 주지 않습니다.

채널 기본값 및 Heartbeat

channels.defaults을 사용하여 제공자 전반에 공유되는 그룹 정책 및 Heartbeat 동작을 설정합니다.

{  channels: {    defaults: {      groupPolicy: "allowlist", // open | allowlist | disabled      contextVisibility: "all", // all | allowlist | allowlist_quote      heartbeat: {        showOk: false,        showAlerts: true,        useIndicator: true,      },    },  },}

• channels.defaults.groupPolicy: 제공자 수준의 groupPolicy이 설정되지 않은 경우 사용할 대체 그룹 정책입니다.
• channels.defaults.contextVisibility: 모든 채널의 기본 보충 컨텍스트 표시 모드입니다. 값: all(기본값, 인용/스레드/기록 컨텍스트를 모두 포함), allowlist(허용 목록에 있는 발신자의 컨텍스트만 포함), allowlist_quote(허용 목록과 동일하지만 명시적인 인용/답장 컨텍스트는 유지). 채널별 재정의: channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk: 정상 채널 상태를 Heartbeat 출력에 포함합니다(기본값 false).
• channels.defaults.heartbeat.showAlerts: 성능 저하/오류 상태를 Heartbeat 출력에 포함합니다(기본값 true).
• channels.defaults.heartbeat.useIndicator: 간결한 표시기 형식으로 Heartbeat 출력을 렌더링합니다(기본값 true).

WhatsApp

WhatsApp은 Gateway의 웹 채널(Baileys Web)을 통해 실행됩니다. 연결된 세션이 있으면 자동으로 시작됩니다.

{  web: {    enabled: true,    heartbeatSeconds: 60,    whatsapp: {      keepAliveIntervalMs: 25000,      connectTimeoutMs: 60000,      defaultQueryTimeoutMs: 60000,    },    reconnect: {      initialMs: 2000,      maxMs: 30000,      factor: 1.8,      jitter: 0.25,      maxAttempts: 12, // 0 = 무한 재시도    },  },  channels: {    whatsapp: {      dmPolicy: "pairing", // pairing | allowlist | open | disabled      allowFrom: ["+15555550123", "+447700900123"],      textChunkLimit: 4000,      streaming: { chunkMode: "length" }, // length | newline      mediaMaxMb: 50,      sendReadReceipts: true, // 파란색 체크 표시(자기 자신과의 채팅 모드에서는 false)      groups: {        "*": { requireMention: true },      },      groupPolicy: "allowlist",      groupAllowFrom: ["+15551234567"],    },  },}

• web.whatsapp.keepAliveIntervalMs(기본값 25000), connectTimeoutMs(기본값 60000) 및 defaultQueryTimeoutMs(기본값 60000)은 Baileys 소켓을 조정합니다.
• web.reconnect 기본값: initialMs: 2000, maxMs: 30000, factor: 1.8, jitter: 0.25, maxAttempts: 12. maxAttempts: 0은 포기하지 않고 무한히 재시도합니다.
• type: "acp"이 포함된 최상위 bindings[] 항목은 WhatsApp DM 및 그룹의 영구 ACP 바인딩을 구성합니다. match.peer.id에는 E.164 형식의 다이렉트 번호 또는 WhatsApp 그룹 JID를 사용하십시오. 필드 의미는 ACP 에이전트에서 공통으로 설명합니다.

{channels: {  whatsapp: {    accounts: {      default: {},      personal: {},      biz: {        // authDir: "~/.openclaw/credentials/whatsapp/biz",      },    },  },},}

Telegram

{  channels: {    telegram: {      enabled: true,      botToken: "your-bot-token",      dmPolicy: "pairing",      allowFrom: ["tg:123456789"],      groups: {        "*": { requireMention: true },        "-1001234567890": {          allowFrom: ["@admin"],          systemPrompt: "답변을 간결하게 유지하십시오.",          topics: {            "99": {              requireMention: false,              skills: ["search"],              systemPrompt: "주제에서 벗어나지 마십시오.",            },          },        },      },      customCommands: [        { command: "backup", description: "Git 백업" },        { command: "generate", description: "이미지 생성" },      ],      historyLimit: 50,      replyToMode: "first", // off | first | all | batched      linkPreview: true,      streaming: { mode: "partial" }, // off | partial | block | progress (기본값: partial)      actions: { reactions: true, sendMessage: true },      reactionNotifications: "own", // off | own | all      mediaMaxMb: 100,      retry: {        attempts: 3,        minDelayMs: 400,        maxDelayMs: 30000,        jitter: 0.1,      },      network: {        autoSelectFamily: true,        dnsResultOrder: "ipv4first",      },      apiRoot: "https://api.telegram.org",      trustedLocalFileRoots: ["/srv/telegram-bot-api-data"],      proxy: "socks5://localhost:9050",      webhookUrl: "https://example.com/telegram-webhook",      webhookSecret: "secret",      webhookPath: "/telegram-webhook",    },  },}

• 봇 토큰: channels.telegram.botToken 또는 channels.telegram.tokenFile(일반 파일만 허용, 심볼릭 링크는 거부됨), 기본 계정의 대체값으로 TELEGRAM_BOT_TOKEN을 사용합니다.
• apiRoot은 Telegram Bot API 루트만을 의미합니다. https://api.telegram.org/bot<TOKEN>이 아니라 https://api.telegram.org 또는 자체 호스팅/프록시 루트를 사용하십시오. openclaw doctor --fix은 실수로 추가된 후행 /bot<TOKEN> 접미사를 제거합니다.
• --local 모드의 자체 호스팅 Bot API 서버에서는 trustedLocalFileRoots에 OpenClaw가 읽을 수 있는 호스트 경로를 나열합니다. 서버 데이터 볼륨을 OpenClaw 호스트에 마운트하고 해당 데이터 루트 또는 토큰별 디렉터리를 구성하십시오. /var/lib/telegram-bot-api 아래의 컨테이너 경로는 이러한 루트에 매핑됩니다. 그 외 절대 경로는 계속 거부됩니다.
• 선택적 channels.telegram.defaultAccount이 구성된 계정 ID와 일치하면 기본 계정 선택을 재정의합니다.
• 다중 계정 설정(계정 ID 2개 이상)에서는 대체 라우팅을 방지하기 위해 명시적 기본값(channels.telegram.defaultAccount 또는 channels.telegram.accounts.default)을 설정하십시오. 이 값이 누락되거나 유효하지 않으면 openclaw doctor이 경고합니다.
• configWrites: false은 Telegram에서 시작된 구성 쓰기(슈퍼그룹 ID 마이그레이션, /config set|unset)를 차단합니다.
• type: "acp"이 포함된 최상위 bindings[] 항목은 포럼 토픽의 영구 ACP 바인딩을 구성합니다(match.peer.id에서 정규 chatId:topic:topicId 사용). 필드 의미는 ACP 에이전트에서 공통으로 설명합니다.
• Telegram 스트림 미리보기는 sendMessage + editMessageText을 사용합니다(다이렉트 및 그룹 채팅에서 작동).
• network.dnsResultOrder은 일반적인 IPv6 가져오기 실패를 방지하기 위해 기본적으로 "ipv4first"로 설정됩니다.
• 재시도 정책: 재시도 정책을 참조하십시오.

Discord

{  channels: {    discord: {      enabled: true,      token: "your-bot-token",      mediaMaxMb: 100,      allowBots: false,      actions: {        reactions: true,        stickers: true,        polls: true,        permissions: true,        messages: true,        threads: true,        pins: true,        search: true,        memberInfo: true,        roleInfo: true,        roles: false,        channelInfo: true,        voiceStatus: true,        events: true,        moderation: false,      },      replyToMode: "off", // off | first | all | batched      dmPolicy: "pairing",      allowFrom: ["1234567890", "123456789012345678"],      dm: { enabled: true, groupEnabled: false, groupChannels: ["openclaw-dm"] },      guilds: {        "123456789012345678": {          slug: "friends-of-openclaw",          requireMention: false,          ignoreOtherMentions: true,          reactionNotifications: "own",          users: ["987654321098765432"],          channels: {            general: { allow: true },            help: {              allow: true,              requireMention: true,              users: ["987654321098765432"],              skills: ["docs"],              systemPrompt: "Short answers only.",            },          },        },      },      historyLimit: 20,      textChunkLimit: 2000,      suppressEmbeds: true,      streaming: {        mode: "progress", // off | partial | block | progress (Discord default: progress)        chunkMode: "length", // length | newline        progress: {          label: "auto",          maxLines: 8,          maxLineChars: 120,          toolProgress: true,        },      },      maxLinesPerMessage: 17,      ui: {        components: {          accentColor: "#5865F2",        },      },      threadBindings: {        enabled: true,        idleHours: 24,        maxAgeHours: 0,        spawnSessions: true,        defaultSpawnContext: "fork",      },      voice: {        enabled: true,        autoJoin: [          {            guildId: "123456789012345678",            channelId: "234567890123456789",          },        ],        daveEncryption: true,        decryptionFailureTolerance: 24,        connectTimeoutMs: 30000,        reconnectGraceMs: 15000,        tts: {          provider: "openai",          openai: { voice: "alloy" },        },      },      execApprovals: {        enabled: "auto", // true | false | "auto"        approvers: ["987654321098765432"],        agentFilter: ["default"],        sessionFilter: ["discord:"],        target: "dm", // dm | channel | both        cleanupAfterResolve: false,      },      retry: {        attempts: 3,        minDelayMs: 500,        maxDelayMs: 30000,        jitter: 0.1,      },    },  },}

• 토큰: channels.discord.token, 기본 계정의 대체 값으로 DISCORD_BOT_TOKEN을 사용합니다.
• 명시적인 Discord token을 제공하는 직접 아웃바운드 호출은 해당 호출에 그 토큰을 사용하며, 계정 재시도/정책 설정은 계속 활성 런타임 스냅샷에서 선택된 계정으로부터 가져옵니다.
• 선택적 channels.discord.defaultAccount은 구성된 계정 ID와 일치할 때 기본 계정 선택을 재정의합니다.
• 전달 대상에는 user:<id>(DM) 또는 channel:<id>(길드 채널)을 사용하십시오. 숫자로만 된 ID는 거부됩니다.
• 길드 슬러그는 소문자이며 공백은 -으로 대체됩니다. 채널 키는 슬러그로 변환된 이름을 사용합니다(# 없음). 길드 ID를 사용하는 것이 좋습니다.
• 봇이 작성한 메시지는 기본적으로 무시됩니다. allowBots: true을 사용하면 이를 활성화할 수 있습니다. 봇을 멘션하는 봇 메시지만 수락하려면 allowBots: "mentions"을 사용하십시오(자체 메시지는 계속 필터링됩니다).
• 봇이 작성한 인바운드 메시지를 지원하는 채널은 공유 봇 루프 보호를 사용할 수 있습니다. 기본 쌍 예산에는 channels.defaults.botLoopProtection을 설정한 다음, 특정 표면에 다른 제한이 필요한 경우에만 채널 또는 계정에서 재정의하십시오.
• channels.discord.guilds.<id>.ignoreOtherMentions(및 채널 재정의)은 다른 사용자나 역할을 멘션하지만 봇은 멘션하지 않는 메시지를 제외합니다(@everyone/@here 제외).
• channels.discord.mentionAliases은 전송 전에 안정적인 아웃바운드 @handle 텍스트를 Discord 사용자 ID에 매핑하므로, 일시적인 디렉터리 캐시가 비어 있어도 알려진 팀원을 결정론적으로 멘션할 수 있습니다. 계정별 재정의는 channels.discord.accounts.<accountId>.mentionAliases 아래에 있습니다.
• maxLinesPerMessage(기본값 17)은 2000자 미만이어도 세로로 긴 메시지를 분할합니다.
• channels.discord.suppressEmbeds의 기본값은 true이므로, 비활성화하지 않는 한 아웃바운드 URL이 Discord 링크 미리 보기로 확장되지 않습니다. 명시적인 embeds 페이로드는 계속 정상적으로 전송되며, 메시지별 도구 호출에서 suppressEmbeds으로 재정의할 수 있습니다.
• channels.discord.threadBindings은 Discord 스레드 바인딩 라우팅을 제어합니다.
  • enabled: 스레드 바인딩 세션 기능에 대한 Discord 재정의(/focus, /unfocus, /agents, /session idle, /session max-age, 바인딩된 전달/라우팅)
  • idleHours: 비활성 상태 자동 포커스 해제 시간에 대한 Discord 재정의(0은 비활성화)
  • maxAgeHours: 최대 사용 기간(시간)에 대한 Discord 재정의(0은 비활성화)
  • spawnSessions: sessions_spawn({ thread: true }) 및 ACP 스레드 생성 시 자동 스레드 생성/바인딩을 위한 스위치(기본값: true)
  • defaultSpawnContext: 스레드 바인딩 생성의 네이티브 하위 에이전트 컨텍스트(기본값 "fork")
• type: "acp"이 있는 최상위 bindings[] 항목은 채널과 스레드의 영구 ACP 바인딩을 구성합니다(match.peer.id에는 채널/스레드 ID 사용). 필드 의미 체계는 ACP 에이전트에서 공유됩니다.
• channels.discord.ui.components.accentColor은 Discord 컴포넌트 v2 컨테이너의 강조 색상을 설정합니다.
• channels.discord.agentComponents.ttlMs은 전송된 Discord 컴포넌트 콜백이 등록 상태로 유지되는 시간을 제어합니다. 기본값은 1800000(30분), 최댓값은 86400000(24시간)입니다. 계정별 재정의는 channels.discord.accounts.<accountId>.agentComponents.ttlMs 아래에 있습니다. 워크플로에 적합한 가장 짧은 TTL을 사용하는 것이 좋습니다.
• channels.discord.voice은 Discord 음성 채널 대화와 선택적 자동 참여 + LLM + TTS 재정의를 활성화합니다. 텍스트 전용 Discord 구성에서는 기본적으로 음성이 꺼져 있으며, 사용하려면 channels.discord.voice.enabled=true을 설정하십시오.
• channels.discord.voice.model은 선택적으로 Discord 음성 채널 응답에 사용되는 LLM 모델을 재정의합니다.
• channels.discord.voice.daveEncryption(기본값 true) 및 channels.discord.voice.decryptionFailureTolerance(기본값 24)은 @discordjs/voice DAVE 옵션으로 전달됩니다.
• channels.discord.voice.connectTimeoutMs은 /vc join 및 자동 참여 시도의 초기 @discordjs/voice Ready 대기 시간을 제어합니다(기본값 30000).
• channels.discord.voice.reconnectGraceMs은 연결이 끊어진 음성 세션이 재연결 신호 상태로 진입할 때까지 OpenClaw가 허용하는 시간을 제어하며, 이 시간이 지나면 해당 세션을 제거합니다(기본값 15000).
• Discord 음성 재생은 다른 사용자의 발화 시작 이벤트로 중단되지 않습니다. 피드백 루프를 방지하기 위해 OpenClaw는 TTS가 재생되는 동안 새로운 음성 캡처를 무시합니다.
• 또한 OpenClaw는 복호화 실패가 반복되면 음성 세션에서 나갔다가 다시 참여하여 음성 수신 복구를 시도합니다.
• channels.discord.streaming은 표준 스트림 모드 키입니다. Discord의 기본값은 streaming.mode: "progress"이므로 도구/작업 진행 상황이 편집되는 하나의 미리 보기 메시지에 표시됩니다. 비활성화하려면 streaming.mode: "off"을 설정하십시오. 기존의 평면 키(streamMode, chunkMode, blockStreaming, draftChunk, blockStreamingCoalesce)는 더 이상 런타임에서 읽히지 않습니다. 저장된 구성을 마이그레이션하려면 openclaw doctor --fix을 실행하십시오.
• channels.discord.autoPresence은 런타임 가용성을 봇 상태에 매핑하고(정상 => 온라인, 성능 저하 => 자리 비움, 소진 => 방해 금지), 선택적으로 상태 텍스트를 재정의할 수 있게 합니다.
• channels.discord.guilds.<id>.presenceEvents은 사람의 가용 상태 전환을 에이전트 시스템 이벤트로 구성된 하나의 Discord 채널에 라우팅합니다. 대상 멤버는 channelId을 볼 수 있어야 합니다. 공개 스레드는 상위 항목의 가시성을 상속하지만, 비공개 스레드는 추가로 멤버십 또는 Manage Threads가 필요합니다. users을 사용하면 해당 대상을 더 좁힐 수 있습니다. 완전한 GUILD_CREATE 스냅샷에서 현재 온라인 멤버를 초기화하고, 관찰된 오프라인-온라인 전환을 라우팅하며, 이전에 관찰되지 않은 멤버에게서 나중에 처음 수신된 온라인 신호는 그 멤버가 스냅샷 이후 온라인 상태가 되었는지 참여했는지 단정하지 않고 새로 사용 가능한 상태로 처리합니다. Discord의 75,000명 멤버 스냅샷 제한을 초과하는 길드에서는 먼저 명시적인 오프라인 업데이트가 필요합니다. 제한 조절 옵션: reconnectSuppressSeconds(길드 상태 정보가 재구성되는 동안 새 Gateway 세션 이후의 유예 시간, 기본값 300, 0은 비활성화) 및 burstLimit/burstWindowSeconds(길드별로 큐에 성공적으로 추가된 이벤트의 속도 제한, 기본값 60초 슬라이딩 윈도우당 이벤트 8개). 재개된 세션은 재연결 억제 윈도우를 시작하지 않습니다. 기존 사용자별 재인사 쿨다운은 8시간으로 유지됩니다. 이를 사용하려면 channels.discord.intents.presence=true, Discord Developer Portal의 권한 있는 Presence Intent, 활성화된 에이전트 Heartbeat가 필요합니다.
• channels.discord.dangerouslyAllowNameMatching은 변경 가능한 이름/태그 일치를 다시 활성화합니다(비상 호환성 모드).
• channels.discord.execApprovals: Discord 네이티브 실행 승인 전달 및 승인자 권한 부여입니다.
  • enabled: true, false 또는 "auto"(기본값). 자동 모드에서는 approvers 또는 commands.ownerAllowFrom에서 승인자를 확인할 수 있을 때 실행 승인이 활성화됩니다.
  • approvers: 실행 요청을 승인할 수 있는 Discord 사용자 ID입니다. 생략하면 commands.ownerAllowFrom을 대체 값으로 사용합니다.
  • agentFilter: 선택적 에이전트 ID 허용 목록입니다. 모든 에이전트의 승인을 전달하려면 생략하십시오.
  • sessionFilter: 선택적 세션 키 패턴입니다(부분 문자열 또는 정규식).
  • target: 승인 프롬프트를 보낼 위치입니다. "dm"(기본값)은 승인자의 DM으로, "channel"은 요청이 시작된 채널로, "both"은 양쪽 모두로 보냅니다. 대상에 "channel"이 포함되면 확인된 승인자만 버튼을 사용할 수 있습니다.
  • cleanupAfterResolve: true인 경우 승인, 거부 또는 시간 초과 후 승인 DM을 삭제합니다.

반응 알림 모드: off(없음), own(봇의 메시지, 기본값), all(모든 메시지), allowlist(모든 메시지에서 guilds.<id>.users으로부터).

Google Chat

{  channels: {    googlechat: {      enabled: true,      serviceAccountFile: "/path/to/service-account.json",      audienceType: "app-url", // app-url | project-number      audience: "https://gateway.example.com/googlechat",      webhookPath: "/googlechat",      botUser: "users/1234567890",      dm: {        enabled: true,        policy: "pairing",        allowFrom: ["users/1234567890"],      },      groupPolicy: "allowlist",      groups: {        "spaces/AAAA": { allow: true, requireMention: true },      },      actions: { reactions: true },      typingIndicator: "message",      mediaMaxMb: 20,    },  },}

• 서비스 계정 JSON: 인라인(serviceAccount) 또는 파일 기반(serviceAccountFile).
• 서비스 계정 SecretRef도 지원됩니다(serviceAccountRef).
• 환경 변수 대체 값: GOOGLE_CHAT_SERVICE_ACCOUNT 또는 GOOGLE_CHAT_SERVICE_ACCOUNT_FILE(기본 계정만 해당).
• 전달 대상에는 spaces/<spaceId> 또는 users/<userId>을 사용하십시오.
• channels.googlechat.dangerouslyAllowNameMatching은 변경 가능한 이메일 주체 일치를 다시 활성화합니다(비상 호환성 모드).

Slack

{  channels: {    slack: {      enabled: true,      botToken: "xoxb-...",      appToken: "xapp-...",      socketMode: {        clientPingTimeout: 15000,        serverPingTimeout: 30000,        pingPongLoggingEnabled: false,      },      dmPolicy: "pairing",      allowFrom: ["U123", "U456", "*"],      dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] },      channels: {        C123: { enabled: true, requireMention: true, allowBots: false },        "#general": {          enabled: true,          requireMention: true,          allowBots: false,          users: ["U123"],          skills: ["docs"],          systemPrompt: "짧게만 답변하십시오.",        },      },      historyLimit: 50,      allowBots: false,      reactionNotifications: "own",      reactionAllowlist: ["U123"],      replyToMode: "off", // 끔 | 첫 번째 | 모두 | 일괄 처리      thread: {        historyScope: "thread", // 스레드 | 채널        inheritParent: false,        initialHistoryLimit: 20,      },      actions: {        reactions: true,        messages: true,        pins: true,        memberInfo: true,        emojiList: true,      },      slashCommand: {        enabled: true,        name: "openclaw",        sessionPrefix: "slack:slash",        ephemeral: true,      },      typingReaction: "hourglass_flowing_sand",      unfurlLinks: false,      unfurlMedia: false,      textChunkLimit: 4000,      streaming: {        mode: "partial", // 끔 | 부분 | 블록 | 진행률        chunkMode: "length", // 길이 | 줄바꿈        nativeTransport: true, // mode=partial일 때 Slack 네이티브 스트리밍 API 사용      },      mediaMaxMb: 20,      execApprovals: {        enabled: "auto", // true | false | "auto"        approvers: ["U123"],        agentFilter: ["default"],        sessionFilter: ["slack:"],        target: "dm", // DM | 채널 | 둘 다      },    },  },}

• Socket 모드에는 botToken 및 appToken가 모두 필요합니다(기본 계정 환경 대체에는 SLACK_BOT_TOKEN + SLACK_APP_TOKEN).
• HTTP 모드에는 botToken와 signingSecret가 필요합니다(루트 또는 계정별로 설정).
• enterpriseOrgInstall: true는 계정이 Slack Enterprise Grid의 조직 전체 이벤트 경로를 사용하도록 설정합니다. 시작 시 auth.test을 사용하여 봇 토큰을 검증하며, 구성된 모드가 Slack의 설치 ID와 일치하지 않으면 실패합니다. Enterprise DM은 비활성화하거나 유효한 allowFrom: ["*"]와 함께 dmPolicy: "open"를 사용해야 합니다. 채널 및 사용자 정책에는 안정적인 Slack ID를 사용해야 하며, 변경 가능한 이름과 지원되지 않는 채널 접두사는 시작 실패를 일으킵니다. V1은 즉시 응답하는 직접 Socket Mode 또는 HTTP message 및 app_mention 이벤트만 처리합니다. 릴레이, 명령, 상호작용, App Home, 반응 이벤트 리스너, 고정, 작업 도구, 네이티브 승인, 바인딩, 지연 전송 및 선제적 전송은 사용할 수 없습니다. 리스너가 소유하는 승인 응답, 입력 표시 및 상태 반응은 reactions:write에서 계속 사용할 수 있지만, 수신 반응 알림과 반응 작업 도구는 사용할 수 없습니다. 최소 권한 매니페스트, 설정 워크플로 및 전체 제한 사항은 Enterprise Grid 조직 전체 설치를 참조하십시오.
• socketMode는 Slack SDK Socket Mode 전송 조정 설정을 공개 Bolt 수신기 API로 전달합니다. ping/pong 시간 초과 또는 오래된 WebSocket 동작을 조사할 때만 사용하십시오. clientPingTimeout의 기본값은 15000이며, serverPingTimeout와 pingPongLoggingEnabled은 구성된 경우에만 전달됩니다.
• botToken, appToken, signingSecret 및 userToken은 일반 텍스트 문자열 또는 SecretRef 객체를 허용합니다.
• Slack 계정 스냅샷은 botTokenSource, botTokenStatus, appTokenStatus 및 HTTP 모드의 signingSecretStatus과 같은 자격 증명별 소스/상태 필드를 노출합니다. configured_unavailable는 계정이 SecretRef를 통해 구성되었지만 현재 명령/런타임 경로에서 비밀 값을 확인할 수 없었음을 의미합니다.
• configWrites: false은 Slack에서 시작된 구성 쓰기를 차단합니다.
• 선택적 channels.slack.defaultAccount는 구성된 계정 ID와 일치할 때 기본 계정 선택을 재정의합니다.
• channels.slack.streaming.mode는 표준 Slack 스트림 모드 키입니다(기본값 "partial"). channels.slack.streaming.nativeTransport은 Slack의 네이티브 스트리밍 전송을 제어합니다(기본값 true). 레거시 streamMode, 불리언 streaming, chunkMode, blockStreaming, blockStreamingCoalesce 및 nativeStreaming 값은 더 이상 런타임에서 읽지 않습니다. openclaw doctor --fix을 실행하여 저장된 구성을 streaming.{mode,chunkMode,block.enabled,block.coalesce,nativeTransport}으로 마이그레이션하십시오.
• unfurlLinks과 unfurlMedia은 봇 응답에 사용할 Slack의 chat.postMessage 링크 및 미디어 펼치기 불리언을 전달합니다. unfurlLinks의 기본값은 false이므로 활성화하지 않는 한 발신 봇 링크가 인라인으로 확장되지 않습니다. unfurlMedia는 구성하지 않으면 생략됩니다. 한 계정의 최상위 값을 재정의하려면 channels.slack.accounts.<accountId>에서 두 값 중 하나를 설정하십시오.
• 전송 대상에는 user:<id>(DM) 또는 channel:<id>를 사용하십시오.

반응 알림 모드: off, own(기본값), all, allowlist(reactionAllowlist에서 지정).

스레드 세션 격리: thread.historyScope은 스레드별(기본값)로 설정하거나 채널 전체에서 공유할 수 있습니다. thread.inheritParent는 상위 채널의 대화 기록을 새 스레드에 복사합니다. thread.initialHistoryLimit(기본값 20)은 새 스레드 세션이 시작될 때 가져오는 기존 스레드 메시지 수를 제한합니다. 0는 스레드 기록 가져오기를 비활성화합니다.

• Slack 네이티브 스트리밍과 Slack 어시스턴트 스타일의 "입력 중..." 스레드 상태에는 응답 스레드 대상이 필요합니다. 최상위 DM은 기본적으로 스레드 외부에 유지되므로 스레드 스타일의 네이티브 스트림/상태 미리 보기 대신 Slack 초안 게시 및 편집 미리 보기를 통해 계속 스트리밍할 수 있습니다.
• typingReaction는 응답이 실행되는 동안 수신 Slack 메시지에 임시 반응을 추가하고 완료되면 제거합니다. "hourglass_flowing_sand"과 같은 Slack 이모지 단축 코드를 사용하십시오.
• channels.slack.execApprovals: Slack 네이티브 승인 클라이언트 전송 및 실행 승인자 권한 부여입니다. Discord와 동일한 스키마를 사용합니다: enabled(true/false/"auto"), approvers(Slack 사용자 ID), agentFilter, sessionFilter 및 target("dm", "channel" 또는 "both"). Slack Plugin 승인자를 확인할 수 있는 경우 Plugin 승인은 Slack에서 시작된 요청에 이 네이티브 클라이언트 경로를 사용할 수 있습니다. Slack에서 시작된 세션 또는 Slack 대상에 대해 approvals.plugin을 통해 Slack 네이티브 Plugin 승인 전송을 활성화할 수도 있습니다. Plugin 승인은 실행 승인자가 아니라 allowFrom의 Slack Plugin 승인자와 기본 라우팅을 사용합니다.

Mattermost

Mattermost는 Discord, Slack 및 WhatsApp과 같은 방식으로 별도의 Plugin으로 설치됩니다.

openclaw plugins install @openclaw/mattermost

버전을 고정하기 전에 현재 dist-tag를 npmjs.com/package/@openclaw/mattermost에서 확인하십시오.

{  channels: {    mattermost: {      enabled: true,      botToken: "mm-token",      baseUrl: "https://chat.example.com",      dmPolicy: "pairing",      chatmode: "oncall", // 호출 시 | 메시지마다 | 문자 접두사      oncharPrefixes: [">", "!"],      groups: {        "*": { requireMention: true },        "team-channel-id": { requireMention: false },      },      commands: {        native: true, // 명시적으로 활성화        nativeSkills: true,        callbackPath: "/api/channels/mattermost/command",        // 역방향 프록시/공개 배포를 위한 선택적 명시 URL        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",      },      textChunkLimit: 4000,      streaming: { chunkMode: "length" },    },  },}

채팅 모드: oncall(글에서 @멘션할 때 응답, 기본값), onmessage(모든 메시지), onchar(트리거 접두사로 시작하는 메시지).

Mattermost 네이티브 명령이 활성화된 경우:

• commands.callbackPath는 전체 URL이 아니라 경로(예: /api/channels/mattermost/command)여야 합니다.
• commands.callbackUrl은 OpenClaw Gateway 엔드포인트로 확인되어야 하며 Mattermost 서버에서 접근할 수 있어야 합니다.
• 네이티브 슬래시 콜백은 슬래시 명령 등록 중 Mattermost가 반환한 명령별 토큰으로 인증됩니다. 등록에 실패하거나 활성화된 명령이 없으면 OpenClaw는 Unauthorized: invalid command token.으로 콜백을 거부합니다.
• 비공개/tailnet/내부 콜백 호스트의 경우 Mattermost에서 ServiceSettings.AllowedUntrustedInternalConnections에 콜백 호스트/도메인을 포함하도록 요구할 수 있습니다. 전체 URL이 아닌 호스트/도메인 값을 사용하십시오.
• channels.mattermost.configWrites: Mattermost에서 시작된 구성 쓰기를 허용하거나 거부합니다.
• channels.mattermost.requireMention: 채널에서 응답하기 전에 @mention을 요구합니다.
• channels.mattermost.groups.<channelId>.requireMention: 채널별 멘션 제한 재정의입니다(기본값은 "*").
• 선택적 channels.mattermost.defaultAccount는 구성된 계정 ID와 일치할 때 기본 계정 선택을 재정의합니다.

Signal

{  channels: {    signal: {      enabled: true,      account: "+15555550123", // 선택적 계정 바인딩      dmPolicy: "pairing",      allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],      configWrites: true,      reactionNotifications: "own", // 끔 | 본인 | 모두 | 허용 목록      reactionAllowlist: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],      historyLimit: 50,    },  },}

반응 알림 모드: off, own(기본값), all, allowlist(reactionAllowlist에서 지정).

• channels.signal.account: 채널 시작 시 특정 Signal 계정 ID를 사용하도록 고정합니다.
• channels.signal.configWrites: Signal에서 시작된 구성 쓰기를 허용하거나 거부합니다.
• 선택적 channels.signal.defaultAccount는 구성된 계정 ID와 일치할 때 기본 계정 선택을 재정의합니다.

iMessage

OpenClaw는 imsg rpc(stdio를 통한 JSON-RPC)를 생성합니다. 데몬이나 포트는 필요하지 않습니다. 호스트에서 Messages 데이터베이스 및 자동화 권한을 부여할 수 있는 경우 새로운 OpenClaw iMessage 설정에 권장되는 경로입니다.

BlueBubbles 지원은 제거되었습니다. 현재 OpenClaw에서 channels.bluebubbles는 지원되는 런타임 구성 표면이 아닙니다. 이전 구성을 channels.imessage으로 마이그레이션하십시오. 간략한 내용은 BlueBubbles 제거 및 imsg iMessage 경로를, 전체 변환표는 BlueBubbles에서 이전하기를 참조하십시오.

Gateway가 Messages에 로그인된 Mac에서 실행되지 않는 경우 channels.imessage.enabled=true을 유지하고 channels.imessage.cliPath을 해당 Mac에서 imsg "$@"을 실행하는 SSH 래퍼로 설정하십시오. 기본 로컬 imsg 경로는 macOS에서만 사용할 수 있습니다.

프로덕션 전송에 SSH 래퍼를 사용하기 전에 해당 래퍼를 통해 발신 imsg send을 검증하십시오. 일부 macOS TCC 상태에서는 Messages 자동화 권한이 /usr/libexec/sshd-keygen-wrapper에 할당되므로 읽기와 프로브는 작동하지만 AppleEvents -1743으로 인해 전송이 실패할 수 있습니다. iMessage의 SSH 래퍼 문제 해결 섹션을 참조하십시오.

{  channels: {    imessage: {      enabled: true,      cliPath: "imsg",      dbPath: "~/Library/Messages/chat.db",      remoteHost: "user@gateway-host",      dmPolicy: "pairing",      allowFrom: ["+15555550123", "user@example.com", "chat_id:123"],      historyLimit: 50,      includeAttachments: false,      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],      mediaMaxMb: 16,      service: "auto",      sendTransport: "auto",      region: "US",      actions: {        reactions: true,        edit: true,        unsend: true,        reply: true,        sendWithEffect: true,        sendAttachment: true,      },    },  },}

• 선택 사항인 channels.imessage.defaultAccount는 구성된 계정 ID와 일치할 때 기본 계정 선택을 재정의합니다.
• Messages DB에 대한 Full Disk Access가 필요합니다.
• chat_id:<id> 대상을 사용하는 것이 좋습니다. 채팅 목록을 표시하려면 imsg chats --limit 20을 사용하십시오.
• cliPath은 SSH 래퍼를 가리킬 수 있습니다. SCP로 첨부 파일을 가져오려면 remoteHost(host 또는 user@host)을 설정하십시오.
• attachmentRoots 및 remoteAttachmentRoots은 수신 첨부 파일 경로를 제한합니다(기본값: /Users/*/Library/Messages/Attachments).
• SCP는 엄격한 호스트 키 검사를 사용하므로 릴레이 호스트 키가 이미 ~/.ssh/known_hosts에 있는지 확인하십시오.
• channels.imessage.configWrites: iMessage에서 시작된 구성 쓰기를 허용하거나 거부합니다.
• channels.imessage.sendTransport: 일반 발신 응답에 선호되는 imsg RPC 전송 방식입니다. auto(기본값)은 실행 중인 경우 기존 채팅에 IMCore 브리지를 사용한 다음 AppleScript로 대체합니다. bridge은 비공개 API를 통한 전송이 필요하며, applescript은 공개 Messages 자동화 경로를 강제로 사용합니다.
• channels.imessage.actions.*: imsg status / openclaw channels status --probe에 의해서도 제한되는 비공개 API 작업을 활성화합니다.
• channels.imessage.includeAttachments은 기본적으로 꺼져 있습니다. 에이전트 턴에서 수신 미디어를 사용하려면 먼저 true으로 설정하십시오.
• 브리지/Gateway 재시작 후 수신 복구는 자동으로 수행됩니다(GUID 중복 제거 및 오래된 백로그의 연령 제한). 기존 channels.imessage.catchup.enabled: true 구성은 더 이상 권장되지 않는 호환성 프로필로 계속 적용되며, catchup은 기본적으로 비활성화됩니다.
• channels.imessage.groups: 그룹 레지스트리 및 그룹별 설정입니다. groupPolicy: "allowlist"을 사용하는 경우 그룹 메시지가 레지스트리 게이트를 통과할 수 있도록 명시적인 chat_id 키 또는 "*" 와일드카드 항목을 구성하십시오.
• type: "acp"가 있는 최상위 bindings[] 항목은 iMessage 대화를 영구 ACP 세션에 바인딩할 수 있습니다. match.peer.id에서 정규화된 핸들 또는 명시적인 채팅 대상(chat_id:*, chat_guid:*, chat_identifier:*)을 사용하십시오. 공통 필드 의미 체계: ACP 에이전트.

#!/usr/bin/env bashexec ssh -T gateway-host imsg "$@"

Matrix

Matrix는 Plugin 기반이며 channels.matrix 아래에서 구성합니다.

{  channels: {    matrix: {      enabled: true,      homeserver: "https://matrix.example.org",      accessToken: "syt_bot_xxx",      proxy: "http://127.0.0.1:7890",      encryption: true,      initialSyncLimit: 20,      defaultAccount: "ops",      accounts: {        ops: {          name: "운영",          userId: "@ops:example.org",          accessToken: "syt_ops_xxx",        },        alerts: {          userId: "@alerts:example.org",          password: "secret",          proxy: "http://127.0.0.1:7891",        },      },    },  },}

• 토큰 인증은 accessToken을 사용하며, 비밀번호 인증은 userId + password을 사용합니다.
• channels.matrix.proxy은 명시적인 HTTP(S) 프록시를 통해 Matrix HTTP 트래픽을 라우팅합니다. 명명된 계정은 channels.matrix.accounts.<id>.proxy으로 이를 재정의할 수 있습니다.
• channels.matrix.network.dangerouslyAllowPrivateNetwork은 비공개/내부 홈서버를 허용합니다. proxy과 이 네트워크 옵트인은 서로 독립적인 제어 항목입니다.
• channels.matrix.defaultAccount은 다중 계정 설정에서 선호하는 계정을 선택합니다.
• channels.matrix.autoJoin의 기본값은 "off"이므로 autoJoinAllowlist 또는 autoJoin: "always"과 함께 autoJoin: "allowlist"을 설정할 때까지 초대된 방과 새 DM 방식 초대가 무시됩니다.
• channels.matrix.execApprovals: Matrix 네이티브 실행 승인 전달 및 승인자 권한 부여입니다.
  • enabled: true, false 또는 "auto"(기본값)입니다. 자동 모드에서는 approvers 또는 commands.ownerAllowFrom에서 승인자를 확인할 수 있을 때 실행 승인이 활성화됩니다.
  • approvers: 실행 요청을 승인할 수 있는 Matrix 사용자 ID(예: @owner:example.org)입니다.
  • agentFilter: 선택 사항인 에이전트 ID 허용 목록입니다. 모든 에이전트의 승인을 전달하려면 생략하십시오.
  • sessionFilter: 선택 사항인 세션 키 패턴입니다(부분 문자열 또는 정규식).
  • target: 승인 프롬프트를 보낼 위치입니다. "dm"(기본값), "channel"(요청이 시작된 방) 또는 "both"입니다.
  • 계정별 재정의: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope은 Matrix DM을 세션으로 그룹화하는 방식을 제어합니다. per-user(기본값)은 라우팅된 상대별로 공유하고, per-room은 각 DM 방을 격리합니다.
• Matrix 상태 프로브와 실시간 디렉터리 조회는 런타임 트래픽과 동일한 프록시 정책을 사용합니다.
• 전체 Matrix 구성, 대상 지정 규칙 및 설정 예시는 Matrix에 문서화되어 있습니다.

Microsoft Teams

Microsoft Teams는 Plugin 기반이며 channels.msteams 아래에서 구성합니다.

{  channels: {    msteams: {      enabled: true,      configWrites: true,      // appId, appPassword, tenantId, webhook, 팀/채널 정책:      // /channels/msteams 참조    },  },}

• 여기에서 다루는 핵심 키 경로: channels.msteams, channels.msteams.configWrites.
• 전체 Teams 구성(자격 증명, Webhook, DM/그룹 정책, 팀별/채널별 재정의)은 Microsoft Teams에 문서화되어 있습니다.

IRC

IRC는 Plugin 기반이며 channels.irc 아래에서 구성합니다.

{  channels: {    irc: {      enabled: true,      dmPolicy: "pairing",      configWrites: true,      nickserv: {        enabled: true,        service: "NickServ",        password: "${IRC_NICKSERV_PASSWORD}",        register: false,        registerEmail: "bot@example.com",      },    },  },}

• 여기에서 다루는 핵심 키 경로: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• 선택 사항인 channels.irc.defaultAccount는 구성된 계정 ID와 일치할 때 기본 계정 선택을 재정의합니다.
• 전체 IRC 채널 구성(호스트/포트/TLS/채널/허용 목록/멘션 게이트)은 IRC에 문서화되어 있습니다.

다중 계정(모든 채널)

채널마다 여러 계정을 실행합니다(각 계정은 자체 accountId을 사용함).

{  channels: {    telegram: {      accounts: {        default: {          name: "기본 봇",          botToken: "123456:ABC...",        },        alerts: {          name: "알림 봇",          botToken: "987654:XYZ...",        },      },    },  },}

• accountId을 생략하면 default이 사용됩니다(CLI + 라우팅).
• 환경 변수 토큰은 기본 계정에만 적용됩니다.
• 기본 채널 설정은 계정별로 재정의하지 않는 한 모든 계정에 적용됩니다.
• 각 계정을 서로 다른 에이전트로 라우팅하려면 bindings[].match.accountId을 사용하십시오.
• 단일 계정 최상위 채널 구성을 계속 사용하는 동안 openclaw channels add(또는 채널 온보딩)을 통해 기본 계정이 아닌 계정을 추가하면, OpenClaw는 먼저 계정 범위의 최상위 단일 계정 값을 채널 계정 맵으로 승격하여 원래 계정이 계속 작동하도록 합니다. 대부분의 채널은 이를 channels.<channel>.accounts.default으로 이동하지만, Matrix는 일치하는 기존 명명된 대상 또는 기본 대상을 대신 유지할 수 있습니다.
• 기존의 채널 전용 바인딩(accountId 없음)은 계속 기본 계정과 일치하며, 계정 범위 바인딩은 선택 사항으로 유지됩니다.
• openclaw doctor --fix은 계정 범위의 최상위 단일 계정 값을 해당 채널에 선택된 승격 계정으로 이동하여 혼합된 형태도 복구합니다. 대부분의 채널은 accounts.default을 사용하지만, Matrix는 일치하는 기존 명명된 대상 또는 기본 대상을 대신 유지할 수 있습니다.

기타 Plugin 채널

많은 Plugin 채널은 channels.<id>으로 구성되며 전용 채널 페이지에 문서화되어 있습니다(예: Feishu, LINE, Nextcloud Talk, Nostr, QQ Bot, Synology Chat, Twitch 및 Zalo). 전체 채널 색인을 참조하십시오: 채널.

그룹 채팅 멘션 게이트

그룹 메시지는 기본적으로 멘션 필요로 설정됩니다(메타데이터 멘션 또는 안전한 정규식 패턴). WhatsApp, Telegram, Discord, Google Chat 및 iMessage 그룹 채팅에 적용됩니다.

표시되는 응답은 별도로 제어됩니다. 일반 그룹, 채널 및 내부 WebChat 직접 요청은 기본적으로 최종 응답을 자동 전달합니다. 최종 어시스턴트 텍스트가 레거시 표시 응답 경로를 통해 게시됩니다. 에이전트가 message(action=send)을 호출한 후에만 표시 출력을 게시해야 하는 경우 messages.visibleReplies: "message_tool" 또는 messages.groupChat.visibleReplies: "message_tool"을 옵트인하십시오. 옵트인한 도구 전용 모드에서 모델이 메시지 도구를 호출하지 않고 실질적인 최종 답변을 반환하면 해당 최종 텍스트는 비공개로 유지되고, Gateway 상세 로그에는 억제된 페이로드 메타데이터가 기록되며, OpenClaw는 message(action=send)을 통해 동일한 응답을 전달하도록 모델에 요청하는 복구 재시도를 한 번 대기열에 추가합니다.

도구 전용 표시 응답에는 도구를 안정적으로 호출하는 모델/런타임이 필요하며, GPT-5.6 Sol과 같은 최신 세대 모델을 사용하는 공용 상시 대화방에 권장됩니다. 일부 성능이 낮은 모델은 최종 텍스트로 답변할 수 있지만 소스에 표시되는 출력을 message(action=send)을 사용해 전송해야 한다는 점을 이해하지 못할 수 있습니다. OpenClaw는 최종 응답이 실질적이고, 소스 턴이 방 이벤트가 아니며, 전송 정책이 전달을 거부하지 않았고, 소스 응답이 아직 전송되지 않은 경우에만 기본적으로 흔히 발생하는 미전달 최종 응답을 복구합니다. 복구는 한 번의 재시도로 제한됩니다. 합성 재시도 프롬프트는 영구 저장되지 않으며, 관련 없는 대기 프롬프트와 병합되지 않도록 해당 재시도를 수집 일괄 처리에서 제외합니다. 재시도 역시 전달되지 않거나 대기열에 추가할 수 없는 경우 OpenClaw는 "응답을 생성했지만 이 채팅에 전달하지 못했습니다. 다시 시도해 주십시오."와 같이 정제된 진단 메시지만 전달합니다. 원래의 비공개 최종 텍스트는 자동 소스 전달 대상으로 표시되지 않습니다. 응답을 반복해서 전달하지 못하는 모델의 경우 "automatic"을 사용하여 최종 어시스턴트 턴을 표시 응답 경로로 지정하거나, 도구 호출 성능이 더 우수한 모델로 전환하거나, Gateway 상세 로그에서 억제된 페이로드 요약을 확인하거나, 모든 그룹/채널 요청에 표시 최종 응답을 사용하도록 messages.groupChat.visibleReplies: "automatic"을 설정하십시오.

활성 도구 정책에서 메시지 도구를 사용할 수 없는 경우 OpenClaw는 응답을 조용히 억제하는 대신 자동 표시 응답으로 대체합니다. openclaw doctor은 이 불일치를 경고합니다.

이 규칙은 일반 에이전트 최종 텍스트에 적용됩니다. Plugin 소유 대화 바인딩은 소유 Plugin이 반환한 응답을 바인딩된 스레드의 처리된 턴에 표시되는 응답으로 사용합니다. Plugin은 이러한 바인딩 응답을 위해 message(action=send)을 호출할 필요가 없습니다.

문제 해결: 그룹 @멘션 시 입력 중 표시 후 아무 응답도 없음(오류 없음)

증상: 그룹/채널 @멘션 시 입력 중 표시가 나타나고 Gateway 로그에 dispatch complete (queuedFinal=false, replies=0)이 보고되지만 방에는 메시지가 게시되지 않습니다. 동일한 에이전트에 대한 DM은 정상적으로 응답합니다.

원인: 그룹/채널의 표시 응답 모드가 "message_tool"로 해석되므로, OpenClaw는 턴을 실행하지만 에이전트가 message(action=send)를 호출하지 않으면 최종 어시스턴트 텍스트를 표시하지 않습니다. 이 모드에는 NO_REPLY 계약이 없습니다. 메시지 도구 호출이 없으면 원래 최종 텍스트는 비공개입니다. 실질적인 내용이 있는 소스 턴에 대해 OpenClaw는 이제 보호된 복구 재시도를 한 번 수행합니다. 짧은 메모, 명시적 침묵, 룸 이벤트, 전송 정책에 의해 거부된 턴, 이미 전달된 턴은 재시도하지 않습니다. 일반 그룹 및 채널 턴의 기본값은 "automatic"이므로, 이 증상은 messages.groupChat.visibleReplies(또는 전역 messages.visibleReplies)을 "message_tool"로 명시적으로 설정한 경우에만 나타납니다. 하네스 defaultVisibleReplies은 여기에 적용되지 않습니다. 그룹/채널 해석기는 이를 무시하며, 직접/소스 채팅에만 영향을 줍니다(Codex 하네스는 이 방식으로 직접 채팅의 최종 응답을 표시하지 않습니다).

해결 방법: 도구 호출 기능이 더 강력한 모델을 선택하거나, 명시적 "message_tool" 재정의를 제거하여 "automatic" 기본값으로 대체하거나, 모든 그룹/채널 요청에서 응답을 표시하도록 messages.groupChat.visibleReplies: "automatic"을 설정하십시오. 실질적인 내용이 있지만 전달되지 못한 최종 응답은 더 이상 아무 표시 없이 성공으로 종료되지 않아야 합니다. 한 번의 message(action=send) 재시도로 복구되거나, 정제된 전달 실패 진단을 표시해야 합니다. 파일을 저장하면 Gateway가 messages 구성을 핫 리로드합니다. 배포에서 파일 감시 또는 구성 리로드가 비활성화된 경우에만 Gateway를 다시 시작하십시오.

멘션 유형:

• 메타데이터 멘션: 플랫폼 네이티브 @-멘션입니다. WhatsApp 셀프 채팅 모드에서는 무시됩니다.
• 텍스트 패턴: agents.list[].groupChat.mentionPatterns의 안전한 정규식 패턴입니다. 유효하지 않은 패턴과 안전하지 않은 중첩 반복은 무시됩니다.
• 멘션 게이팅은 감지가 가능한 경우(네이티브 멘션 또는 하나 이상의 패턴)에만 적용됩니다.

{  messages: {    visibleReplies: "automatic", // 직접/소스 채팅에 기존 자동 최종 응답을 강제 적용    groupChat: {      historyLimit: 50,      unmentionedInbound: "room_event", // 항상 활성화된 멘션 없는 룸 대화를 조용한 컨텍스트로 전환      visibleReplies: "message_tool", // 옵트인. 룸 응답을 표시하려면 message(action=send)가 필요    },  },  agents: {    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],  },}

messages.groupChat.historyLimit은 전역 기본값을 설정합니다. 채널은 channels.<channel>.historyLimit(또는 계정별 설정)로 재정의할 수 있습니다. 비활성화하려면 0로 설정하십시오.

messages.groupChat.unmentionedInbound: "room_event"은 지원되는 채널에서 멘션이 없는 상시 그룹/채널 메시지를 조용한 룸 컨텍스트로 제출합니다. 멘션된 메시지, 명령 및 직접 메시지는 계속 사용자 요청으로 처리됩니다. Discord, Slack 및 Telegram의 전체 예시는 주변 룸 이벤트를 참조하십시오.

messages.visibleReplies은 전역 소스 이벤트 기본값이며, messages.groupChat.visibleReplies은 그룹/채널 소스 이벤트에서 이를 재정의합니다. messages.visibleReplies이 설정되지 않은 경우 직접/소스 채팅은 선택된 런타임 또는 하네스 기본값을 사용하지만, 내부 WebChat 직접 턴은 Pi/Codex 프롬프트 동등성을 위해 자동 최종 전달을 사용합니다. 표시되는 출력에 message(action=send)이 필요하도록 의도적으로 설정하려면 messages.visibleReplies: "message_tool"를 설정하십시오. 이벤트 처리 여부는 여전히 채널 허용 목록과 멘션 게이팅에 따라 결정됩니다.

DM 기록 제한

{  channels: {    telegram: {      dmHistoryLimit: 30,      dms: {        "123456789": { historyLimit: 50 },      },    },  },}

해석 순서: DM별 재정의 → 제공자 기본값 → 제한 없음(모두 유지).

이 해석기는 세션 키가 표준 provider:direct:<id>(또는 레거시 provider:dm:<id>) 형식을 따르는 모든 채널의 channels.<provider>.dmHistoryLimit 및 channels.<provider>.dms.<id>.historyLimit을 읽으므로, 고정된 목록에만 국한되지 않고 번들 및 Plugin 채널 모두에서 작동합니다.

셀프 채팅 모드

셀프 채팅 모드를 활성화하려면 allowFrom에 자신의 번호를 포함하십시오(네이티브 @-멘션은 무시하고 텍스트 패턴에만 응답합니다).

{  channels: {    whatsapp: {      allowFrom: ["+15555550123"],      groups: { "*": { requireMention: true } },    },  },  agents: {    list: [      {        id: "main",        groupChat: { mentionPatterns: ["reisponde", "@openclaw"] },      },    ],  },}

명령(채팅 명령 처리)

{  commands: {    native: "auto", // 지원되는 경우 네이티브 명령 등록    nativeSkills: "auto", // 지원되는 경우 네이티브 Skills 명령 등록    text: true, // 채팅 메시지에서 /commands 구문 분석    bash: false, // ! 허용(별칭: /bash)    bashForegroundMs: 2000,    config: false, // /config 허용    mcp: false, // /mcp 허용    plugins: false, // /plugins 허용    debug: false, // /debug 허용    restart: true, // /restart 및 외부 SIGUSR1 재시작 요청 허용    ownerAllowFrom: ["discord:123456789012345678"],    ownerDisplay: "raw", // raw | hash    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",    allowFrom: {      "*": ["user1"],      discord: ["user:123"],    },    useAccessGroups: true,  },}

관련 문서

• 구성 참조 — 최상위 키
• 구성 — 에이전트
• 채널 개요