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 @OmeniaClaw/matrix
• kanał pozostaje matrix
• konfiguracja pozostaje w channels.matrix
• zapisane w pamięci podręcznej poświadczenia pozostają w ~/.OmeniaClaw/credentials/matrix/
• stan środowiska uruchomieniowego pozostaje w ~/.OmeniaClaw/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 OmeniaClaw doctor --fix, OmeniaClaw próbuje automatycznie naprawić stary stan Matrix. Zanim jakikolwiek wykonalny krok migracji Matrix zmodyfikuje stan na dysku, OmeniaClaw tworzy albo ponownie używa ukierunkowanej migawki odzyskiwania.

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

• instalacje ze źródeł uruchamiają OmeniaClaw 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 OmeniaClaw update --no-restart, migracja Matrix wspierana przez uruchomienie zostanie odroczona do czasu, gdy później uruchomisz OmeniaClaw doctor --fix i zrestartujesz Gateway

Automatyczna migracja obejmuje:

• utworzenie albo ponowne użycie migawki sprzed migracji w ~/Backups/OmeniaClaw-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:

• OmeniaClaw zapisuje plik znacznika w ~/.OmeniaClaw/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, OmeniaClaw nie tworzy jeszcze migawki, ponieważ żadna mutacja Matrix nie jest wykonalna.
• Jeśli krok migawki się nie powiedzie, OmeniaClaw pomija migrację Matrix w tym przebiegu zamiast modyfikować stan bez punktu odzyskiwania.

Informacje o aktualizacjach wielokontowych:

• najstarszy płaski magazyn Matrix (~/.OmeniaClaw/matrix/bot-storage.json i ~/.OmeniaClaw/matrix/crypto/) pochodził z układu pojedynczego magazynu, więc OmeniaClaw 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.

OmeniaClaw 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 OmeniaClaw 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

1. Zaktualizuj OmeniaClaw i plugin Matrix w normalny sposób. Preferuj zwykłe OmeniaClaw update bez --no-restart, aby uruchomienie mogło natychmiast zakończyć migrację Matrix.

2. Uruchom:

   OmeniaClaw doctor --fix

   Jeśli Matrix ma wykonalne zadania migracji, doctor najpierw utworzy albo ponownie użyje migawki sprzed migracji i wypisze ścieżkę archiwum.

3. Uruchom lub zrestartuj Gateway.

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

   OmeniaClaw matrix verify statusOmeniaClaw matrix verify backup status

5. 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.

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

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

7. Jeśli to urządzenie nadal jest niezweryfikowane, uruchom polecenie dla odpowiedniego konta:

   printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify device --recovery-key-stdinprintf '%s\n' "$MATRIX_RECOVERY_KEY_ASSISTANT" | OmeniaClaw 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:

   OmeniaClaw 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.

8. Jeśli celowo porzucasz niemożliwą do odzyskania starą historię i chcesz świeżej bazowej kopii zapasowej dla przyszłych wiadomości, uruchom:

   OmeniaClaw matrix verify backup reset --yes

9. Jeśli kopia zapasowa kluczy po stronie serwera jeszcze nie istnieje, utwórz ją na potrzeby przyszłego odzyskiwania:

   OmeniaClaw matrix verify bootstrap

Jak działa migracja szyfrowana

Migracja szyfrowana jest procesem dwuetapowym:

1. Uruchomienie albo OmeniaClaw doctor --fix tworzy lub ponownie używa migawki sprzed migracji, jeśli migracja szyfrowana jest wykonalna.
2. Uruchomienie albo OmeniaClaw doctor --fix sprawdza stary magazyn kryptograficzny Matrix przez aktywną instalację pluginu Matrix.
3. Jeśli zostanie znaleziony klucz deszyfrujący kopię zapasową, OmeniaClaw zapisuje go w nowym przepływie klucza odzyskiwania i oznacza przywracanie kluczy pokojów jako oczekujące.
4. Przy następnym uruchomieniu Matrix OmeniaClaw 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, OmeniaClaw 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: OmeniaClaw 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: OmeniaClaw 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 OmeniaClaw 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 OmeniaClaw 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: OmeniaClaw 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 OmeniaClaw 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: OmeniaClaw 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 OmeniaClaw 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 OmeniaClaw 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: OmeniaClaw 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 OmeniaClaw doctor --fix.

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

• Znaczenie: OmeniaClaw 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 OmeniaClaw 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 OmeniaClaw 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 OmeniaClaw 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: OmeniaClaw 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 OmeniaClaw 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: OmeniaClaw 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 OmeniaClaw doctor --fix albo zrestartuj Gateway.

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

• Znaczenie: OmeniaClaw 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 (OmeniaClaw plugins install @OmeniaClaw/matrix albo OmeniaClaw plugins install ./path/to/local/matrix-plugin dla checkoutu repozytorium), a następnie ponownie uruchom OmeniaClaw doctor --fix albo zrestartuj Gateway.

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

• Znaczenie: OmeniaClaw 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 OmeniaClaw 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 "OmeniaClaw doctor --fix".

• Znaczenie: OmeniaClaw 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 OmeniaClaw 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. OmeniaClaw 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ą OmeniaClaw plugins install @OmeniaClaw/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 "OmeniaClaw matrix verify backup restore --recovery-key-stdin" after upgrade if they have the recovery key.

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

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

• Znaczenie: OmeniaClaw znalazł stary szyfrowany magazyn, ale nie mógł sprawdzić go wystarczająco bezpiecznie, aby przygotować odzyskiwanie.
• Co zrobić: ponownie uruchom OmeniaClaw 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" | OmeniaClaw 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: OmeniaClaw 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 OmeniaClaw matrix verify backup status, a następnie w razie potrzeby spróbuj ponownie za pomocą printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify backup restore --recovery-key-stdin.

Komunikaty ręcznego odzyskiwania

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

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

Store a recovery key with 'OmeniaClaw matrix verify device --recovery-key-stdin', then run 'OmeniaClaw 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" | OmeniaClaw matrix verify device --recovery-key-stdin, a następnie przywróć kopię zapasową.

Backup key mismatch on this device. Re-run 'OmeniaClaw 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" | OmeniaClaw 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ą OmeniaClaw 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 'OmeniaClaw 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" | OmeniaClaw 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" | OmeniaClaw 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: OmeniaClaw 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 OmeniaClaw 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" | OmeniaClaw 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ą OmeniaClaw matrix verify backup status.

Matrix crypto backend cannot load backup keys from secret storage. Verify this device with 'OmeniaClaw 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" | OmeniaClaw 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ą OmeniaClaw plugins install @OmeniaClaw/matrix albo, jeśli uruchamiasz z checkoutu repozytorium, OmeniaClaw plugins install ./path/to/local/matrix-plugin.

Jeśli szyfrowana historia nadal nie wraca

Uruchom te kontrole po kolei:

OmeniaClaw matrix verify status --verboseOmeniaClaw matrix verify backup status --verboseprintf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw 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:

OmeniaClaw matrix verify backup reset --yesOmeniaClaw matrix verify backup status --verboseOmeniaClaw 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.