Конфігурація — канали

​

Канали

​

Доступ до DM і груп

​

Перевизначення моделі каналу

{
  channels: {
    modelByChannel: {
      discord: {
        "123456789012345678": "anthropic/claude-opus-4-6",
      },
      slack: {
        C1234567890: "openai/gpt-5.5",
        "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",
      },
    },
  },
}

​

Типові значення каналів і 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 (те саме, що allowlist, але зберігати явний контекст цитати/відповіді). Перевизначення за каналом: channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk: включати справні статуси каналів у вивід Heartbeat.
• channels.defaults.heartbeat.showAlerts: включати погіршені/помилкові статуси у вивід Heartbeat.
• channels.defaults.heartbeat.useIndicator: відтворювати компактний вивід Heartbeat у стилі індикатора.

​

WhatsApp

{
  web: {
    enabled: true,
    heartbeatSeconds: 60,
    whatsapp: {
      keepAliveIntervalMs: 25000,
      connectTimeoutMs: 60000,
      defaultQueryTimeoutMs: 60000,
    },
    reconnect: {
      initialMs: 2000,
      maxMs: 120000,
      factor: 1.4,
      jitter: 0.2,
      maxAttempts: 0,
    },
  },
  channels: {
    whatsapp: {
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["+15555550123", "+447700900123"],
      textChunkLimit: 4000,
      chunkMode: "length", // length | newline
      mediaMaxMb: 50,
      sendReadReceipts: true, // blue ticks (false in self-chat mode)
      groups: {
        "*": { requireMention: true },
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

• Записи верхнього рівня bindings[] з type: "acp" налаштовують постійні прив’язки ACP для DM і груп WhatsApp. Використовуйте прямий номер E.164 або JID групи WhatsApp у match.peer.id. Семантика полів спільна в Агенти 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: "Keep answers brief.",
          topics: {
            "99": {
              requireMention: false,
              skills: ["search"],
              systemPrompt: "Stay on topic.",
            },
          },
        },
      },
      customCommands: [
        { command: "backup", description: "Git backup" },
        { command: "generate", description: "Create an image" },
      ],
      historyLimit: 50,
      replyToMode: "first", // off | first | all | batched
      linkPreview: true,
      streaming: "partial", // off | partial | block | progress (default: 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",
      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 або власний розміщений/proxy-корінь, а не https://api.telegram.org/bot<TOKEN>; openclaw doctor --fix видаляє випадковий кінцевий суфікс /bot<TOKEN>.
• Необов’язковий channels.telegram.defaultAccount перевизначає вибір типового облікового запису, коли він збігається з налаштованим ID облікового запису.
• У налаштуваннях із кількома обліковими записами (2+ ID облікових записів) задайте явний типовий (channels.telegram.defaultAccount або channels.telegram.accounts.default), щоб уникнути резервної маршрутизації; openclaw doctor попереджає, коли він відсутній або недійсний.
• configWrites: false блокує записи конфігурації, ініційовані Telegram (міграції ID супергруп, /config set|unset).
• Записи верхнього рівня bindings[] з type: "acp" налаштовують постійні прив’язки ACP для тем форуму (використовуйте канонічний chatId:topic:topicId у match.peer.id). Семантика полів спільна в Агенти ACP.
• Попередні перегляди потоків Telegram використовують sendMessage + editMessageText (працює в прямих і групових чатах).
• Політика повторних спроб: див. Політика повторних спроб.

​

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,
      chunkMode: "length", // length | newline
      streaming: {
        mode: "progress", // off | partial | block | progress (Discord default: progress)
        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 перевизначає вибір стандартного облікового запису, коли збігається з налаштованим ідентифікатором облікового запису.
• Використовуйте user:<id> (DM) або channel:<id> (канал гільдії) для цілей доставки; голі числові ідентифікатори відхиляються.
• Слаги гільдій пишуться нижнім регістром із заміною пробілів на -; ключі каналів використовують слаговану назву (без #). Віддавайте перевагу ідентифікаторам гільдій.
• Повідомлення, створені ботами, стандартно ігноруються. allowBots: true вмикає їх; використовуйте allowBots: "mentions", щоб приймати лише повідомлення ботів, які згадують бота (власні повідомлення все одно фільтруються).
• Канали, що підтримують вхідні повідомлення, створені ботами, можуть використовувати спільний захист від циклів ботів. Задайте channels.defaults.botLoopProtection для базових бюджетів пар, а потім перевизначайте канал або обліковий запис лише тоді, коли окрема поверхня потребує інших лімітів.
• channels.discord.guilds.<id>.ignoreOtherMentions (і перевизначення каналів) відкидає повідомлення, які згадують іншого користувача або роль, але не бота (за винятком @everyone/@here).
• channels.discord.mentionAliases зіставляє стабільний вихідний текст @handle з ідентифікаторами користувачів Discord перед надсиланням, щоб відомих учасників команди можна було згадувати детерміновано, навіть коли тимчасовий кеш каталогу порожній. Перевизначення для окремого облікового запису розміщуються в 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 thread-spawn (стандартно: true)
  • defaultSpawnContext: нативний контекст субагента для породжень, прив’язаних до потоків (стандартно "fork")
• Записи верхнього рівня bindings[] із type: "acp" налаштовують сталі прив’язки ACP для каналів і потоків (використовуйте ідентифікатор каналу/потоку в match.peer.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 необов’язково перевизначає модель LLM, що використовується для відповідей у голосовому каналі Discord.
• channels.discord.voice.daveEncryption і channels.discord.voice.decryptionFailureTolerance передаються до параметрів DAVE @discordjs/voice (стандартно true і 24).
• channels.discord.voice.connectTimeoutMs керує початковим очікуванням Ready @discordjs/voice для /vc join і спроб автоматичного приєднання (стандартно 30000).
• channels.discord.voice.reconnectGraceMs керує тим, скільки часу від’єднана голосова сесія може входити в сигналізацію повторного підключення, перш ніж OpenClaw її знищить (стандартно 15000).
• Відтворення голосу Discord не переривається подією початку мовлення іншого користувача. Щоб уникнути циклів зворотного зв’язку, OpenClaw ігнорує нове захоплення голосу, поки відтворюється TTS.
• OpenClaw додатково намагається відновити приймання голосу, виходячи з голосової сесії та повторно приєднуючись до неї після повторних збоїв дешифрування.
• channels.discord.streaming є канонічним ключем режиму потоку. Discord стандартно використовує streaming.mode: "progress", щоб перебіг роботи інструментів/завдань з’являвся в одному редагованому повідомленні попереднього перегляду; задайте streaming.mode: "off", щоб вимкнути це. Застарілі значення streamMode і булеві значення streaming залишаються псевдонімами середовища виконання; запустіть openclaw doctor --fix, щоб переписати збережену конфігурацію.
• channels.discord.autoPresence зіставляє доступність середовища виконання зі станом присутності бота (healthy => online, degraded => idle, exhausted => dnd) і дозволяє необов’язкові перевизначення тексту статусу.
• channels.discord.dangerouslyAllowNameMatching повторно вмикає зіставлення за змінюваним іменем/тегом (аварійний режим сумісності).
• channels.discord.execApprovals: нативна для Discord доставка затверджень exec і авторизація затверджувачів.
  • enabled: true, false або "auto" (стандартно). В автоматичному режимі затвердження exec активуються, коли затверджувачів можна визначити з approvers або commands.ownerAllowFrom.
  • approvers: ідентифікатори користувачів Discord, яким дозволено затверджувати запити exec. Якщо пропущено, використовується резервне commands.ownerAllowFrom.
  • agentFilter: необов’язковий список дозволених ідентифікаторів агентів. Пропустіть, щоб пересилати затвердження для всіх агентів.
  • sessionFilter: необов’язкові шаблони ключів сесій (підрядок або регулярний вираз).
  • target: куди надсилати запити затвердження. "dm" (стандартно) надсилає в DM затверджувачам, "channel" надсилає у вихідний канал, "both" надсилає в обидва місця. Коли ціль містить "channel", кнопками можуть користуватися лише визначені затверджувачі.
  • cleanupAfterResolve: коли true, видаляє DM із затвердженням після затвердження, відмови або тайм-ауту.

​

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 повторно вмикає зіставлення за змінюваним email-принципалом (аварійний режим сумісності).

​

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: { allow: true, requireMention: true, allowBots: false },
        "#general": {
          allow: true,
          requireMention: true,
          allowBots: false,
          users: ["U123"],
          skills: ["docs"],
          systemPrompt: "Short answers only.",
        },
      },
      historyLimit: 50,
      allowBots: false,
      reactionNotifications: "own",
      reactionAllowlist: ["U123"],
      replyToMode: "off", // off | first | all | batched
      thread: {
        historyScope: "thread", // thread | channel
        inheritParent: false,
      },
      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,
      chunkMode: "length",
      streaming: {
        mode: "partial", // off | partial | block | progress
        nativeTransport: true, // use Slack native streaming API when mode=partial
      },
      mediaMaxMb: 20,
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["U123"],
        agentFilter: ["default"],
        sessionFilter: ["slack:"],
        target: "dm", // dm | channel | both
      },
    },
  },
}

