English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Mainstream messaging

Matrix-Migration

Aktualisieren Sie vom vorherigen öffentlichen matrix-Plugin auf die aktuelle Implementierung.

Für die meisten Benutzer erfolgt das Upgrade direkt:

  • das Plugin bleibt @openclaw/matrix
  • der Kanal bleibt matrix
  • Ihre Konfiguration bleibt unter channels.matrix
  • zwischengespeicherte Anmeldedaten bleiben unter ~/.openclaw/credentials/matrix/
  • Laufzeitstatus bleibt unter ~/.openclaw/matrix/

Sie müssen keine Konfigurationsschlüssel umbenennen oder das Plugin unter einem neuen Namen neu installieren.

Was die Migration automatisch erledigt

Wenn der Gateway startet und wenn Sie openclaw doctor --fix ausführen, versucht OpenClaw, alten Matrix-Status automatisch zu reparieren. Bevor ein ausführbarer Matrix-Migrationsschritt den Status auf dem Datenträger verändert, erstellt oder verwendet OpenClaw einen gezielten Wiederherstellungs-Snapshot.

Wenn Sie openclaw update verwenden, hängt der genaue Auslöser davon ab, wie OpenClaw installiert ist:

  • Quellinstallationen führen während des Update-Ablaufs openclaw doctor --fix aus und starten den Gateway anschließend standardmäßig neu
  • Paketmanager-Installationen aktualisieren das Paket, führen einen nicht interaktiven Doctor-Durchlauf aus und verlassen sich dann auf den standardmäßigen Gateway-Neustart, damit der Start die Matrix-Migration abschließen kann
  • wenn Sie openclaw update --no-restart verwenden, wird die startgestützte Matrix-Migration aufgeschoben, bis Sie später openclaw doctor --fix ausführen und den Gateway neu starten

Die automatische Migration umfasst:

  • Erstellen oder Wiederverwenden eines Vor-Migrations-Snapshots unter ~/Backups/openclaw-migrations/
  • Wiederverwenden Ihrer zwischengespeicherten Matrix-Anmeldedaten
  • Beibehalten derselben Kontoauswahl und channels.matrix-Konfiguration
  • Verschieben des ältesten flachen Matrix-Sync-Stores an den aktuellen kontobezogenen Speicherort
  • Verschieben des ältesten flachen Matrix-Crypto-Stores an den aktuellen kontobezogenen Speicherort, wenn das Zielkonto sicher aufgelöst werden kann
  • Extrahieren eines zuvor gespeicherten Entschlüsselungsschlüssels für Matrix-Room-Key-Backups aus dem alten Rust-Crypto-Store, wenn dieser Schlüssel lokal vorhanden ist
  • Wiederverwenden des vollständigsten vorhandenen Token-Hash-Speicherstamms für dasselbe Matrix-Konto, denselben Homeserver und denselben Benutzer, wenn sich das Zugriffstoken später ändert
  • Durchsuchen benachbarter Token-Hash-Speicherstämme nach ausstehenden Wiederherstellungsmetadaten für verschlüsselten Status, wenn sich das Matrix-Zugriffstoken geändert hat, die Konto-/Geräteidentität aber gleich geblieben ist
  • Wiederherstellen gesicherter Room Keys im neuen Crypto Store beim nächsten Matrix-Start

Snapshot-Details:

  • OpenClaw schreibt nach einem erfolgreichen Snapshot eine Markierungsdatei nach ~/.openclaw/matrix/migration-snapshot.json, damit spätere Start- und Reparaturdurchläufe dasselbe Archiv wiederverwenden können.
  • Diese automatischen Matrix-Migrations-Snapshots sichern nur Konfiguration + Status (includeWorkspace: false).
  • Wenn Matrix nur Migrationstatus mit Warnungen hat, zum Beispiel weil userId oder accessToken noch fehlt, erstellt OpenClaw den Snapshot noch nicht, weil keine Matrix-Mutation ausführbar ist.
  • Wenn der Snapshot-Schritt fehlschlägt, überspringt OpenClaw die Matrix-Migration für diesen Lauf, statt Status ohne Wiederherstellungspunkt zu verändern.

