Mainstream messaging

Migracja Matrixa

Uaktualnij poprzedni publiczny plugin matrix do bieżącej implementacji.

Dla większości użytkowników aktualizacja odbywa się w miejscu:

plugin pozostaje @openclaw/matrix
kanał pozostaje matrix
konfiguracja pozostaje w channels.matrix
zapisane w pamięci podręcznej poświadczenia pozostają w ~/.openclaw/credentials/matrix/
stan środowiska uruchomieniowego pozostaje w ~/.openclaw/matrix/

Nie musisz zmieniać nazw kluczy konfiguracji ani ponownie instalować pluginu pod nową nazwą.

Co migracja robi automatycznie

Gdy Gateway się uruchamia oraz gdy uruchamiasz openclaw doctor --fix, OpenClaw próbuje automatycznie naprawić stary stan Matrix. Zanim jakikolwiek wykonalny krok migracji Matrix zmodyfikuje stan na dysku, OpenClaw tworzy albo ponownie używa ukierunkowanej migawki odzyskiwania.

Gdy używasz openclaw update, dokładny wyzwalacz zależy od sposobu instalacji OpenClaw:

instalacje ze źródeł uruchamiają openclaw doctor --fix podczas procesu aktualizacji, a następnie domyślnie restartują Gateway
instalacje przez menedżer pakietów aktualizują pakiet, uruchamiają nieinteraktywny przebieg doctor, a następnie polegają na domyślnym restarcie Gateway, aby uruchomienie mogło zakończyć migrację Matrix
jeśli użyjesz openclaw update --no-restart, migracja Matrix wspierana przez uruchomienie zostanie odroczona do czasu, gdy później uruchomisz openclaw doctor --fix i zrestartujesz Gateway

Automatyczna migracja obejmuje:

utworzenie albo ponowne użycie migawki sprzed migracji w ~/Backups/openclaw-migrations/
ponowne użycie zapisanych w pamięci podręcznej poświadczeń Matrix
zachowanie tego samego wyboru konta i konfiguracji channels.matrix
przeniesienie najstarszego płaskiego magazynu synchronizacji Matrix do bieżącej lokalizacji z zakresem konta
przeniesienie najstarszego płaskiego magazynu kryptograficznego Matrix do bieżącej lokalizacji z zakresem konta, gdy konto docelowe można bezpiecznie ustalić
wyodrębnienie wcześniej zapisanego klucza deszyfrującego kopię zapasową kluczy pokojów Matrix ze starego magazynu kryptograficznego rust, gdy ten klucz istnieje lokalnie
ponowne użycie najbardziej kompletnego istniejącego katalogu głównego magazynu skrótu tokenu dla tego samego konta Matrix, homeservera i użytkownika, gdy token dostępu później się zmieni
skanowanie sąsiednich katalogów głównych magazynu skrótu tokenu w poszukiwaniu oczekujących metadanych przywracania stanu szyfrowanego, gdy token dostępu Matrix się zmienił, ale tożsamość konta/urządzenia pozostała ta sama
przywrócenie zapisanych w kopii zapasowej kluczy pokojów do nowego magazynu kryptograficznego przy następnym uruchomieniu Matrix

Szczegóły migawki:

OpenClaw zapisuje plik znacznika w ~/.openclaw/matrix/migration-snapshot.json po pomyślnym utworzeniu migawki, aby późniejsze przebiegi uruchamiania i naprawy mogły ponownie użyć tego samego archiwum.
Te automatyczne migawki migracji Matrix obejmują kopię zapasową tylko konfiguracji i stanu (includeWorkspace: false).
Jeśli Matrix ma tylko stan migracji z ostrzeżeniami, na przykład dlatego, że nadal brakuje userId lub accessToken, OpenClaw nie tworzy jeszcze migawki, ponieważ żadna mutacja Matrix nie jest wykonalna.
Jeśli krok migawki się nie powiedzie, OpenClaw pomija migrację Matrix w tym przebiegu zamiast modyfikować stan bez punktu odzyskiwania.

Informacje o aktualizacjach wielokontowych:

najstarszy płaski magazyn Matrix (~/.openclaw/matrix/bot-storage.json i ~/.openclaw/matrix/crypto/) pochodził z układu pojedynczego magazynu, więc OpenClaw może zmigrować go tylko do jednego ustalonego celu konta Matrix
istniejące starsze magazyny Matrix z zakresem konta są wykrywane i przygotowywane osobno dla każdego skonfigurowanego konta Matrix

