diff --git a/docs/channels/matrix.md b/docs/channels/matrix.md index 18c1ff3c0ec..2911a79f73a 100644 --- a/docs/channels/matrix.md +++ b/docs/channels/matrix.md @@ -300,6 +300,18 @@ Use `--force-reset-cross-signing` only when you intentionally want to discard th If you intentionally want to discard the current room-key backup and start a new backup baseline for future messages, use `openclaw matrix verify backup reset --yes`. Do this only when you accept that unrecoverable old encrypted history will stay unavailable. +### Fresh backup baseline + +If you want to keep future encrypted messages working and accept losing unrecoverable old history, run these commands in order: + +```bash +openclaw matrix verify backup reset --yes +openclaw matrix verify backup status --verbose +openclaw matrix verify status +``` + +Add `--account ` to each command when you want to target a named Matrix account explicitly. + ### Startup behavior When `encryption: true`, Matrix defaults `startupVerification` to `"if-unverified"`. @@ -342,7 +354,7 @@ That includes: Incoming verification requests from another Matrix client are tracked and auto-accepted by OpenClaw. When SAS emoji verification becomes available, OpenClaw starts that SAS flow automatically for inbound requests and confirms its own side. -You still need to confirm "They match" in your Matrix client to complete the verification. +You still need to compare the emoji or decimal SAS in your Matrix client and confirm "They match" there to complete the verification. OpenClaw does not auto-accept self-initiated duplicate flows blindly. Startup skips creating a new request when a self-verification request is already pending. diff --git a/docs/install/migrating-matrix.md b/docs/install/migrating-matrix.md index fb61c6bd9b8..4e7e22f1667 100644 --- a/docs/install/migrating-matrix.md +++ b/docs/install/migrating-matrix.md @@ -259,6 +259,18 @@ openclaw matrix verify backup restore --recovery-key "" --ver If the backup restores successfully but some old rooms are still missing history, those missing keys were probably never backed up by the previous plugin. +## If you want to start fresh for future messages + +If you accept losing unrecoverable old encrypted history and only want a clean backup baseline going forward, run these commands in order: + +```bash +openclaw matrix verify backup reset --yes +openclaw matrix verify backup status --verbose +openclaw matrix verify status +``` + +If the device is still unverified after that, finish verification from your Matrix client by comparing the SAS emoji or decimal codes and confirming that they match. + ## Related pages - [Matrix](/channels/matrix)