• Режим Socket потребує і botToken, і appToken (SLACK_BOT_TOKEN + SLACK_APP_TOKEN для резервного використання env стандартного облікового запису).
• Режим HTTP потребує botToken плюс signingSecret (на кореневому рівні або для кожного облікового запису).
• socketMode передає налаштування транспорту Slack SDK Socket Mode до публічного API приймача Bolt. Використовуйте це лише під час розслідування тайм-аутів ping/pong або застарілої поведінки websocket. clientPingTimeout за замовчуванням має значення 15000; serverPingTimeout і pingPongLoggingEnabled передаються лише коли налаштовані.
• botToken, appToken, signingSecret і userToken приймають відкриті рядки або об’єкти SecretRef.
• Знімки облікових записів Slack показують поля джерела/статусу для кожних облікових даних, як-от botTokenSource, botTokenStatus, appTokenStatus, а в режимі HTTP — signingSecretStatus. configured_unavailable означає, що обліковий запис налаштований через SecretRef, але поточний шлях команди/runtime не зміг отримати значення секрету.
• configWrites: false блокує записи конфігурації, ініційовані Slack.
• Необов’язковий channels.slack.defaultAccount перевизначає вибір стандартного облікового запису, коли він збігається з id налаштованого облікового запису.
• channels.slack.streaming.mode є канонічним ключем режиму потоку Slack. channels.slack.streaming.nativeTransport керує нативним потоковим транспортом Slack. Застарілі значення streamMode, булеве streaming і nativeStreaming залишаються runtime-аліасами; виконайте openclaw doctor --fix, щоб переписати збережену конфігурацію.
• unfurlLinks і unfurlMedia передають булеві параметри розгортання посилань і медіа Slack chat.postMessage для відповідей бота. unfurlLinks за замовчуванням має значення false, щоб вихідні посилання бота не розгорталися вбудовано, якщо це не ввімкнено; unfurlMedia пропускається, якщо не налаштовано. Встановіть будь-яке з цих значень у channels.slack.accounts.<accountId>, щоб перевизначити значення верхнього рівня для одного облікового запису.
• Використовуйте user:<id> (DM) або channel:<id> для цілей доставки.