Czego migracja nie może zrobić automatycznie

Poprzedni publiczny plugin Matrix nie tworzył automatycznie kopii zapasowych kluczy pokojów Matrix. Utrwalał lokalny stan kryptograficzny i żądał weryfikacji urządzenia, ale nie gwarantował, że klucze pokojów są zapisane w kopii zapasowej na homeserverze.

Oznacza to, że niektóre instalacje szyfrowane można zmigrować tylko częściowo.

OpenClaw nie może automatycznie odzyskać:

lokalnych kluczy pokojów, które nigdy nie zostały zapisane w kopii zapasowej
stanu szyfrowanego, gdy docelowego konta Matrix nie można jeszcze ustalić, ponieważ homeserver, userId lub accessToken nadal są niedostępne
automatycznej migracji jednego współdzielonego płaskiego magazynu Matrix, gdy skonfigurowano wiele kont Matrix, ale channels.matrix.defaultAccount nie jest ustawione
niestandardowych instalacji pluginu ze ścieżki, które są przypięte do ścieżki repozytorium zamiast standardowego pakietu Matrix
brakującego klucza odzyskiwania, gdy stary magazyn miał klucze zapisane w kopii zapasowej, ale nie przechowywał lokalnie klucza deszyfrującego

Bieżący zakres ostrzeżeń:

niestandardowe instalacje pluginu Matrix ze ścieżki są zgłaszane zarówno przez uruchamianie Gateway, jak i przez openclaw doctor

Jeśli stara instalacja miała lokalną szyfrowaną historię, która nigdy nie została zapisana w kopii zapasowej, część starszych szyfrowanych wiadomości może pozostać nieczytelna po aktualizacji.

Zalecany przebieg aktualizacji

Zaktualizuj OpenClaw i plugin Matrix w normalny sposób. Preferuj zwykłe openclaw update bez --no-restart, aby uruchomienie mogło natychmiast zakończyć migrację Matrix.
Uruchom:
```
openclaw doctor --fix
```
Jeśli Matrix ma wykonalne zadania migracji, doctor najpierw utworzy albo ponownie użyje migawki sprzed migracji i wypisze ścieżkę archiwum.
Uruchom lub zrestartuj Gateway.

Sprawdź bieżący stan weryfikacji i kopii zapasowej:

openclaw matrix verify status
openclaw matrix verify backup status

Umieść klucz odzyskiwania dla naprawianego konta Matrix w zmiennej środowiskowej specyficznej dla konta. Dla jednego domyślnego konta wystarczy MATRIX_RECOVERY_KEY. Dla wielu kont użyj jednej zmiennej na konto, na przykład MATRIX_RECOVERY_KEY_ASSISTANT, i dodaj --account assistant do polecenia.

Jeśli OpenClaw poinformuje, że potrzebny jest klucz odzyskiwania, uruchom polecenie dla odpowiedniego konta:

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

Jeśli to urządzenie nadal jest niezweryfikowane, uruchom polecenie dla odpowiedniego konta:
```
printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin
printf '%s\n' "$MATRIX_RECOVERY_KEY_ASSISTANT" | openclaw matrix verify device --recovery-key-stdin --account assistant
```
Jeśli klucz odzyskiwania zostanie zaakceptowany, a kopia zapasowa jest użyteczna, ale Cross-signing verified nadal ma wartość no, dokończ samoweryfikację z innego klienta Matrix:
```
openclaw matrix verify self
```
Zaakceptuj żądanie w innym kliencie Matrix, porównaj emoji albo liczby dziesiętne i wpisz yes tylko wtedy, gdy się zgadzają. Polecenie kończy się powodzeniem dopiero po tym, jak Cross-signing verified przyjmie wartość yes.
Jeśli celowo porzucasz niemożliwą do odzyskania starą historię i chcesz świeżej bazowej kopii zapasowej dla przyszłych wiadomości, uruchom:
```
openclaw matrix verify backup reset --yes
```
Jeśli kopia zapasowa kluczy po stronie serwera jeszcze nie istnieje, utwórz ją na potrzeby przyszłego odzyskiwania:
```
openclaw matrix verify bootstrap
```

Jak działa migracja szyfrowana

Migracja szyfrowana jest procesem dwuetapowym:

Uruchomienie albo openclaw doctor --fix tworzy lub ponownie używa migawki sprzed migracji, jeśli migracja szyfrowana jest wykonalna.
Uruchomienie albo openclaw doctor --fix sprawdza stary magazyn kryptograficzny Matrix przez aktywną instalację pluginu Matrix.
Jeśli zostanie znaleziony klucz deszyfrujący kopię zapasową, OpenClaw zapisuje go w nowym przepływie klucza odzyskiwania i oznacza przywracanie kluczy pokojów jako oczekujące.
Przy następnym uruchomieniu Matrix OpenClaw automatycznie przywraca zapisane w kopii zapasowej klucze pokojów do nowego magazynu kryptograficznego.

Jeśli stary magazyn zgłasza klucze pokojów, które nigdy nie zostały zapisane w kopii zapasowej, OpenClaw ostrzega zamiast udawać, że odzyskiwanie się powiodło.

Typowe komunikaty i ich znaczenie

Komunikaty aktualizacji i wykrywania

Matrix plugin upgraded in place.

Znaczenie: stary stan Matrix na dysku został wykryty i zmigrowany do bieżącego układu.
Co zrobić: nic, chyba że ten sam wynik zawiera również ostrzeżenia.

Matrix migration snapshot created before applying Matrix upgrades.

Znaczenie: OpenClaw utworzył archiwum odzyskiwania przed zmodyfikowaniem stanu Matrix.
Co zrobić: zachowaj wypisaną ścieżkę archiwum, dopóki nie potwierdzisz, że migracja się powiodła.

Matrix migration snapshot reused before applying Matrix upgrades.

Znaczenie: OpenClaw znalazł istniejący znacznik migawki migracji Matrix i ponownie użył tego archiwum zamiast tworzyć zduplikowaną kopię zapasową.
Co zrobić: zachowaj wypisaną ścieżkę archiwum, dopóki nie potwierdzisz, że migracja się powiodła.

Legacy Matrix state detected at ... but channels.matrix is not configured yet.

Znaczenie: istnieje stary stan Matrix, ale OpenClaw nie może przypisać go do bieżącego konta Matrix, ponieważ Matrix nie jest skonfigurowany.
Co zrobić: skonfiguruj channels.matrix, a następnie ponownie uruchom openclaw doctor --fix albo zrestartuj Gateway.

Legacy Matrix state detected at ... but the new account-scoped target could not be resolved yet (need homeserver, userId, and access token for channels.matrix...).

Znaczenie: OpenClaw znalazł stary stan, ale nadal nie może określić dokładnego bieżącego katalogu głównego konta/urządzenia.
Co zrobić: uruchom Gateway raz z działającym logowaniem Matrix albo ponownie uruchom openclaw doctor --fix po pojawieniu się zapisanych w pamięci podręcznej poświadczeń.

Legacy Matrix state detected at ... but multiple Matrix accounts are configured and channels.matrix.defaultAccount is not set.

Znaczenie: OpenClaw znalazł jeden współdzielony płaski magazyn Matrix, ale odmawia zgadywania, które nazwane konto Matrix powinno go otrzymać.
Co zrobić: ustaw channels.matrix.defaultAccount na zamierzone konto, a następnie ponownie uruchom openclaw doctor --fix albo zrestartuj Gateway.

Matrix legacy sync store not migrated because the target already exists (...)

Znaczenie: nowa lokalizacja z zakresem konta ma już magazyn synchronizacji lub magazyn kryptograficzny, więc OpenClaw nie nadpisał jej automatycznie.
Co zrobić: sprawdź, czy bieżące konto jest właściwe, zanim ręcznie usuniesz albo przeniesiesz kolidujący cel.

Failed migrating Matrix legacy sync store (...) albo Failed migrating Matrix legacy crypto store (...)

Znaczenie: OpenClaw próbował przenieść stary stan Matrix, ale operacja systemu plików się nie powiodła.
Co zrobić: sprawdź uprawnienia systemu plików i stan dysku, a następnie ponownie uruchom openclaw doctor --fix.

Legacy Matrix encrypted state detected at ... but channels.matrix is not configured yet.

Znaczenie: OpenClaw znalazł stary szyfrowany magazyn Matrix, ale nie ma bieżącej konfiguracji Matrix, do której można go dołączyć.
Co zrobić: skonfiguruj channels.matrix, a następnie ponownie uruchom openclaw doctor --fix albo zrestartuj Gateway.

