Матрица настройки

Агент Гермес интегрируется с Matrix — открытым федеративным протоколом обмена сообщениями. Matrix позволяет вам запускать небольшой домашний сервер или использовать общедоступный, например, Matrix.org — в любом случае вы сохраните контроль над своими сообщениями. Бот используется через Python SDK mautrix, обрабатывает сообщения через конвейер Hermes Agent (включая использование инструментов, память и рассуждения) и отвечает в кратчайшие сроки. Он поддерживает текст, файлы приложений, изображения, аудио, видео и опциональное сквозное шифрование (E2EE).

Hermes работает с любым домашним сервером Matrix — Synapse, Conduit, Dendrite или Matrix.org.

Перед настройкой вот та часть, которую большинство людей хотят знать: как Гермес ведет себя после подключения.

Как Гермес себя ведёт

По умолчанию:

• каждое личное сообщение получает свою сессию
• Ваша ветка получает свое пространство имён сессии
• Каждый пользователь в общей комнате получает свою сессию внутри этой комнаты.

Это контролируется в config.yaml:

group_sessions_per_user: true

Установите «false», только если вы явно хотите один общий разговор для всей комнаты:

group_sessions_per_user: false

Общее заседание может быть полезно для совместной работы в зале, но также означают:

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

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

Вы можете использовать дублирование и создание рук через переменное окружение или config.yaml:

matrix:
  require_mention: true           # Требовать @упоминание в комнатах (по умолчанию: true)
  free_response_rooms:            # Комнаты, освобождённые от требования упоминания
    - "!abc123:matrix.org"
  auto_thread: true               # Автоматически создавать ветки для ответов (по умолчанию: true)
  dm_mention_threads: false       # Создавать ветку при @упоминании в личных сообщениях (по умолчанию: false)

Или через переменные окружения:

MATRIX_REQUIRE_MENTION=true
MATRIX_FREE_RESPONSE_ROOMS=!abc123:matrix.org,!def456:matrix.org
MATRIX_AUTO_THREAD=true
MATRIX_DM_MENTION_THREADS=false
MATRIX_REACTIONS=true          # по умолчанию: true — реакции эмодзи во время обработки
```<div class="admonition admonition-tip"><p class="admonition-title">💡 Tip</p> Отключение света
`MATRIX_REACTIONS=false` отключает Режим эмодзи жизненного цикла обработки (👀/ ✅/❌), который бот публикует во входящих сообщениях. Полезно для комнат, где события создают шум или не обращают внимания на всех присутствующих клиентов.::::::примечание
Если вы обновляетесь с версией, в которой не было `MATRIX_REQUIRE_MENTION`, предварительно проверьте все сообщения в комнатах. Чтобы убедиться в этом, установите `MATRIX_REQUIRE_MENTION=false`.</div>
Это руководство проведет вас через весь процесс настройки — от создания учетной записи бота до отправки первого сообщения.

## Шаг 1: Создайте учётную запись бота

Вам нужна учётная запись пользователя Matrix для бота. Есть несколько способов это сделать:

### Вариант A: Зарегистрируйтесь на своем домашнем сервере (рекомендуется)

Если вы запускаете свой домашний сервер (синапс, канал, дендрит):

1. Воспользуйтесь API администратора или инструментом регистрации для создания нового пользователя:
```bash
# Пример для Synapse
register_new_matrix_user -c /etc/synapse/homeserver.yaml http://localhost:8008

1. Выберите имя пользователя, например hermes — полный идентификатор пользователя будет @hermes:your-server.org.

Вариант B: Используйте Matrix.org или другой публичный домашний сервер

1. Перейдите в Element Web и создайте новую учётную запись.
2. Выберите имя пользователя для вашего бота (например, hermes-bot).

Вариант C: Используйте свою собственную учётную запись

Вы также можете запустить Hermes от имени своего пользователя. Это означает, что бот публикует сообщения от вашего имени — полезно для финансовых ассистентов.

Шаг 2: Получение токена доступа

Гермесу нужен токен доступа для аутентификации на домашнем пространстве. У вас есть два телефона:

Вариант A: Доступ к токену (рекомендуется)

Самый надёжный способ получить токен:

Через Элемент: 1. Войдите в Element с учётной записью бота. 2. Перейдите в ** Настройки → Справка и о программе. 3. Прокрутите вниз и разверните Дополнительно — там отображается токен доступа. 4. Скопируйте его немедленно.**

Через API:

curl -X POST https://your-server/_matrix/client/v3/login \
  -H "Content-Type: application/json" \
  -d '{
    "type": "m.login.password",
    "user": "@hermes:your-server.org",
    "password": "your-password"
  }'

Ответ содержит поле access_token — скопируйте его.:::предупреждение[Храните токен доступа в безопасность] Токен доступа предоставляет полный доступ к учетной записи бота Matrix. Никогда не делитесь им публично и не сохраняйте в Git. В случае компрометации отзовите его, выйдя из всех сессий для этого пользователя.