Zu Upgrades mit mehreren Konten:

  • der älteste flache Matrix-Store (~/.openclaw/matrix/bot-storage.json und ~/.openclaw/matrix/crypto/) stammt aus einem Layout mit einem einzelnen Store, daher kann OpenClaw ihn nur in ein aufgelöstes Matrix-Kontoziel migrieren
  • bereits kontobezogene alte Matrix-Stores werden erkannt und pro konfiguriertem Matrix-Konto vorbereitet

Was die Migration nicht automatisch erledigen kann

Das vorherige öffentliche Matrix-Plugin hat Matrix-Room-Key-Backups nicht automatisch erstellt. Es hat lokalen Crypto-Status persistiert und Geräteverifizierung angefordert, aber nicht garantiert, dass Ihre Room Keys auf dem Homeserver gesichert wurden.

Das bedeutet, dass einige verschlüsselte Installationen nur teilweise migriert werden können.

OpenClaw kann Folgendes nicht automatisch wiederherstellen:

  • nur lokal vorhandene Room Keys, die nie gesichert wurden
  • verschlüsselten Status, wenn das Ziel-Matrix-Konto noch nicht aufgelöst werden kann, weil homeserver, userId oder accessToken weiterhin nicht verfügbar sind
  • automatische Migration eines gemeinsam genutzten flachen Matrix-Stores, wenn mehrere Matrix-Konten konfiguriert sind, aber channels.matrix.defaultAccount nicht gesetzt ist
  • Installationen mit benutzerdefiniertem Plugin-Pfad, die an einen Repository-Pfad statt an das Standard-Matrix-Paket gebunden sind
  • einen fehlenden Wiederherstellungsschlüssel, wenn der alte Store gesicherte Schlüssel hatte, den Entschlüsselungsschlüssel aber nicht lokal behalten hat

Aktueller Warnungsumfang:

  • Installationen mit benutzerdefiniertem Matrix-Plugin-Pfad werden sowohl beim Gateway-Start als auch durch openclaw doctor angezeigt

Wenn Ihre alte Installation nur lokal vorhandenen verschlüsselten Verlauf hatte, der nie gesichert wurde, bleiben einige ältere verschlüsselte Nachrichten nach dem Upgrade möglicherweise unlesbar.

Empfohlener Upgrade-Ablauf

  1. Aktualisieren Sie OpenClaw und das Matrix-Plugin wie gewohnt. Bevorzugen Sie schlichtes openclaw update ohne --no-restart, damit der Start die Matrix-Migration sofort abschließen kann.

  2. Führen Sie Folgendes aus:

    openclaw doctor --fix

    Wenn Matrix ausführbare Migrationsarbeit hat, erstellt oder verwendet Doctor zuerst den Vor-Migrations-Snapshot und gibt den Archivpfad aus.

  3. Starten Sie den Gateway oder starten Sie ihn neu.

  4. Prüfen Sie den aktuellen Verifizierungs- und Backup-Status:

    openclaw matrix verify status
openclaw matrix verify backup status

  5. Legen Sie den Wiederherstellungsschlüssel für das Matrix-Konto, das Sie reparieren, in einer kontospezifischen Umgebungsvariable ab. Für ein einzelnes Standardkonto ist MATRIX_RECOVERY_KEY in Ordnung. Für mehrere Konten verwenden Sie eine Variable pro Konto, zum Beispiel MATRIX_RECOVERY_KEY_ASSISTANT, und fügen dem Befehl --account assistant hinzu.

  6. Wenn OpenClaw Ihnen mitteilt, dass ein Wiederherstellungsschlüssel benötigt wird, führen Sie den Befehl für das passende Konto aus:

    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

  7. Wenn dieses Gerät weiterhin unverifiziert ist, führen Sie den Befehl für das passende Konto aus:

    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

    Wenn der Wiederherstellungsschlüssel akzeptiert wird und das Backup nutzbar ist, Cross-signing verified aber weiterhin no ist, schließen Sie die Selbstverifizierung von einem anderen Matrix-Client aus ab:

    openclaw matrix verify self

    Akzeptieren Sie die Anfrage in einem anderen Matrix-Client, vergleichen Sie die Emojis oder Dezimalzahlen und geben Sie yes nur ein, wenn sie übereinstimmen. Der Befehl wird nur erfolgreich beendet, nachdem Cross-signing verified zu yes wird.

  8. Wenn Sie nicht wiederherstellbaren alten Verlauf bewusst aufgeben und eine neue Backup-Basislinie für zukünftige Nachrichten möchten, führen Sie Folgendes aus:

    openclaw matrix verify backup reset --yes

  9. Wenn noch kein serverseitiges Schlüssel-Backup vorhanden ist, erstellen Sie eines für zukünftige Wiederherstellungen:

    openclaw matrix verify bootstrap

