2026 Канал Matrix в OpenClaw: плагин matrix-js-sdk, минимальная конфигурация, Mac cloud
Matrix — не один webhook: долгая синхронизация, токены, опциональное E2EE отличаются от Slack/Discord. Материал про интеграцию matrix-js-sdk, плагины, порядок от homeserver до прав в комнатах, процессы на Mac cloud и таблицу симптомов. Читать вместе с заметкой про DNS в Docker на VPSMAC, чтобы не ловить неверный уровень абстракции.
Содержание
1. Проблемы
Остановилась синхронизация — часами тишина. Личные токены для ботов ломают аудит и ротацию. E2EE без доверия устройств выглядит как сломанный плагин. В отличие от webhooks, членство и ACL напрямую влияют на доставку. Модель зелёная, Matrix красная — сначала очередь синхронизации и права, не LLM.
При перехвате TLS выравнивайте хранилища сертификатов и исключения прокси для процесса OpenClaw. Для федерации заранее согласуйте порты и фиксированные egress-IP облака.
2. Условия
Плагины и реестр собирают возможности; Matrix идёт через официальный SDK. Соблюдайте версию Node, фиксируйте релизы, бэкапьте ~/.openclaw. HTTPS_PROXY и NO_PROXY в той же среде, что и сервис. На Mac cloud — launchd и ротация логов; на staging разделяйте задержку модели и синхронизации. Не смешивайте крупные апдейты с breaking-изменениями SecretRef из других статей.
На сообщение Matrix больше состояния, чем у webhook — планируйте объём логов и retention. Горизонтальное масштабирование: не клонируйте один токен на конкурирующие инстансы.
3. Таблица
| Ось | Matrix SDK | Webhook |
|---|---|---|
| Связь | Долгая sync | Запрос/подписка |
| Секреты | Токен+устройство | URL/OAuth |
| Операции | Переподключение, лаг | 429 |
4. Пять шагов
Сначала сеть и личность, потом промпты; для дежурств — однострочный критерий успеха на шаг.
- Установить зафиксированную версию плагина
- HTTPS URL homeserver
- Токен бота в секретах
- Минимальная комната, простой текст
openclaw doctor, логи, политика перезапуска launchd
5. Метрики
- Верхняя граница лага синхронизации по E2E
- 429 на общем egress — шардировать или джиттер
- Ротация логов против полного диска
- 24 часа burn-in на staging
- Срок токена в runbook
- Мало RAM — конкуренция sync и инференса
- Матрица маршрутизации Slack/Matrix без коллизий
6. FAQ
Вместе со Slack? Разные секреты и метки логов; один канал за изменение.
| Симптом | Сначала | Потом |
|---|---|---|
| Нет входа | участие, sync | FW, прокси, TLS |
| Ошибка отправки | ACL, лимит | правила модели |
| Нестабильно | рестарт, RAM, диск | обслуживание сервера |
Откат: архив конфигурации; другие каналы без Matrix должны жить.
На дашбордах разделяйте задержки синхронизации и модели. Windows и лишние слои контейнеров дороги. Выделенный Mac cloud у VPSMAC согласуется с SSH и другими гайдами OpenClaw; пятиминутный деплой замыкает цикл.