Matrix

​

Установка

openclaw plugins install @openclaw/matrix

​

Настройка

1. Создайте учётную запись Matrix на своём домашнем сервере.
2. Настройте channels.matrix с помощью homeserver + accessToken или homeserver + userId + password.
3. Перезапустите Gateway.
4. Начните переписку с ботом в личных сообщениях или пригласите его в комнату. Новые приглашения принимаются, только если это разрешено параметром autoJoin.

​

Интерактивная настройка

openclaw channels add
openclaw configure --section channels

​

Минимальная конфигурация

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_xxx",
      dm: { policy: "pairing" },
    },
  },
}

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      userId: "@bot:example.org",
      password: "replace-me", // pragma: allowlist secret
      deviceName: "OpenClaw Gateway",
    },
  },
}

​

Автоматическое присоединение

{
  channels: {
    matrix: {
      autoJoin: "allowlist",
      autoJoinAllowlist: ["!ops:example.org", "#support:example.org"],
      groups: {
        "!ops:example.org": { requireMention: true },
      },
    },
  },
}

​

Форматы целей списка разрешённых значений

• Личные сообщения (dm.allowFrom, groupAllowFrom, groups.<room>.users): используйте @user:server. По умолчанию отображаемые имена игнорируются, поскольку они изменяемы; задавайте dangerouslyAllowNameMatching: true только для явной совместимости с отображаемыми именами.
• Ключи списка разрешённых комнат (groups, устаревший псевдоним rooms): используйте !room:server или #alias:server. Простые имена игнорируются, если не задано dangerouslyAllowNameMatching: true.
• Списки разрешённых приглашений (autoJoinAllowlist): используйте !room:server, #alias:server или *. Простые имена отклоняются всегда.

​

Нормализация идентификатора учётной записи

​

Кэшированные учётные данные

​

Переменные среды

​

Пример конфигурации

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_xxx",
      encryption: true,

      dm: {
        policy: "pairing",
        sessionScope: "per-room",
        threadReplies: "off",
      },

      groupPolicy: "allowlist",
      groupAllowFrom: ["@admin:example.org"],
      groups: {
        "!roomid:example.org": { requireMention: true },
      },

      autoJoin: "allowlist",
      autoJoinAllowlist: ["!roomid:example.org"],
      threadReplies: "inbound",
      replyToMode: "off",
      streaming: { mode: "partial" },
    },
  },
}

​

Потоковые предпросмотры

{
  channels: {
    matrix: {
      streaming: { mode: "partial" },
    },
  },
}

{
  channels: {
    matrix: {
      streaming: {
        mode: "partial",
        preview: {
          toolProgress: false,
        },
      },
    },
  },
}

{
  channels: {
    matrix: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto", // выбрать из настроенных или встроенных меток (false, чтобы скрыть)
          labels: ["Thinking", "Writing", "Searching"], // варианты для label: "auto"
          maxLines: 8, // максимальное число прокручиваемых строк хода выполнения (по умолчанию: 8)
          maxLineChars: 120, // максимальное число символов в строке до усечения (по умолчанию: 120)
          toolProgress: true, // показывать работу инструментов и ход выполнения (по умолчанию: true)
        },
      },
    },
  },
}

• progress.label: пользовательская метка; "auto"/не задано — выбрать настроенную или встроенную метку; false — скрыть её.
• progress.labels: варианты, используемые только тогда, когда label имеет значение "auto" или не задано.
• progress.maxLines: максимальное число прокручиваемых строк хода выполнения, сохраняемых в черновике; более старые строки сверх этого числа удаляются.
• progress.maxLineChars: максимальное число символов в компактной строке хода выполнения до усечения.
• progress.toolProgress: при значении true (по умолчанию) текущая работа инструментов и ход выполнения отображаются в черновике.

