Integracja OpenClaw z Matrix — szyfrowanie i pokoje

Wprowadzenie

Matrix to wbudowana wtyczka kanałowa OpenClaw, korzystająca z oficjalnego matrix-js-sdk. Obsługuje wiadomości bezpośrednie, pokoje, wątki, media, reakcje, ankiety, dane lokalizacyjne oraz szyfrowanie end-to-end (E2EE). Wtyczka jest dołączona do standardowych wydań OpenClaw.

Instalacja

W aktualnych wydaniach wtyczka jest wbudowana. Dla starszych lub niestandardowych buildów:

openclaw plugins install @openclaw/matrix

Konfiguracja uwierzytelniania

Skonfiguruj sekcję channels.matrix z danymi homeservera i danymi uwierzytelniającymi. Dostępne metody:

• Token dostępowy: homeserver + accessToken
• Hasło: homeserver + userId + password

Interaktywny kreator konfiguracji zapyta o adres homeservera, preferowaną metodę uwierzytelniania, opcjonalną nazwę urządzenia, włączenie E2EE i politykę dostępu do pokoi.

Szyfrowanie end-to-end

Włącz E2EE ustawieniem encryption: true. Wtyczka automatycznie wykrywa zaszyfrowane pokoje i dostosowuje obsługę obrazów (używając thumbnail_file dla zaszyfrowanych pokojów).

Zarządzanie weryfikacją

Komendy do zarządzania stanem zaufania E2EE:

• openclaw matrix verify status — sprawdź status weryfikacji urządzenia
• openclaw matrix verify bootstrap — zainicjalizuj konfigurację szyfrowania
• openclaw matrix verify device — zweryfikuj urządzenie kluczem odzyskiwania
• openclaw matrix devices prune-stale — usuń stare, nieaktywne urządzenia

Weryfikacja oznacza, że urządzenie jest „zweryfikowane przez właściciela" przez cross-signing — nie tylko lokalnie zaufane.

Automatyczne dołączanie do pokoi

Ustawienie autoJoin kontroluje przyjmowanie zaproszeń:

• off (domyślny) — bot nie dołącza do nowych pokoi automatycznie
• allowlist — dołącza tylko do pokoi z listy dozwolonych
• always — dołącza do każdego zaproszenia

Polityka DM i pokoi

Oddzielne listy kontrolują, kto może pisać bezpośrednio, a kto w pokojach grupowych. Polityka grupowa (groupPolicy) może być ustawiona na open, allowlist lub disabled.

Proces parowania DM:

openclaw pairing list matrix
openclaw pairing approve matrix KOD

Wątki i sesje

• sessionScope — określa, czy DM są per-użytkownik czy per-pokój
• threadReplies — kontroluje umiejscowienie odpowiedzi: off (najwyższy poziom), inbound (tylko w wątkach), always (zawsze w wątkach)
• Powiązania wątków (thread bindings) umożliwiają trwałe przestrzenie robocze ACP bez zmiany interfejsu czatu

Streaming podglądu odpowiedzi

Streaming jest opcjonalny, aktywowany ustawieniem streaming:

• off — standardowe zachowanie, czeka na pełną odpowiedź
• partial — edytowalny szkic aktualizowany w czasie rzeczywistym
• quiet — podgląd bez powiadomień (wymaga niestandardowych reguł push)

Opcja blockStreaming tworzy oddzielne wiadomości dla ukończonych bloków tekstu.

Komunikacja bot-bot

Ustaw allowBots: true (wszystkie wiadomości) lub allowBots: "mentions" (tylko wzmianki w pokojach), aby pozwolić na komunikację z innymi kontami Matrix OpenClaw.

Zatwierdzenia wykonania

Natywny routing zatwierdzeń wysyła monity do DM lub kanałów zatwierdzającego. Zatwierdzający potwierdzają reakcjami: ✅ (zezwól), ❌ (odmów), ♾️ (zawsze zezwalaj) lub komendami slash.

Konfiguracja wielokontowa

Skonfiguruj wiele kont Matrix pod accounts.<accountId> z nadpisaniami per konto. Ustaw defaultAccount, aby wskazać, które konto jest domyślnie używane przez komendy CLI.

Prywatne sieci

Domyślnie dostęp do prywatnych/LAN homeserverów jest zablokowany ze względów bezpieczeństwa. Włącz per konto przez: network.dangerouslyAllowPrivateNetwork: true.