Wie die verschlüsselte Migration funktioniert

Die verschlüsselte Migration ist ein zweistufiger Prozess:

  1. Start oder openclaw doctor --fix erstellt oder verwendet den Vor-Migrations-Snapshot, wenn verschlüsselte Migration ausführbar ist.
  2. Start oder openclaw doctor --fix untersucht den alten Matrix-Crypto-Store über die aktive Matrix-Plugin-Installation.
  3. Wenn ein Backup-Entschlüsselungsschlüssel gefunden wird, schreibt OpenClaw ihn in den neuen Wiederherstellungsschlüssel-Ablauf und markiert die Room-Key-Wiederherstellung als ausstehend.
  4. Beim nächsten Matrix-Start stellt OpenClaw gesicherte Room Keys automatisch im neuen Crypto Store wieder her.

Wenn der alte Store Room Keys meldet, die nie gesichert wurden, warnt OpenClaw, statt vorzugeben, die Wiederherstellung sei erfolgreich gewesen.

Häufige Meldungen und ihre Bedeutung

Upgrade- und Erkennungsmeldungen

Matrix plugin upgraded in place.

  • Bedeutung: Der alte Matrix-Status auf dem Datenträger wurde erkannt und in das aktuelle Layout migriert.
  • Vorgehen: nichts, sofern dieselbe Ausgabe keine Warnungen enthält.

Matrix migration snapshot created before applying Matrix upgrades.

  • Bedeutung: OpenClaw hat ein Wiederherstellungsarchiv erstellt, bevor Matrix-Status verändert wurde.
  • Vorgehen: Bewahren Sie den ausgegebenen Archivpfad auf, bis Sie bestätigt haben, dass die Migration erfolgreich war.