Legacy Matrix encrypted state detected at ... but the account-scoped target could not be resolved yet (need homeserver, userId, and access token for channels.matrix...).

Znaczenie: szyfrowany magazyn istnieje, ale OpenClaw nie może bezpiecznie zdecydować, do którego bieżącego konta/urządzenia należy.
Co zrobić: uruchom Gateway raz z działającym logowaniem Matrix albo ponownie uruchom openclaw doctor --fix, gdy zapisane w pamięci podręcznej poświadczenia będą dostępne.

Legacy Matrix encrypted state detected at ... but multiple Matrix accounts are configured and channels.matrix.defaultAccount is not set.

Znaczenie: OpenClaw znalazł jeden współdzielony płaski starszy magazyn kryptograficzny, ale odmawia zgadywania, które nazwane konto Matrix powinno go otrzymać.
Co zrobić: ustaw channels.matrix.defaultAccount na zamierzone konto, a następnie ponownie uruchom openclaw doctor --fix albo zrestartuj Gateway.

Matrix migration warnings are present, but no on-disk Matrix mutation is actionable yet. No pre-migration snapshot was needed.

Znaczenie: OpenClaw wykrył stary stan Matrix, ale migracja nadal jest zablokowana przez brakujące dane tożsamości lub poświadczeń.
Co zrobić: dokończ logowanie Matrix albo konfigurację, a następnie ponownie uruchom openclaw doctor --fix albo zrestartuj Gateway.

Legacy Matrix encrypted state was detected, but the Matrix plugin helper is unavailable. Install or repair @openclaw/matrix so OpenClaw can inspect the old rust crypto store before upgrading.

Znaczenie: OpenClaw znalazł stary szyfrowany stan Matrix, ale nie mógł załadować punktu wejścia pomocnika z pluginu Matrix, który zwykle sprawdza ten magazyn.
Co zrobić: zainstaluj ponownie albo napraw plugin Matrix (openclaw plugins install @openclaw/matrix albo openclaw plugins install ./path/to/local/matrix-plugin dla checkoutu repozytorium), a następnie ponownie uruchom openclaw doctor --fix albo zrestartuj Gateway.

Matrix plugin helper path is unsafe: ... Reinstall @openclaw/matrix and try again.

Znaczenie: OpenClaw znalazł ścieżkę pliku pomocniczego, która wychodzi poza katalog główny pluginu lub nie przechodzi kontroli granic pluginu, więc odmówił jej zaimportowania.
Co zrobić: zainstaluj ponownie plugin Matrix z zaufanej ścieżki, a następnie ponownie uruchom openclaw doctor --fix albo zrestartuj gateway.

- Failed creating a Matrix migration snapshot before repair: ...

- Skipping Matrix migration changes for now. Resolve the snapshot failure, then rerun "openclaw doctor --fix".

Znaczenie: OpenClaw odmówił modyfikacji stanu Matrix, ponieważ najpierw nie mógł utworzyć migawki odzyskiwania.
Co zrobić: rozwiąż błąd kopii zapasowej, a następnie ponownie uruchom openclaw doctor --fix albo zrestartuj gateway.

Failed migrating legacy Matrix client storage: ...

Znaczenie: awaryjny mechanizm po stronie klienta Matrix znalazł starą płaską pamięć, ale przeniesienie się nie powiodło. OpenClaw teraz przerywa ten mechanizm awaryjny zamiast po cichu uruchamiać się ze świeżym magazynem.
Co zrobić: sprawdź uprawnienia systemu plików lub konflikty, zachowaj stary stan bez zmian i spróbuj ponownie po naprawieniu błędu.

Matrix is installed from a custom path: ...

Znaczenie: Matrix jest przypięty do instalacji ze ścieżki, więc aktualizacje głównej linii nie zastępują go automatycznie standardowym pakietem Matrix z repozytorium.
Co zrobić: zainstaluj ponownie za pomocą openclaw plugins install @openclaw/matrix, gdy chcesz wrócić do domyślnego pluginu Matrix.

Komunikaty odzyskiwania stanu szyfrowanego

matrix: restored X/Y room key(s) from legacy encrypted-state backup

Znaczenie: zapisane w kopii zapasowej klucze pokojów zostały pomyślnie przywrócone do nowego magazynu kryptograficznego.
Co zrobić: zwykle nic.

matrix: N legacy local-only room key(s) were never backed up and could not be restored automatically