• Нативне потокове передавання Slack разом зі статусом потоку в стилі асистента Slack “is typing…” потребують цільового потоку відповіді. DM верхнього рівня за замовчуванням лишаються поза потоком, тож вони все ще можуть передаватися через попередні перегляди чернетки Slack із публікацією та редагуванням замість показу нативного потокового/статусного попереднього перегляду в стилі потоку.
• typingReaction додає тимчасову реакцію до вхідного повідомлення Slack, доки виконується відповідь, а потім видаляє її після завершення. Використовуйте шорткод emoji Slack, наприклад "hourglass_flowing_sand".
• channels.slack.execApprovals: доставка через нативний клієнт затверджень Slack і авторизація затверджувача exec. Та сама схема, що й у Discord: enabled (true/false/"auto"), approvers (ID користувачів Slack), agentFilter, sessionFilter і target ("dm", "channel" або "both"). Затвердження Plugin можуть використовувати цей шлях нативного клієнта для запитів, що походять зі Slack, коли затверджувачі Plugin Slack визначаються; доставку затверджень Plugin нативно через Slack також можна ввімкнути через approvals.plugin для сесій, що походять зі Slack, або цілей Slack. Затвердження Plugin використовують затверджувачів Plugin Slack із allowFrom і стандартну маршрутизацію, а не затверджувачів exec.

​

Mattermost

{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
      chatmode: "oncall", // oncall | onmessage | onchar
      oncharPrefixes: [">", "!"],
      groups: {
        "*": { requireMention: true },
        "team-channel-id": { requireMention: false },
      },
      commands: {
        native: true, // opt-in
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Optional explicit URL for reverse-proxy/public deployments
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
      textChunkLimit: 4000,
      chunkMode: "length",
    },
  },
}