Matrix migration snapshot reused before applying Matrix upgrades.

  • Bedeutung: OpenClaw hat eine vorhandene Matrix-Migrations-Snapshot-Markierung gefunden und dieses Archiv wiederverwendet, statt ein doppeltes Backup zu erstellen.
  • Vorgehen: Bewahren Sie den ausgegebenen Archivpfad auf, bis Sie bestätigt haben, dass die Migration erfolgreich war.

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

  • Bedeutung: Alter Matrix-Status ist vorhanden, aber OpenClaw kann ihn keinem aktuellen Matrix-Konto zuordnen, weil Matrix nicht konfiguriert ist.
  • Vorgehen: Konfigurieren Sie channels.matrix und führen Sie dann erneut openclaw doctor --fix aus oder starten Sie den Gateway neu.

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

  • Bedeutung: OpenClaw hat alten Status gefunden, kann den genauen aktuellen Konto-/Gerätestamm aber weiterhin nicht bestimmen.
  • Vorgehen: Starten Sie den Gateway einmal mit einer funktionierenden Matrix-Anmeldung oder führen Sie erneut openclaw doctor --fix aus, nachdem zwischengespeicherte Anmeldedaten vorhanden sind.

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

  • Bedeutung: OpenClaw hat einen gemeinsam genutzten flachen Matrix-Store gefunden, weigert sich aber zu raten, welches benannte Matrix-Konto ihn erhalten soll.
  • Vorgehen: Setzen Sie channels.matrix.defaultAccount auf das beabsichtigte Konto und führen Sie dann erneut openclaw doctor --fix aus oder starten Sie den Gateway neu.

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

  • Bedeutung: Der neue kontobezogene Speicherort hat bereits einen Sync- oder Crypto-Store, daher hat OpenClaw ihn nicht automatisch überschrieben.
  • Vorgehen: Prüfen Sie, dass das aktuelle Konto das richtige ist, bevor Sie das kollidierende Ziel manuell entfernen oder verschieben.

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

  • Bedeutung: OpenClaw hat versucht, alten Matrix-Status zu verschieben, aber die Dateisystemoperation ist fehlgeschlagen.
  • Vorgehen: Prüfen Sie Dateisystemberechtigungen und Datenträgerstatus und führen Sie dann erneut openclaw doctor --fix aus.

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

  • Bedeutung: OpenClaw hat einen alten verschlüsselten Matrix-Store gefunden, aber es gibt keine aktuelle Matrix-Konfiguration, an die er angehängt werden kann.
  • Vorgehen: Konfigurieren Sie channels.matrix und führen Sie dann erneut openclaw doctor --fix aus oder starten Sie den Gateway neu.

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

  • Bedeutung: Der verschlüsselte Store ist vorhanden, aber OpenClaw kann nicht sicher entscheiden, zu welchem aktuellen Konto/Gerät er gehört.
  • Vorgehen: Starten Sie den Gateway einmal mit einer funktionierenden Matrix-Anmeldung oder führen Sie erneut openclaw doctor --fix aus, nachdem zwischengespeicherte Anmeldedaten verfügbar sind.

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

  • Bedeutung: OpenClaw hat einen gemeinsam genutzten flachen alten Crypto Store gefunden, weigert sich aber zu raten, welches benannte Matrix-Konto ihn erhalten soll.
  • Vorgehen: Setzen Sie channels.matrix.defaultAccount auf das beabsichtigte Konto und führen Sie dann erneut openclaw doctor --fix aus oder starten Sie den Gateway neu.

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

  • Bedeutung: OpenClaw hat alten Matrix-Status erkannt, aber die Migration wird weiterhin durch fehlende Identitäts- oder Anmeldedaten blockiert.
  • Vorgehen: Schließen Sie die Matrix-Anmeldung oder Konfigurationseinrichtung ab und führen Sie dann erneut openclaw doctor --fix aus oder starten Sie den Gateway neu.

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.

  • Bedeutung: OpenClaw hat alten verschlüsselten Matrix-Status gefunden, konnte aber den Helper-Einstiegspunkt aus dem Matrix-Plugin nicht laden, der diesen Store normalerweise untersucht.
  • Vorgehen: Installieren oder reparieren Sie das Matrix-Plugin (openclaw plugins install @openclaw/matrix oder openclaw plugins install ./path/to/local/matrix-plugin für einen Repository-Checkout) und führen Sie dann erneut openclaw doctor --fix aus oder starten Sie den Gateway neu.

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

  • Bedeutung: OpenClaw hat einen Hilfsdateipfad gefunden, der das Plugin-Root verlässt oder Plugin-Grenzprüfungen nicht besteht, daher wurde der Import verweigert.
  • Vorgehen: Installieren Sie das Matrix-Plugin aus einem vertrauenswürdigen Pfad neu und führen Sie anschließend erneut openclaw doctor --fix aus oder starten Sie das Gateway neu.

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

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

  • Bedeutung: OpenClaw hat Änderungen am Matrix-Status verweigert, weil zuerst kein Wiederherstellungs-Snapshot erstellt werden konnte.
  • Vorgehen: Beheben Sie den Backup-Fehler und führen Sie anschließend erneut openclaw doctor --fix aus oder starten Sie das Gateway neu.

Failed migrating legacy Matrix client storage: ...

  • Bedeutung: Der clientseitige Matrix-Fallback hat alten flachen Speicher gefunden, aber das Verschieben ist fehlgeschlagen. OpenClaw bricht diesen Fallback jetzt ab, anstatt stillschweigend mit einem frischen Speicher zu starten.
  • Vorgehen: Prüfen Sie Dateisystemberechtigungen oder Konflikte, lassen Sie den alten Status intakt und versuchen Sie es nach Behebung des Fehlers erneut.

