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

​

Каналы

​

Доступ к личным сообщениям и группам

​

Переопределение моделей для каналов

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

​

Параметры каналов по умолчанию и 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

{
  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 = retry forever
    },
  },
  channels: {
    whatsapp: {
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["+15555550123", "+447700900123"],
      textChunkLimit: 4000,
      streaming: { chunkMode: "length" }, // length | newline
      mediaMaxMb: 50,
      sendReadReceipts: true, // blue ticks (false in self-chat mode)
      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 повторные попытки продолжаются бесконечно вместо прекращения.
• Записи верхнего уровня bindings[] с type: "acp" настраивают постоянные привязки ACP для личных сообщений и групп WhatsApp. В match.peer.id укажите прямой номер в формате E.164 или JID группы WhatsApp. Семантика полей описана в разделе Агенты 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: { mode: "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",
      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 или корневой адрес собственного сервера либо прокси, но не https://api.telegram.org/bot<TOKEN>; openclaw doctor --fix удаляет случайно добавленный конечный суффикс /bot<TOKEN>.
• Для собственного сервера Bot API в режиме --local параметр trustedLocalFileRoots перечисляет пути на хосте, которые OpenClaw может читать. Подключите том данных сервера на хосте OpenClaw и настройте корневой каталог данных или каталог отдельного токена; пути контейнера в /var/lib/telegram-bot-api сопоставляются с этими корневыми каталогами. Другие абсолютные пути по-прежнему отклоняются.
• Необязательный параметр channels.telegram.defaultAccount переопределяет выбор аккаунта по умолчанию, если совпадает с идентификатором настроенного аккаунта.
• В конфигурациях с несколькими аккаунтами (2+ идентификатора аккаунтов) задайте явный аккаунт по умолчанию (channels.telegram.defaultAccount или channels.telegram.accounts.default), чтобы избежать резервной маршрутизации; openclaw doctor выводит предупреждение, если он отсутствует или недействителен.
• configWrites: false блокирует инициированную Telegram запись конфигурации (миграции идентификаторов супергрупп, /config set|unset).
• Записи верхнего уровня bindings[] с type: "acp" настраивают постоянные привязки ACP для тем форума (используйте канонический chatId:topic:topicId в match.peer.id). Семантика полей описана в разделе Агенты ACP.
• Предварительный просмотр потоковой передачи в Telegram использует sendMessage + editMessageText (работает в личных и групповых чатах).
• По умолчанию network.dnsResultOrder имеет значение "ipv4first", чтобы избежать распространённых сбоев получения данных через IPv6.
• Политика повторных попыток: см. Политика повторных попыток.

​

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 переопределяет выбор учётной записи по умолчанию, если он совпадает с идентификатором настроенной учётной записи.
• Для целей доставки используйте user:<id> (личные сообщения) или 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 (по умолчанию: 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 (по умолчанию true) и channels.discord.voice.decryptionFailureTolerance (по умолчанию 24) передаются в параметры DAVE @discordjs/voice.
• channels.discord.voice.connectTimeoutMs управляет начальным ожиданием состояния @discordjs/voice Ready для /vc join и попыток автоматического подключения (по умолчанию 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 сопоставляет доступность среды выполнения со статусом присутствия бота (healthy => в сети, degraded => неактивен, exhausted => не беспокоить) и позволяет при необходимости переопределить текст статуса.
• channels.discord.guilds.<id>.presenceEvents направляет события появления доступных пользователей в один настроенный канал Discord как системные события агента. Подходящие участники должны иметь возможность просматривать channelId; публичные ветки наследуют видимость родительского канала, а для приватных веток дополнительно требуется участие или разрешение Manage Threads. users может дополнительно сузить эту аудиторию. Текущий список участников в сети заполняется из полных снимков GUILD_CREATE, отслеживаются наблюдаемые переходы из состояния не в сети в состояние в сети, а первый более поздний сигнал о появлении в сети для ранее не замеченного участника считается новой доступностью без утверждения о том, появился ли он в сети или присоединился после создания снимка. Для серверов, превышающих ограничение Discord на снимок в 75 000 участников, сначала требуется явное обновление состояния не в сети. Параметры регулирования: reconnectSuppressSeconds (период бездействия после нового сеанса Gateway, пока восстанавливается состояние присутствия на сервере; по умолчанию 300, 0 отключает) и burstLimit/burstWindowSeconds (ограничение частоты успешно поставленных в очередь событий для каждого сервера; по умолчанию 8 событий за скользящее окно 60s). Возобновлённые сеансы не запускают окно подавления повторного подключения. Существующий период ожидания повторного приветствия для каждого пользователя остаётся равным восьми часам. Для этого требуются channels.discord.intents.presence=true, привилегированное разрешение Presence Intent в Developer Portal Discord и включённый Heartbeat агента.
• channels.discord.dangerouslyAllowNameMatching повторно включает сопоставление изменяемых имён и тегов (аварийный режим совместимости).
• channels.discord.execApprovals: встроенная в Discord доставка запросов на одобрение выполнения и авторизация утверждающих пользователей.
  • enabled: true, false или "auto" (по умолчанию). В автоматическом режиме одобрение выполнения активируется, когда утверждающих пользователей можно определить из approvers или commands.ownerAllowFrom.
  • approvers: идентификаторы пользователей Discord, которым разрешено одобрять запросы на выполнение. Если параметр не указан, используется commands.ownerAllowFrom.
  • agentFilter: необязательный список разрешённых идентификаторов агентов. Не указывайте его, чтобы пересылать запросы на одобрение для всех агентов.
  • sessionFilter: необязательные шаблоны ключей сеансов (подстрока или регулярное выражение).
  • target: куда отправлять запросы на одобрение. "dm" (по умолчанию) отправляет их в личные сообщения утверждающим пользователям, "channel" — в исходный канал, "both" — в оба места. Когда цель включает "channel", кнопки могут использовать только определённые утверждающие пользователи.
  • cleanupAfterResolve: при значении true удаляет личные сообщения с запросами на одобрение после одобрения, отказа или истечения времени ожидания.

​

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", // off | first | all | batched
      thread: {
        historyScope: "thread", // thread | channel
        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", // off | partial | block | progress
        chunkMode: "length", // length | newline
        nativeTransport: true, // использовать нативный API потоковой передачи Slack при 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 для резервного использования переменных окружения учётной записи по умолчанию).
• Режим HTTP требует botToken вместе с signingSecret (в корне или для отдельной учётной записи).
• enterpriseOrgInstall: true подключает учётную запись к общекорпоративному пути событий Slack Enterprise Grid. При запуске токен бота проверяется с помощью auth.test, и запуск завершается ошибкой, если настроенный режим не соответствует идентификатору установки Slack. Личные сообщения Enterprise должны быть отключены либо использовать dmPolicy: "open" с действующим allowFrom: ["*"]. Политики каналов и пользователей должны использовать стабильные идентификаторы Slack; изменяемые имена и неподдерживаемые префиксы каналов приводят к ошибке запуска. V1 обрабатывает только прямые события Socket Mode или HTTP message и app_mention с немедленными ответами; ретрансляция, команды, взаимодействия, App Home, обработчики событий реакций, закрепления, инструменты действий, нативные подтверждения, привязки, отложенная доставка и проактивные отправки недоступны. Подтверждение получения, индикация набора текста и реакции состояния, которыми управляет обработчик, остаются доступны с reactions:write; входящие уведомления о реакциях и инструменты действий с реакциями недоступны. Сведения о манифесте с минимальными привилегиями, процессе настройки и полном списке ограничений см. в разделе Общекорпоративные установки Enterprise Grid.
• socketMode передаёт параметры настройки транспорта Socket Mode SDK Slack в публичный API приёмника Bolt. Используйте его только при исследовании тайм-аутов 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 переопределяет выбор учётной записи по умолчанию, если совпадает с идентификатором настроенной учётной записи.
• 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> (личное сообщение) или channel:<id>.

• Нативная потоковая передача Slack и состояние ветки «is typing…» в стиле ассистента Slack требуют, чтобы целью ответа была ветка. Личные сообщения верхнего уровня по умолчанию остаются вне веток, поэтому они всё равно могут передаваться потоком через предварительный просмотр Slack с публикацией и редактированием черновика, а не отображать нативный предварительный просмотр потока и состояния в стиле ветки.
• typingReaction добавляет временную реакцию к входящему сообщению Slack на время формирования ответа, а затем удаляет её после завершения. Используйте короткий код эмодзи Slack, например "hourglass_flowing_sand".
• channels.slack.execApprovals: нативная доставка клиенту подтверждений Slack и авторизация подтверждающего выполнение. Схема совпадает с Discord: enabled (true/false/"auto"), approvers (идентификаторы пользователей Slack), agentFilter, sessionFilter и target ("dm", "channel" или "both"). Подтверждения плагинов могут использовать этот нативный клиентский путь для запросов из Slack, когда удаётся определить подтверждающих плагина Slack; нативную доставку подтверждений плагинов в Slack также можно включить через approvals.plugin для сеансов из Slack или целей Slack. Для подтверждений плагинов используются подтверждающие плагина Slack из allowFrom и маршрутизация по умолчанию, а не подтверждающие выполнение.

​

Mattermost

openclaw plugins install @openclaw/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, // включается явно
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Необязательный явный URL для развёртываний с обратным прокси или публичным доступом
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
      textChunkLimit: 4000,
      streaming: { chunkMode: "length" },
    },
  },
}

• commands.callbackPath должен быть путём (например, /api/channels/mattermost/command), а не полным URL.
• commands.callbackUrl должен разрешаться в конечную точку Gateway OpenClaw и быть доступен с сервера 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 переопределяет выбор учётной записи по умолчанию, если совпадает с идентификатором настроенной учётной записи.

​

Signal

{
  channels: {
    signal: {
      enabled: true,
      account: "+15555550123", // необязательная привязка учётной записи
      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 переопределяет выбор учётной записи по умолчанию, если совпадает с идентификатором настроенной учётной записи.

​

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 переопределяет выбор учётной записи по умолчанию, если он совпадает с идентификатором настроенной учётной записи.
• Требуется полный доступ к диску для базы данных 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, прежде чем ожидать появления входящих медиафайлов в ходе работы агента.
• Восстановление входящих сообщений после перезапуска моста/Gateway выполняется автоматически (дедупликация по GUID и ограничение возраста устаревшей очереди). Существующие конфигурации channels.imessage.catchup.enabled: true по-прежнему поддерживаются как устаревший профиль совместимости; catchup по умолчанию отключён.
• channels.imessage.groups: реестр групп и настройки отдельных групп. При использовании groupPolicy: "allowlist" настройте либо явные ключи chat_id, либо запись с подстановочным знаком "*", чтобы групповые сообщения могли пройти проверку реестра.
• Записи верхнего уровня bindings[] с type: "acp" могут привязывать разговоры iMessage к постоянным сеансам ACP. В match.peer.id используйте нормализованный дескриптор или явную цель чата (chat_id:*, chat_guid:*, chat_identifier:*). Общая семантика полей: Агенты 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 разрешает частные/внутренние домашние серверы. proxy и это разрешение сетевого доступа являются независимыми средствами управления.
• channels.matrix.defaultAccount выбирает предпочтительную учётную запись в конфигурациях с несколькими учётными записями.
• По умолчанию channels.matrix.autoJoin имеет значение "off", поэтому приглашения в комнаты и новые приглашения в стиле личных сообщений игнорируются, пока не будет задан autoJoin: "allowlist" с autoJoinAllowlist или autoJoin: "always".
• channels.matrix.execApprovals: встроенная в Matrix доставка запросов на подтверждение выполнения и авторизация подтверждающих пользователей.
  • enabled: true, false или "auto" (по умолчанию). В автоматическом режиме подтверждения выполнения активируются, когда подтверждающих пользователей удаётся определить из approvers или commands.ownerAllowFrom.
  • approvers: идентификаторы пользователей Matrix (например, @owner:example.org), которым разрешено подтверждать запросы на выполнение.
  • agentFilter: необязательный список разрешённых идентификаторов агентов. Не указывайте его, чтобы пересылать подтверждения для всех агентов.
  • sessionFilter: необязательные шаблоны ключей сеансов (подстрока или регулярное выражение).
  • target: куда отправлять запросы на подтверждение. "dm" (по умолчанию), "channel" (исходная комната) или "both".
  • Переопределения для отдельных учётных записей: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope определяет, как личные сообщения Matrix группируются в сеансы: per-user (по умолчанию) использует общий сеанс для маршрутизированного собеседника, а per-room изолирует каждую комнату личных сообщений.
• Проверки состояния Matrix и оперативные запросы к каталогу используют ту же политику прокси, что и трафик среды выполнения.
• Полная конфигурация Matrix, правила выбора целей и примеры настройки описаны в Matrix.

​

Microsoft Teams

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // политики appId, appPassword, tenantId, webhook, команды/канала:
      // см. /channels/msteams
    },
  },
}

• Рассматриваемые здесь основные пути ключей: channels.msteams, channels.msteams.configWrites.
• Полная конфигурация Teams (учётные данные, webhook, политика личных сообщений/групп, переопределения для отдельных команд/каналов) описана в 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 переопределяет выбор учётной записи по умолчанию, если он совпадает с идентификатором настроенной учётной записи.
• Полная конфигурация канала IRC (хост/порт/TLS/каналы/списки разрешённых пользователей/проверка упоминаний) описана в разделе IRC.

​

Несколько учётных записей (все каналы)

{
  channels: {
    telegram: {
      accounts: {
        default: {
          name: "Основной бот",
          botToken: "123456:ABC...",
        },
        alerts: {
          name: "Бот оповещений",
          botToken: "987654:XYZ...",
        },
      },
    },
  },
}

• default используется, когда accountId не указан (CLI + маршрутизация).
• Токены из переменных среды применяются только к учётной записи по умолчанию.
• Базовые настройки канала применяются ко всем учётным записям, если не переопределены для конкретной учётной записи.
• Используйте bindings[].match.accountId, чтобы направить каждую учётную запись отдельному агенту.
• Если добавить учётную запись не по умолчанию через openclaw channels add (или первоначальную настройку канала), продолжая использовать конфигурацию канала верхнего уровня с одной учётной записью, OpenClaw сначала переносит относящиеся к учётной записи значения верхнего уровня из конфигурации одной учётной записи в карту учётных записей канала, чтобы исходная учётная запись продолжила работать. Большинство каналов перемещают их в channels.<channel>.accounts.default; Matrix вместо этого может сохранить существующую совпадающую именованную цель или цель по умолчанию.
• Существующие привязки только к каналу (без accountId) продолжают соответствовать учётной записи по умолчанию; привязки к конкретным учётным записям остаются необязательными.
• openclaw doctor --fix также исправляет смешанные структуры, перемещая относящиеся к учётной записи значения верхнего уровня из конфигурации одной учётной записи в назначенную для этого канала учётную запись. Большинство каналов используют accounts.default; Matrix вместо этого может сохранить существующую совпадающую именованную цель или цель по умолчанию.

​

Другие каналы-плагины

​

Проверка упоминаний в групповых чатах

• Упоминания в метаданных: нативные @-упоминания платформы. Игнорируются в режиме чата с самим собой в 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"] } }],
  },
}

​

Ограничения истории личных сообщений

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

​

Режим чата с самим собой

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

​

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

{
  commands: {
    native: "auto", // регистрировать нативные команды, если они поддерживаются
    nativeSkills: "auto", // регистрировать нативные команды Skills, если они поддерживаются
    text: true, // разбирать /команды в сообщениях чата
    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,
  },
}

​

Связанные разделы

• Справочник по конфигурации — ключи верхнего уровня
• Конфигурация — агенты
• Обзор каналов