• commands.callbackPath має бути шляхом (наприклад /api/channels/mattermost/command), а не повною URL-адресою.
• commands.callbackUrl має вказувати на кінцеву точку OpenClaw gateway і бути доступним із сервера Mattermost.
• Нативні callback-и slash автентифікуються токенами для кожної команди, які повертає Mattermost під час реєстрації slash-команди. Якщо реєстрація не вдається або жодні команди не активовані, OpenClaw відхиляє callback-и з Unauthorized: invalid command token.
• Для приватних/tailnet/внутрішніх хостів callback Mattermost може вимагати, щоб ServiceSettings.AllowedUntrustedInternalConnections містив хост/домен callback. Використовуйте значення хоста/домену, а не повні 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", // optional account binding
      dmPolicy: "pairing",
      allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      configWrites: true,
      reactionNotifications: "own", // off | own | all | allowlist
      reactionAllowlist: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      historyLimit: 50,
    },
  },
}

• channels.signal.account: прив’язати запуск каналу до конкретної ідентичності облікового запису Signal.
• channels.signal.configWrites: дозволити або заборонити записи конфігурації, ініційовані Signal.
• Необов’язковий channels.signal.defaultAccount перевизначає вибір стандартного облікового запису, коли він збігається з id налаштованого облікового запису.

​

iMessage