Matrix is installed from a custom path: ...

  • Bedeutung: Matrix ist auf eine Pfadinstallation festgelegt, daher ersetzen Mainline-Updates es nicht automatisch durch das standardmäßige Matrix-Paket des Repos.
  • Vorgehen: Installieren Sie mit openclaw plugins install @openclaw/matrix neu, wenn Sie zum Standard-Matrix-Plugin zurückkehren möchten.

Wiederherstellungsmeldungen für verschlüsselten Status

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

  • Bedeutung: Gesicherte Raum-Schlüssel wurden erfolgreich im neuen Crypto-Speicher wiederhergestellt.
  • Vorgehen: Normalerweise ist nichts zu tun.

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

  • Bedeutung: Einige alte Raum-Schlüssel existierten nur im alten lokalen Speicher und waren nie in das Matrix-Backup hochgeladen worden.
  • Vorgehen: Rechnen Sie damit, dass ein Teil des alten verschlüsselten Verlaufs nicht verfügbar bleibt, sofern Sie diese Schlüssel nicht manuell von einem anderen verifizierten Client wiederherstellen können.

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.

  • Bedeutung: Das Backup existiert, aber OpenClaw konnte den Wiederherstellungsschlüssel nicht automatisch wiederherstellen.
  • Vorgehen: Führen Sie printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin aus.

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

  • Bedeutung: OpenClaw hat den alten verschlüsselten Speicher gefunden, konnte ihn aber nicht sicher genug prüfen, um die Wiederherstellung vorzubereiten.
  • Vorgehen: Führen Sie erneut openclaw doctor --fix aus. Wenn sich der Fehler wiederholt, lassen Sie das alte Statusverzeichnis intakt und stellen Sie die Daten mit einem anderen verifizierten Matrix-Client sowie printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin wieder her.

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

  • Bedeutung: OpenClaw hat einen Backup-Schlüssel-Konflikt erkannt und verweigert das automatische Überschreiben der aktuellen recovery-key-Datei.
  • Vorgehen: Prüfen Sie, welcher Wiederherstellungsschlüssel korrekt ist, bevor Sie einen Wiederherstellungsbefehl erneut versuchen.

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.

  • Bedeutung: Dies ist die harte Grenze des alten Speicherformats.
  • Vorgehen: Gesicherte Schlüssel können weiterhin wiederhergestellt werden, aber nur lokal vorhandener verschlüsselter Verlauf kann unverfügbar bleiben.

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

  • Bedeutung: Das neue Plugin hat die Wiederherstellung versucht, aber Matrix hat einen Fehler zurückgegeben.
  • Vorgehen: Führen Sie openclaw matrix verify backup status aus und versuchen Sie es bei Bedarf erneut mit printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin.

Manuelle Wiederherstellungsmeldungen

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

  • Bedeutung: OpenClaw weiß, dass Sie einen Backup-Schlüssel haben sollten, er ist auf diesem Gerät aber nicht aktiv.
  • Vorgehen: Führen Sie openclaw matrix verify backup restore aus oder setzen Sie MATRIX_RECOVERY_KEY und führen Sie bei Bedarf printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin aus.

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

  • Bedeutung: Auf diesem Gerät ist derzeit kein Wiederherstellungsschlüssel gespeichert.
  • Vorgehen: Setzen Sie MATRIX_RECOVERY_KEY, führen Sie printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin aus und stellen Sie anschließend das Backup wieder her.

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

  • Bedeutung: Der gespeicherte Schlüssel stimmt nicht mit dem aktiven Matrix-Backup überein.
  • Vorgehen: Setzen Sie MATRIX_RECOVERY_KEY auf den korrekten Schlüssel und führen Sie printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin aus.

Wenn Sie den Verlust nicht wiederherstellbaren alten verschlüsselten Verlaufs akzeptieren, können Sie stattdessen die aktuelle Backup-Baseline mit openclaw matrix verify backup reset --yes zurücksetzen. Wenn das gespeicherte Backup-Geheimnis beschädigt ist, kann dieses Zurücksetzen auch den geheimen Speicher neu erstellen, damit der neue Backup-Schlüssel nach dem Neustart korrekt geladen werden kann.

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

  • Bedeutung: Das Backup existiert, aber dieses Gerät vertraut der Cross-Signing-Kette noch nicht stark genug.
  • Vorgehen: Setzen Sie MATRIX_RECOVERY_KEY und führen Sie printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin aus.