Znaczenie: część starych kluczy pokojów istniała tylko w starym magazynie lokalnym i nigdy nie została przesłana do kopii zapasowej Matrix.
Co zrobić: spodziewaj się, że część starej szyfrowanej historii pozostanie niedostępna, chyba że możesz ręcznie odzyskać te klucze z innego zweryfikowanego klienta.

Legacy Matrix encrypted state for account "..." has backed-up room keys, but no local backup decryption key was found. Ask the operator to run "openclaw matrix verify backup restore --recovery-key-stdin" after upgrade if they have the recovery key.

Znaczenie: kopia zapasowa istnieje, ale OpenClaw nie mógł automatycznie odzyskać klucza odzyskiwania.
Co zrobić: uruchom printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin.

Failed inspecting legacy Matrix encrypted state for account "..." (...): ...

Znaczenie: OpenClaw znalazł stary szyfrowany magazyn, ale nie mógł sprawdzić go wystarczająco bezpiecznie, aby przygotować odzyskiwanie.
Co zrobić: ponownie uruchom openclaw doctor --fix. Jeśli problem się powtarza, zachowaj stary katalog stanu bez zmian i odzyskaj dane przy użyciu innego zweryfikowanego klienta Matrix oraz printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin.

Legacy Matrix backup key was found for account "...", but .../recovery-key.json already contains a different recovery key. Leaving the existing file unchanged.

Znaczenie: OpenClaw wykrył konflikt kluczy kopii zapasowej i odmówił automatycznego nadpisania bieżącego pliku klucza odzyskiwania.
Co zrobić: sprawdź, który klucz odzyskiwania jest poprawny, zanim ponowisz jakiekolwiek polecenie przywracania.

Legacy Matrix encrypted state for account "..." cannot be fully converted automatically because the old rust crypto store does not expose all local room keys for export.

Znaczenie: to twarde ograniczenie starego formatu magazynu.
Co zrobić: klucze z kopii zapasowej nadal można przywrócić, ale szyfrowana historia dostępna tylko lokalnie może pozostać niedostępna.

matrix: failed restoring room keys from legacy encrypted-state backup: ...

Znaczenie: nowy plugin próbował przywrócić dane, ale Matrix zwrócił błąd.
Co zrobić: uruchom openclaw matrix verify backup status, a następnie w razie potrzeby spróbuj ponownie za pomocą printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin.

Komunikaty ręcznego odzyskiwania

Backup key is not loaded on this device. Run 'openclaw matrix verify backup restore' to load it and restore old room keys.

Znaczenie: OpenClaw wie, że powinieneś mieć klucz kopii zapasowej, ale nie jest on aktywny na tym urządzeniu.
Co zrobić: uruchom openclaw matrix verify backup restore albo ustaw MATRIX_RECOVERY_KEY i w razie potrzeby uruchom printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin.

Store a recovery key with 'openclaw matrix verify device --recovery-key-stdin', then run 'openclaw matrix verify backup restore'.

Znaczenie: to urządzenie nie ma obecnie zapisanego klucza odzyskiwania.
Co zrobić: ustaw MATRIX_RECOVERY_KEY, uruchom printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin, a następnie przywróć kopię zapasową.

Backup key mismatch on this device. Re-run 'openclaw matrix verify device --recovery-key-stdin' with the matching recovery key.

Znaczenie: zapisany klucz nie pasuje do aktywnej kopii zapasowej Matrix.
Co zrobić: ustaw MATRIX_RECOVERY_KEY na poprawny klucz i uruchom printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin.

Jeśli akceptujesz utratę nieodzyskiwalnej starej szyfrowanej historii, możesz zamiast tego zresetować bieżącą bazę kopii zapasowej za pomocą openclaw matrix verify backup reset --yes. Gdy zapisany sekret kopii zapasowej jest uszkodzony, ten reset może też odtworzyć magazyn sekretów, aby nowy klucz kopii zapasowej mógł poprawnie wczytać się po restarcie.

Backup trust chain is not verified on this device. Re-run 'openclaw matrix verify device --recovery-key-stdin'.

Znaczenie: kopia zapasowa istnieje, ale to urządzenie jeszcze nie ufa wystarczająco mocno łańcuchowi podpisywania krzyżowego.
Co zrobić: ustaw MATRIX_RECOVERY_KEY i uruchom printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin.

Matrix recovery key is required