{
  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 налаштованого облікового запису.
• Потребує Full Disk Access до бази даних Messages.
• Надавайте перевагу цілям chat_id:<id>. Використовуйте imsg chats --limit 20, щоб перелічити чати.
• cliPath може вказувати на SSH-обгортку; встановіть remoteHost (host або user@host) для отримання вкладень через SCP.
• attachmentRoots і remoteAttachmentRoots обмежують шляхи вхідних вкладень (за замовчуванням: /Users/*/Library/Messages/Attachments).
• SCP використовує сувору перевірку ключа хоста, тож переконайтеся, що ключ ретрансляційного хоста вже існує в ~/.ssh/known_hosts.
• channels.imessage.configWrites: дозволити або заборонити записи конфігурації, ініційовані iMessage.
• channels.imessage.sendTransport: бажаний транспорт надсилання RPC imsg для звичайних вихідних відповідей. auto (за замовчуванням) використовує міст IMCore для наявних чатів, коли він запущений, а потім повертається до AppleScript; bridge потребує доставки через приватний API; applescript примусово використовує публічний шлях автоматизації Messages.
• channels.imessage.actions.*: увімкнути дії приватного API, які також обмежуються imsg status / openclaw channels status --probe.
• channels.imessage.includeAttachments за замовчуванням вимкнено; встановіть його в true, перш ніж очікувати вхідні медіа в ходах агента.
• Вхідне відновлення після перезапуску bridge/gateway є автоматичним (дедуплікація GUID плюс вікова межа застарілого backlog). Наявні конфігурації channels.imessage.catchup.enabled: true досі підтримуються як застарілий профіль сумісності.
• channels.imessage.groups: реєстр груп і налаштування для кожної групи. З groupPolicy: "allowlist" налаштуйте або явні ключі chat_id, або запис із wildcard "*", щоб групові повідомлення могли пройти через шлюз реєстру.
• Записи верхнього рівня bindings[] із type: "acp" можуть прив’язувати розмови iMessage до постійних сесій ACP. Використовуйте нормалізований handle або явну ціль чату (chat_id:*, chat_guid:*, chat_identifier:*) у match.peer.id. Семантика спільних полів: Агенти ACP.

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

​

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: "Ops",
          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-трафік Matrix через явний HTTP(S)-проксі. Іменовані облікові записи можуть перевизначити це через channels.matrix.accounts.<id>.proxy.
• channels.matrix.network.dangerouslyAllowPrivateNetwork дозволяє приватні/внутрішні homeserver-и. proxy і це мережеве явне ввімкнення є незалежними засобами керування.
• channels.matrix.defaultAccount вибирає бажаний обліковий запис у налаштуваннях із кількома обліковими записами.
• channels.matrix.autoJoin за замовчуванням має значення off, тому запрошені кімнати та нові запрошення у стилі DM ігноруються, доки ви не задасте autoJoin: "allowlist" з autoJoinAllowlist або autoJoin: "always".
• channels.matrix.execApprovals: доставлення підтверджень exec, нативне для Matrix, і авторизація схвалювачів.
  • enabled: true, false або "auto" (за замовчуванням). В автоматичному режимі підтвердження exec активуються, коли схвалювачів можна визначити з approvers або commands.ownerAllowFrom.
  • approvers: ID користувачів Matrix (наприклад, @owner:example.org), яким дозволено схвалювати запити exec.
  • agentFilter: необов’язковий список дозволених ID агентів. Пропустіть, щоб пересилати підтвердження для всіх агентів.
  • sessionFilter: необов’язкові шаблони ключів сесій (підрядок або регулярний вираз).
  • target: куди надсилати запити на підтвердження. "dm" (за замовчуванням), "channel" (початкова кімната) або "both".
  • Перевизначення для окремих облікових записів: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope керує тим, як DM Matrix групуються в сесії: per-user (за замовчуванням) спільно використовує сесію за маршрутизованим співрозмовником, тоді як per-room ізолює кожну DM-кімнату.
• Перевірки стану Matrix і live-пошуки в каталозі використовують ту саму політику проксі, що й трафік runtime.
• Повну конфігурацію Matrix, правила таргетування та приклади налаштування задокументовано в Matrix.

​

Microsoft Teams

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // appId, appPassword, tenantId, webhook, team/channel policies:
      // see /channels/msteams
    },
  },
}

• Основні шляхи ключів, описані тут: channels.msteams, channels.msteams.configWrites.
• Повну конфігурацію Teams (облікові дані, webhook, політика DM/груп, перевизначення для окремих команд/каналів) задокументовано в Microsoft Teams.

​

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 (host/port/TLS/channels/allowlists/mention gating) задокументовано в IRC.

​

Кілька облікових записів (усі канали)

{
  channels: {
    telegram: {
      accounts: {
        default: {
          name: "Primary bot",
          botToken: "123456:ABC...",
        },
        alerts: {
          name: "Alerts bot",
          botToken: "987654:XYZ...",
        },
      },
    },
  },
}

• default використовується, коли accountId пропущено (CLI + маршрутизація).
• Токени env застосовуються лише до типового облікового запису.
• Базові налаштування каналу застосовуються до всіх облікових записів, якщо їх не перевизначено для окремого облікового запису.
• Використовуйте bindings[].match.accountId, щоб маршрутизувати кожен обліковий запис до іншого агента.
• Якщо ви додаєте нетиповий обліковий запис через openclaw channels add (або onboarding каналу), все ще маючи однорівневу конфігурацію каналу для одного облікового запису, OpenClaw спочатку переносить значення верхнього рівня, що належать до облікового запису, у мапу облікових записів каналу, щоб початковий обліковий запис продовжив працювати. Більшість каналів переносять їх у channels.<channel>.accounts.default; Matrix натомість може зберегти наявну відповідну іменовану/типову ціль.
• Наявні прив’язки лише до каналу (без accountId) і далі відповідають типовому обліковому запису; прив’язки з областю облікового запису залишаються необов’язковими.
• openclaw doctor --fix також виправляє змішані форми, переміщуючи значення верхнього рівня для одного облікового запису, що належать до облікового запису, у підвищений обліковий запис, вибраний для цього каналу. Більшість каналів використовують accounts.default; Matrix натомість може зберегти наявну відповідну іменовану/типову ціль.

​

Інші канали Plugin

​

Контроль згадок у групових чатах

• Згадки метаданих: нативні @згадки платформи. Ігноруються в режимі self-chat WhatsApp.
• Текстові шаблони: безпечні шаблони регулярних виразів у agents.list[].groupChat.mentionPatterns. Недійсні шаблони та небезпечні вкладені повторення ігноруються.
• Контроль згадок застосовується лише тоді, коли виявлення можливе (нативні згадки або принаймні один шаблон).

{
  messages: {
    visibleReplies: "automatic", // force old automatic final replies for direct/source chats
    groupChat: {
      historyLimit: 50,
      unmentionedInbound: "room_event", // always-on unmentioned room chatter becomes quiet context
      visibleReplies: "message_tool", // opt-in; require message(action=send) for visible room replies
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

Ліміти історії DM

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

​

Режим self-chat

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

​

Команди (обробка команд чату)

{
  commands: {
    native: "auto", // register native commands when supported
    nativeSkills: "auto", // register native skill commands when supported
    text: true, // parse /commands in chat messages
    bash: false, // allow ! (alias: /bash)
    bashForegroundMs: 2000,
    config: false, // allow /config
    mcp: false, // allow /mcp
    plugins: false, // allow /plugins
    debug: false, // allow /debug
    restart: true, // allow /restart + gateway restart tool
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

​

Пов’язане

• Довідник конфігурації — ключі верхнього рівня
• Конфігурація — агенти
• Огляд каналів