• Если предпросмотр превышает ограничение Matrix на размер одного события, OpenClaw прекращает потоковую передачу предпросмотра и переходит к отправке только окончательного результата.
• В ответах с медиафайлами вложения всегда отправляются обычным способом; если устаревший предпросмотр нельзя безопасно использовать повторно, OpenClaw удаляет его перед отправкой окончательного ответа с медиафайлом.
• При активной потоковой передаче предпросмотра обновления хода выполнения инструментов включены по умолчанию. Задайте streaming.preview.toolProgress: false, чтобы сохранить редактирование предпросмотра для текста ответа, но оставить ход выполнения инструментов в обычном канале доставки.
• Редактирование предпросмотра требует дополнительных вызовов API Matrix. Оставьте streaming.mode: "off" для наиболее консервативного профиля ограничений частоты запросов.
• Устаревшие скалярные и логические значения streaming, а также плоские ключи blockStreaming / chunkMode преобразуются в эту вложенную структуру командой openclaw doctor --fix.

​

Голосовые сообщения

• События m.audio и события m.file с MIME-типом audio/* подходят для обработки.
• В зашифрованных комнатах OpenClaw расшифровывает вложение через существующий путь обработки медиафайлов Matrix перед транскрибированием.
• В промпте агента транскрипция помечается как созданная машиной и недоверенная.
• Вложение помечается как уже транскрибированное, чтобы последующие инструменты обработки медиафайлов не транскрибировали его повторно.
• Установите tools.media.audio.enabled: false, чтобы глобально отключить транскрибирование аудио.

​

Метаданные подтверждений

​

Правила push-уведомлений для тихих финализированных предпросмотров при самостоятельном размещении

​

Комнаты для взаимодействия ботов

{
  channels: {
    matrix: {
      allowBots: "mentions", // true | "mentions"
      groups: {
        "!roomid:example.org": {
          requireMention: true,
        },
      },
    },
  },
}

• allowBots: true принимает сообщения от других настроенных учётных записей ботов Matrix в разрешённых комнатах и личных сообщениях.
• allowBots: "mentions" принимает такие сообщения в комнатах, только если в них явно упоминается этот бот; личные сообщения разрешены в любом случае.
• groups.<room>.allowBots переопределяет настройку уровня учётной записи для одной комнаты.
• Принятые сообщения от настроенных ботов используют общую защиту от циклов ботов. Настройте channels.defaults.botLoopProtection, а затем переопределите значение для отдельной учётной записи с помощью channels.matrix.botLoopProtection или для отдельной комнаты с помощью channels.matrix.groups.<room>.botLoopProtection.
• OpenClaw по-прежнему игнорирует сообщения от того же идентификатора пользователя Matrix, чтобы избежать циклов ответов самому себе.
• В Matrix нет нативного признака бота; OpenClaw считает сообщение «созданным ботом», если оно отправлено другой настроенной учётной записью Matrix на этом Gateway OpenClaw.

​

Шифрование и верификация

​

Включение шифрования

openclaw matrix encryption setup
printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix encryption setup --recovery-key-stdin

• --recovery-key-stdin считывает ключ восстановления из стандартного ввода, не раскрывая его в аргументах процесса; --recovery-key <key> остаётся доступным для совместимости
• --force-reset-cross-signing удаляет текущую идентичность перекрёстной подписи и создаёт новую (только для намеренного использования)

openclaw matrix account add \
  --homeserver https://matrix.example.org \
  --access-token syt_xxx \
  --enable-e2ee

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_xxx",
      encryption: true,
      dm: { policy: "pairing" },
    },
  },
}

​

Состояние и сигналы доверия

openclaw matrix verify status
openclaw matrix verify status --include-recovery-key --json

• Locally trusted: доверие установлено только этим клиентом
• Cross-signing verified: SDK сообщает о верификации посредством перекрёстной подписи
• Signed by owner: подписано собственным ключом самоподписи пользователя (только для диагностики)

​

Верификация этого устройства с помощью ключа восстановления

printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin

• Recovery key accepted: Matrix принял ключ для хранилища секретов или установления доверия к устройству.
• Backup usable: резервную копию ключей комнат можно загрузить с использованием доверенного материала восстановления.
• Device verified by owner: это устройство пользуется полным доверием идентичности перекрёстной подписи Matrix.

openclaw matrix verify self

​

Инициализация или восстановление перекрёстной подписи

openclaw matrix verify bootstrap

• инициализирует хранилище секретов, по возможности повторно используя существующий ключ восстановления
• инициализирует перекрёстную подпись и отправляет отсутствующие открытые ключи
• помечает и подписывает перекрёстной подписью текущее устройство
• создаёт серверную резервную копию ключей комнат, если она ещё не существует

• --recovery-key-stdin (используйте вместе с printf '%s\n' "$MATRIX_RECOVERY_KEY" | ...) или --recovery-key <key>
• --force-reset-cross-signing для удаления текущей идентичности перекрёстной подписи (только намеренно; требуется активный ключ восстановления, сохранённый или переданный с помощью --recovery-key-stdin)

​

Резервная копия ключей комнат

openclaw matrix verify backup status
printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin

openclaw matrix verify backup reset --yes

​

Просмотр, отправка и обработка запросов верификации

openclaw matrix verify list

openclaw matrix verify request --own-user
openclaw matrix verify request --user-id @ops:example.org --device-id ABCDEF

​

Примечания о нескольких учётных записях

openclaw matrix account add \
  --account assistant \
  --homeserver https://matrix.example.org \
  --user-id '@assistant:example.org' \
  --password '<password>' \
  --device-name OpenClaw-Gateway

openclaw matrix account add \
  --account assistant \
  --homeserver https://matrix.example.org \
  --access-token '<token>'

openclaw matrix devices list
openclaw matrix devices prune-stale

​

Управление профилем

openclaw matrix profile set --name "OpenClaw Assistant"
openclaw matrix profile set --avatar-url https://cdn.example.org/avatar.png

​

Ветки

​

Маршрутизация сеансов (sessionScope)

• "per-user" (по умолчанию): все комнаты личных сообщений с одним и тем же маршрутизируемым собеседником используют общий сеанс.
• "per-room": каждая комната личных сообщений Matrix получает собственный ключ сеанса, даже для одного и того же собеседника.

​

Ответы в ветках (threadReplies)

• "off": ответы публикуются на верхнем уровне. Входящие сообщения из веток остаются в родительском сеансе.
• "inbound": отвечать внутри ветки, только если входящее сообщение уже находилось в этой ветке.
• "always": отвечать внутри ветки, корнем которой является инициировавшее сообщение; начиная с первого инициирующего сообщения эта беседа маршрутизируется через соответствующий сеанс, ограниченный веткой.

​

Наследование веток и команды с косой чертой

• Входящие сообщения из веток включают корневое сообщение ветки как дополнительный контекст агента.
• Отправки инструментом сообщений автоматически наследуют текущую ветку Matrix при нацеливании на ту же комнату (или на того же пользователя личных сообщений), если явно не указан threadId.
• Повторное использование цели-пользователя личных сообщений применяется только тогда, когда метаданные текущего сеанса подтверждают того же собеседника личных сообщений в той же учётной записи Matrix; иначе OpenClaw возвращается к обычной маршрутизации, ограниченной пользователем.
• /focus, /unfocus, /agents, /session idle, /session max-age и привязанный к ветке /acp spawn работают в комнатах и личных сообщениях Matrix.
• Верхнеуровневый /focus создаёт новую ветку Matrix и привязывает её к целевому сеансу, если включён threadBindings.spawnSessions.
• Запуск /focus или /acp spawn --thread here внутри существующей ветки Matrix привязывает эту ветку на месте.

​

Привязки бесед ACP

• Запустите /acp spawn codex --bind here внутри личных сообщений, комнаты или существующей ветки Matrix, чтобы продолжить использование.
• В верхнеуровневых личных сообщениях или комнате текущие личные сообщения или комната остаются интерфейсом чата, а будущие сообщения маршрутизируются в созданный сеанс ACP.
• Внутри существующей ветки --bind here привязывает текущую ветку на месте.
• /new и /reset сбрасывают тот же привязанный сеанс ACP на месте.
• /acp close закрывает сеанс ACP и удаляет привязку.

​

Конфигурация привязки веток

• threadBindings.enabled
• threadBindings.idleHours
• threadBindings.maxAgeHours
• threadBindings.spawnSessions: управляет созданием веток как субагентами, так и ACP.
• threadBindings.spawnSubagentSessions / threadBindings.spawnAcpSessions: более узкие переопределения для создания веток только субагентами или только ACP.
• threadBindings.defaultSpawnContext

​

Реакции

• react добавляет реакцию к событию Matrix.
• reactions выводит текущую сводку реакций для события Matrix.
• emoji="" удаляет собственные реакции бота на это событие.
• remove: true удаляет у бота только указанную реакцию-эмодзи.

​

Контекст истории

• channels.matrix.historyLimit определяет, сколько последних сообщений комнаты включается как InboundHistory, когда сообщение комнаты инициирует агента. Резервно используется messages.groupChat.historyLimit; если оба значения не заданы, фактическое значение по умолчанию — 0 (отключено).
• История комнат Matrix ограничена комнатой; личные сообщения продолжают использовать обычную историю сеанса.
• История комнаты содержит только ожидающие сообщения: OpenClaw буферизует сообщения комнаты, которые ещё не инициировали ответ, а затем создаёт снимок этого окна при поступлении упоминания или другого инициирующего события.
• Текущее инициирующее сообщение не включается в InboundHistory; для этого хода оно остаётся в основном теле входящего сообщения.
• Повторные попытки обработки одного и того же события Matrix используют исходный снимок истории, а не смещаются вперёд к более новым сообщениям комнаты.

​

Видимость контекста

• contextVisibility: "all" используется по умолчанию. Дополнительный контекст сохраняется в полученном виде.
• contextVisibility: "allowlist" фильтрует дополнительный контекст, оставляя отправителей, разрешённых активными проверками списков разрешённых комнат и пользователей.
• contextVisibility: "allowlist_quote" работает подобно allowlist, но сохраняет одну явно указанную цитату ответа.

​

Политика личных сообщений и комнат

{
  channels: {
    matrix: {
      dm: {
        policy: "allowlist",
        allowFrom: ["@admin:example.org"],
        threadReplies: "off",
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["@admin:example.org"],
      groups: {
        "!roomid:example.org": { requireMention: true },
      },
    },
  },
}

{
  channels: {
    matrix: {
      dm: { enabled: false },
      groupPolicy: "allowlist",
      groupAllowFrom: ["@admin:example.org"],
    },
  },
}

openclaw pairing list matrix
openclaw pairing approve matrix <CODE>

​

Восстановление комнаты личных сообщений

openclaw matrix direct inspect --user-id @alice:example.org

openclaw matrix direct repair --user-id @alice:example.org

• предпочитает строгие личные сообщения 1:1, уже сопоставленные в m.direct
• резервно использует любые строгие личные сообщения 1:1 с этим пользователем, к которым выполнено текущее подключение
• создаёт новую комнату личных сообщений и перезаписывает m.direct, если работоспособных личных сообщений не существует

​

Одобрения выполнения

• enabled: доставлять запросы на одобрение через собственные запросы Matrix. Неустановленное значение или "auto" автоматически включает доставку, когда удаётся определить хотя бы одного одобряющего; установите false, чтобы явно отключить её.
• approvers: идентификаторы пользователей Matrix (@owner:example.org), которым разрешено одобрять запросы выполнения. Резервно используется channels.matrix.dm.allowFrom.
• target: куда отправлять запросы. "dm" (по умолчанию) отправляет их в личные сообщения одобряющих; "channel" отправляет в исходную комнату или личные сообщения; "both" отправляет в оба места.
• agentFilter / sessionFilter: необязательные списки разрешённых агентов и сеансов, которые инициируют доставку через Matrix.

• Одобрения выполнения используют execApprovals.approvers, резервно обращаясь к dm.allowFrom.
• Одобрения плагинов авторизуются только через dm.allowFrom.

• ✅ разрешить один раз
• ❌ отклонить
• ♾️ разрешать всегда (если это допускает действующая политика выполнения)

​

Слеш-команды

​

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

{
  channels: {
    matrix: {
      enabled: true,
      defaultAccount: "assistant",
      dm: { policy: "pairing" },
      accounts: {
        assistant: {
          homeserver: "https://matrix.example.org",
          accessToken: "syt_assistant_xxx",
          encryption: true,
        },
        alerts: {
          homeserver: "https://matrix.example.org",
          accessToken: "syt_alerts_xxx",
          dm: {
            policy: "allowlist",
            allowFrom: ["@ops:example.org"],
            threadReplies: "off",
          },
        },
      },
    },
  },
}

• Значения channels.matrix верхнего уровня используются как значения по умолчанию для именованных учётных записей, если они не переопределены в учётной записи.
• Чтобы ограничить унаследованную запись комнаты определённой учётной записью, используйте groups.<room>.account. Записи без account являются общими для всех учётных записей; account: "default" продолжает работать, когда учётная запись по умолчанию настроена на верхнем уровне.

• Задайте defaultAccount, чтобы выбрать именованную учётную запись, которой отдают предпочтение неявная маршрутизация, проверки и команды CLI.
• Если имеется несколько учётных записей и одна из них буквально называется default, OpenClaw неявно использует её, даже если defaultAccount не задан.
• Если имеется несколько именованных учётных записей, но учётная запись по умолчанию не выбрана, команды CLI не пытаются её угадать — задайте defaultAccount или передайте --account <id>.
• Блок channels.matrix.* верхнего уровня считается неявной учётной записью default только при полной настройке аутентификации (homeserver + accessToken или homeserver + userId + password). Именованные учётные записи остаются доступными для обнаружения по homeserver + userId, если сохранённых учётных данных достаточно для аутентификации.

• Когда OpenClaw во время исправления или настройки преобразует конфигурацию с одной учётной записью в конфигурацию с несколькими, он сохраняет существующую именованную учётную запись, если она имеется или на неё уже указывает defaultAccount. В преобразованную учётную запись перемещаются только ключи аутентификации и начальной настройки Matrix; общие ключи политики доставки остаются на верхнем уровне.

​

Частные и локальные домашние серверы

{
  channels: {
    matrix: {
      homeserver: "http://matrix-synapse:8008",
      network: {
        dangerouslyAllowPrivateNetwork: true,
      },
      accessToken: "syt_internal_xxx",
    },
  },
}

openclaw matrix account add \
  --account ops \
  --homeserver http://matrix-synapse:8008 \
  --allow-private-network \
  --access-token syt_ops_xxx

​

Проксирование трафика Matrix

{
  channels: {
    matrix: {
      homeserver: "https://matrix.example.org",
      accessToken: "syt_bot_xxx",
      proxy: "http://127.0.0.1:7890",
    },
  },
}

​

Разрешение адресатов

• Пользователи: @user:server, user:@user:server или matrix:user:@user:server
• Комнаты: !room:server, room:!room:server или matrix:room:!room:server
• Псевдонимы: #alias:server, channel:#alias:server или matrix:channel:#alias:server

• При поиске пользователей запрашивается каталог пользователей Matrix на соответствующем домашнем сервере.
• При поиске комнат явные идентификаторы и псевдонимы комнат принимаются напрямую. Поиск по именам комнат, в которые выполнено присоединение, выполняется по возможности и применяется только к рабочим спискам разрешённых комнат, когда задан dangerouslyAllowNameMatching: true.
• Если имя комнаты невозможно разрешить в идентификатор или псевдоним, оно игнорируется при разрешении рабочего списка разрешённых комнат.

​

Справочник по конфигурации

​

Учётная запись и подключение

• enabled: включение или отключение канала.
• name: необязательная отображаемая метка учётной записи.
• defaultAccount: предпочтительный идентификатор учётной записи, когда настроено несколько учётных записей Matrix.
• accounts: именованные переопределения для отдельных учётных записей. Значения channels.matrix верхнего уровня наследуются как значения по умолчанию.
• homeserver: URL домашнего сервера, например https://matrix.example.org.
• network.dangerouslyAllowPrivateNetwork: разрешает этой учётной записи подключаться к localhost, IP-адресам локальной сети или Tailscale либо внутренним именам хостов.
• proxy: необязательный URL прокси-сервера HTTP(S) для трафика Matrix. Поддерживается переопределение для отдельной учётной записи.
• userId: полный идентификатор пользователя Matrix (@bot:example.org).
• accessToken: токен доступа для аутентификации по токену. Поддерживаются значения в виде обычного текста и SecretRef от поставщиков переменных окружения, файлов и выполнения команд (управление секретами).
• password: пароль для входа с аутентификацией по паролю. Поддерживаются значения в виде обычного текста и SecretRef.
• deviceId: явно заданный идентификатор устройства Matrix.
• deviceName: отображаемое имя устройства, используемое при входе по паролю.
• avatarUrl: сохранённый URL собственного аватара для синхронизации профиля и обновлений profile set.
• initialSyncLimit: максимальное количество событий, получаемых при синхронизации во время запуска.

​

Шифрование

• encryption: включение E2EE. По умолчанию: false.
• startupVerification: "if-unverified" (по умолчанию при включённом E2EE) или "off". При запуске автоматически запрашивает самопроверку, если это устройство не проверено.
• startupVerificationCooldownHours: интервал ожидания перед следующим автоматическим запросом при запуске. По умолчанию: 24.

​

Доступ и политики

• groupPolicy: "open", "allowlist" или "disabled". По умолчанию: "allowlist".
• groupAllowFrom: список разрешённых идентификаторов пользователей для трафика комнат.
• mentionPatterns: ограниченные по области регулярные выражения для упоминаний в комнатах. Объект с { mode: "allow"|"deny", allowIn: [roomId, ...], denyIn: [roomId, ...] }. Определяет, применяются ли настроенные agents.list[].groupChat.mentionPatterns отдельно для каждой комнаты.
• dm.enabled: если установлено значение false, игнорировать все личные сообщения. По умолчанию: true.
• dm.policy: "pairing" (по умолчанию), "allowlist", "open" или "disabled". Применяется после того, как бот присоединился к комнате и классифицировал её как личный диалог; не влияет на обработку приглашений.
• dm.allowFrom: список разрешённых идентификаторов пользователей для трафика личных сообщений.
• dm.sessionScope: "per-user" (по умолчанию) или "per-room".
• dm.threadReplies: переопределение цепочек ответов только для личных сообщений ("off", "inbound", "always").
• allowBots: принимать сообщения от других настроенных учётных записей ботов Matrix (true или "mentions").
• allowlistOnly: если установлено значение true, принудительно устанавливает для всех активных политик личных сообщений (кроме "disabled") и групповых политик "open" значение "allowlist". Не изменяет политики "disabled".
• dangerouslyAllowNameMatching: если установлено значение true, разрешает поиск отображаемых имён в каталоге Matrix для записей списка разрешённых пользователей и поиск имён комнат, в которые выполнено присоединение, для ключей списка разрешённых комнат. Предпочтительно использовать полные идентификаторы @user:server, а также идентификаторы или псевдонимы комнат.
• autoJoin: "always", "allowlist" или "off". По умолчанию: "off". Применяется ко всем приглашениям Matrix, включая приглашения в личные диалоги.
• autoJoinAllowlist: комнаты и псевдонимы, разрешённые, когда autoJoin имеет значение "allowlist". Записи псевдонимов разрешаются через домашний сервер, а не через состояние, заявленное приглашающей комнатой.
• contextVisibility: видимость дополнительного контекста ("all" по умолчанию, "allowlist", "allowlist_quote").

​

Поведение ответов

• replyToMode: "off" (по умолчанию), "first", "all" или "batched".
• threadReplies: "off" (значение по умолчанию верхнего уровня разрешается в "inbound", если не задано явно), "inbound" или "always".
• threadBindings: переопределения для отдельных каналов, управляющие маршрутизацией и жизненным циклом сеансов, привязанных к веткам.
• streaming: вложенный объект { mode, chunkMode, block: { enabled, coalesce }, preview: { toolProgress }, progress: { label, labels, maxLines, maxLineChars, toolProgress } }. mode принимает значение "off" (по умолчанию), "partial", "quiet" или "progress". Устаревшие скалярные и логические варианты записи мигрируют с помощью openclaw doctor --fix.
• streaming.block.enabled: если задано значение true, завершённые блоки ассистента сохраняются как отдельные сообщения о ходе выполнения. По умолчанию: false.
• markdown: необязательная конфигурация отображения Markdown для исходящего текста.
• responsePrefix: необязательная строка, добавляемая в начало исходящих ответов.
• textChunkLimit: размер исходящего фрагмента в символах при значении streaming.chunkMode: "length". По умолчанию: 4000.
• streaming.chunkMode: "length" (по умолчанию, разделение по количеству символов) или "newline" (разделение по границам строк).
• historyLimit: количество последних сообщений комнаты, включаемых как InboundHistory, когда сообщение в комнате запускает агента. При отсутствии значения используется messages.groupChat.historyLimit; фактическое значение по умолчанию — 0 (отключено).
• mediaMaxMb: ограничение размера медиафайлов в МБ для исходящей отправки и обработки входящих данных. По умолчанию: 20.

​

Настройки реакций

• ackReaction: переопределение реакции подтверждения для этого канала или аккаунта.
• ackReactionScope: переопределение области действия ("group-mentions" по умолчанию, "group-all", "direct", "all", "none", "off").
• reactionNotifications: режим уведомлений о входящих реакциях ("own" по умолчанию, "off").

​

Инструменты и переопределения для отдельных комнат

• actions: управление доступом к инструментам для отдельных действий (messages, reactions, pins, profile, memberInfo, channelInfo, verification).
• groups: карта политик для отдельных комнат. После разрешения для идентификации сеанса используется стабильный идентификатор комнаты. (rooms — устаревший псевдоним.)
  • groups.<room>.account: ограничивает одну унаследованную запись комнаты указанным аккаунтом.
  • groups.<room>.enabled: переключатель для отдельной комнаты. При значении false комната игнорируется так, как если бы её не было в карте.
  • groups.<room>.requireMention: переопределение требования упоминания на уровне канала для отдельной комнаты.
  • groups.<room>.allowBots: переопределение настройки уровня канала для отдельной комнаты (true или "mentions").
  • groups.<room>.botLoopProtection: переопределение лимита защиты от циклов взаимодействия между ботами для отдельной комнаты.
  • groups.<room>.users: список разрешённых отправителей для отдельной комнаты.
  • groups.<room>.tools: переопределения разрешений и запретов инструментов для отдельной комнаты.
  • groups.<room>.autoReply: переопределение проверки упоминаний для отдельной комнаты. true отключает требования упоминания для этой комнаты; false снова принудительно включает их.
  • groups.<room>.skills: фильтр навыков для отдельной комнаты.
  • groups.<room>.systemPrompt: фрагмент системного запроса для отдельной комнаты.

​

Настройки подтверждения выполнения

• execApprovals.enabled: доставляет запросы на подтверждение выполнения через встроенные запросы Matrix.
• execApprovals.approvers: идентификаторы пользователей Matrix, которым разрешено подтверждение. При отсутствии значения используется dm.allowFrom.
• execApprovals.target: "dm" (по умолчанию), "channel" или "both".
• execApprovals.agentFilter / execApprovals.sessionFilter: необязательные списки разрешённых агентов или сеансов для доставки.

​

Связанные материалы

• Обзор каналов — все поддерживаемые каналы
• Сопряжение — аутентификация в личных сообщениях и процесс сопряжения
• Группы — поведение групповых чатов и проверка упоминаний
• Маршрутизация каналов — маршрутизация сообщений по сеансам
• Безопасность — модель доступа и усиление защиты