Znaczenie: próbowano wykonać krok odzyskiwania bez podania klucza odzyskiwania, gdy był on wymagany.
Co zrobić: uruchom polecenie ponownie z --recovery-key-stdin, na przykład printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin.

Invalid Matrix recovery key: ...

Znaczenie: podanego klucza nie można było sparsować albo nie pasował do oczekiwanego formatu.
Co zrobić: spróbuj ponownie z dokładnym kluczem odzyskiwania z klienta Matrix albo z pliku klucza odzyskiwania.

Matrix recovery key was applied, but this device still lacks full Matrix identity trust.

Znaczenie: OpenClaw mógł zastosować klucz odzyskiwania, ale Matrix nadal nie ustanowił pełnego zaufania tożsamości podpisywania krzyżowego dla tego urządzenia. Sprawdź wynik polecenia pod kątem Recovery key accepted, Backup usable, Cross-signing verified i Device verified by owner.
Co zrobić: uruchom openclaw matrix verify self, zaakceptuj żądanie w innym kliencie Matrix, porównaj SAS i wpisz yes tylko wtedy, gdy się zgadza. Polecenie czeka na pełne zaufanie tożsamości Matrix przed zgłoszeniem powodzenia. Użyj printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify bootstrap --recovery-key-stdin --force-reset-cross-signing tylko wtedy, gdy celowo chcesz zastąpić bieżącą tożsamość podpisywania krzyżowego.

Matrix key backup is not active on this device after loading from secret storage.

Znaczenie: magazyn sekretów nie utworzył aktywnej sesji kopii zapasowej na tym urządzeniu.
Co zrobić: najpierw zweryfikuj urządzenie, a potem sprawdź ponownie za pomocą openclaw matrix verify backup status.

Matrix crypto backend cannot load backup keys from secret storage. Verify this device with 'openclaw matrix verify device --recovery-key-stdin' first.

Znaczenie: to urządzenie nie może przywracać z magazynu sekretów, dopóki weryfikacja urządzenia nie zostanie ukończona.
Co zrobić: najpierw uruchom printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin.

Komunikaty instalacji niestandardowego pluginu

Matrix is installed from a custom path that no longer exists: ...

Znaczenie: rekord instalacji pluginu wskazuje lokalną ścieżkę, która już nie istnieje.
Co zrobić: zainstaluj ponownie za pomocą openclaw plugins install @openclaw/matrix albo, jeśli uruchamiasz z checkoutu repozytorium, openclaw plugins install ./path/to/local/matrix-plugin.

Jeśli szyfrowana historia nadal nie wraca

Uruchom te kontrole po kolei:

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

Jeśli kopia zapasowa przywraca się pomyślnie, ale w części starych pokojów nadal brakuje historii, brakujące klucze prawdopodobnie nigdy nie zostały zapisane w kopii zapasowej przez poprzedni plugin.

Jeśli chcesz zacząć od nowa dla przyszłych wiadomości

Jeśli akceptujesz utratę nieodzyskiwalnej starej szyfrowanej historii i chcesz tylko mieć czystą bazę kopii zapasowej na przyszłość, uruchom te polecenia po kolei:

openclaw matrix verify backup reset --yes
openclaw matrix verify backup status --verbose
openclaw matrix verify status

Jeśli urządzenie nadal jest potem niezweryfikowane, dokończ weryfikację z klienta Matrix, porównując emoji SAS albo kody dziesiętne i potwierdzając, że się zgadzają.

Powiązane

Matrix: konfiguracja kanału.
Reguły push Matrix: kierowanie powiadomień.
Doctor: kontrola stanu i wyzwalacz automatycznej migracji.
Przewodnik migracji: wszystkie ścieżki migracji (przenoszenie maszyn, importy między systemami).
Plugins: instalacja i rejestracja pluginów.

# Co migracja robi automatycznie

# Czego migracja nie może zrobić automatycznie

# Zalecany przebieg aktualizacji

# Jak działa migracja szyfrowana

# Typowe komunikaty i ich znaczenie

# Komunikaty aktualizacji i wykrywania

# Komunikaty odzyskiwania stanu szyfrowanego

# Komunikaty ręcznego odzyskiwania

# Komunikaty instalacji niestandardowego pluginu

# Jeśli szyfrowana historia nadal nie wraca

# Jeśli chcesz zacząć od nowa dla przyszłych wiadomości

# Powiązane