Matrix recovery key is required

  • Bedeutung: Sie haben einen Wiederherstellungsschritt versucht, ohne einen Wiederherstellungsschlüssel bereitzustellen, obwohl einer erforderlich war.
  • Vorgehen: Führen Sie den Befehl erneut mit --recovery-key-stdin aus, zum Beispiel printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin.

Invalid Matrix recovery key: ...

  • Bedeutung: Der bereitgestellte Schlüssel konnte nicht geparst werden oder entsprach nicht dem erwarteten Format.
  • Vorgehen: Versuchen Sie es erneut mit dem exakten Wiederherstellungsschlüssel aus Ihrem Matrix-Client oder Ihrer recovery-key-Datei.

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

  • Bedeutung: OpenClaw konnte den Wiederherstellungsschlüssel anwenden, aber Matrix hat weiterhin kein vollständiges Cross-Signing-Identitätsvertrauen für dieses Gerät hergestellt. Prüfen Sie die Befehlsausgabe auf Recovery key accepted, Backup usable, Cross-signing verified und Device verified by owner.
  • Vorgehen: Führen Sie openclaw matrix verify self aus, akzeptieren Sie die Anfrage in einem anderen Matrix-Client, vergleichen Sie den SAS und geben Sie yes nur ein, wenn er übereinstimmt. Der Befehl wartet auf vollständiges Matrix-Identitätsvertrauen, bevor er Erfolg meldet. Verwenden Sie printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify bootstrap --recovery-key-stdin --force-reset-cross-signing nur, wenn Sie die aktuelle Cross-Signing-Identität bewusst ersetzen möchten.

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

  • Bedeutung: Der geheime Speicher hat auf diesem Gerät keine aktive Backup-Sitzung erzeugt.
  • Vorgehen: Verifizieren Sie zuerst das Gerät und prüfen Sie anschließend erneut mit 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.

  • Bedeutung: Dieses Gerät kann nicht aus dem geheimen Speicher wiederherstellen, bis die Geräteverifizierung abgeschlossen ist.
  • Vorgehen: Führen Sie zuerst printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin aus.

Meldungen zu benutzerdefinierten Plugin-Installationen

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

  • Bedeutung: Ihr Plugin-Installationsdatensatz verweist auf einen lokalen Pfad, der nicht mehr existiert.
  • Vorgehen: Installieren Sie mit openclaw plugins install @openclaw/matrix neu oder, wenn Sie aus einem Repo-Checkout ausführen, mit openclaw plugins install ./path/to/local/matrix-plugin.

Wenn der verschlüsselte Verlauf weiterhin nicht zurückkommt

Führen Sie diese Prüfungen der Reihe nach aus:

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

Wenn das Backup erfolgreich wiederhergestellt wird, aber bei einigen alten Räumen weiterhin Verlauf fehlt, wurden diese fehlenden Schlüssel wahrscheinlich nie vom vorherigen Plugin gesichert.

Wenn Sie für zukünftige Nachrichten neu beginnen möchten

Wenn Sie den Verlust nicht wiederherstellbaren alten verschlüsselten Verlaufs akzeptieren und künftig nur eine saubere Backup-Baseline möchten, führen Sie diese Befehle der Reihe nach aus:

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

Wenn das Gerät danach weiterhin unverifiziert ist, schließen Sie die Verifizierung über Ihren Matrix-Client ab, indem Sie die SAS-Emoji oder Dezimalcodes vergleichen und bestätigen, dass sie übereinstimmen.

Verwandte Themen

  • Matrix: Kanal-Einrichtung und Konfiguration.
  • Matrix-Push-Regeln: Benachrichtigungsrouting.
  • Doctor: Integritätsprüfung und automatischer Migrationsauslöser.
  • Migrationsleitfaden: alle Migrationspfade (Maschinenumzüge, systemübergreifende Importe).
  • Plugins: Plugin-Installation und Registrierung.