> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrasi Matrix

Tingkatkan dari Plugin publik `matrix` sebelumnya ke implementasi saat ini.

Untuk sebagian besar pengguna, peningkatan dilakukan di tempat:

* Plugin tetap `@openclaw/matrix`
* channel tetap `matrix`
* konfigurasi Anda tetap berada di bawah `channels.matrix`
* kredensial yang di-cache tetap berada di bawah `~/.openclaw/credentials/matrix/`
* status runtime tetap berada di bawah `~/.openclaw/matrix/`

Anda tidak perlu mengganti nama kunci konfigurasi atau menginstal ulang Plugin dengan nama baru.
Paket root `openclaw` tidak lagi membundel kode runtime Matrix atau dependensi Matrix SDK. Jika `openclaw channels status` menunjukkan Matrix sudah dikonfigurasi tetapi Plugin hilang setelah pembaruan, jalankan `openclaw doctor --fix` atau `openclaw plugins install @openclaw/matrix`; jangan instal paket Matrix SDK ke dalam paket root OpenClaw.

## Yang dilakukan migrasi secara otomatis

Saat Gateway dimulai, dan saat Anda menjalankan [`openclaw doctor --fix`](/id/gateway/doctor), OpenClaw mencoba memperbaiki status Matrix lama secara otomatis.
Sebelum langkah migrasi Matrix yang dapat ditindaklanjuti mengubah status di disk, OpenClaw membuat atau menggunakan kembali snapshot pemulihan yang terfokus.

Saat Anda menggunakan `openclaw update`, pemicu persisnya bergantung pada cara OpenClaw diinstal:

* instalasi sumber menjalankan `openclaw doctor --fix` selama alur pembaruan, lalu memulai ulang Gateway secara default
* instalasi pengelola paket memperbarui paket, menjalankan pemeriksaan doctor non-interaktif, lalu mengandalkan restart Gateway default agar startup dapat menyelesaikan migrasi Matrix
* jika Anda menggunakan `openclaw update --no-restart`, migrasi Matrix yang didukung startup ditunda hingga nanti Anda menjalankan `openclaw doctor --fix` dan memulai ulang Gateway

Migrasi otomatis mencakup:

* membuat atau menggunakan kembali snapshot pra-migrasi di bawah `~/Backups/openclaw-migrations/`
* menggunakan kembali kredensial Matrix yang di-cache
* mempertahankan pemilihan akun yang sama dan konfigurasi `channels.matrix`
* memindahkan penyimpanan sinkronisasi Matrix datar tertua ke lokasi saat ini yang berlingkup akun
* memindahkan penyimpanan crypto Matrix datar tertua ke lokasi saat ini yang berlingkup akun saat akun target dapat diselesaikan dengan aman
* mengekstrak kunci dekripsi cadangan kunci ruang Matrix yang sebelumnya disimpan dari penyimpanan rust crypto lama, saat kunci tersebut tersedia secara lokal
* menggunakan kembali root penyimpanan hash-token paling lengkap yang sudah ada untuk akun Matrix, homeserver, dan pengguna yang sama saat token akses berubah nanti
* memindai root penyimpanan hash-token saudara untuk metadata pemulihan status terenkripsi yang tertunda saat token akses Matrix berubah tetapi identitas akun/perangkat tetap sama
* memulihkan kunci ruang yang dicadangkan ke penyimpanan crypto baru pada startup Matrix berikutnya

Detail snapshot:

* OpenClaw menulis file penanda di `~/.openclaw/matrix/migration-snapshot.json` setelah snapshot berhasil sehingga startup dan pemeriksaan perbaikan berikutnya dapat menggunakan kembali arsip yang sama.
* Snapshot migrasi Matrix otomatis ini hanya mencadangkan konfigurasi + status (`includeWorkspace: false`).
* Jika Matrix hanya memiliki status migrasi peringatan saja, misalnya karena `userId` atau `accessToken` masih hilang, OpenClaw belum membuat snapshot karena belum ada mutasi Matrix yang dapat ditindaklanjuti.
* Jika langkah snapshot gagal, OpenClaw melewati migrasi Matrix untuk proses tersebut alih-alih mengubah status tanpa titik pemulihan.

Tentang peningkatan multi-akun:

* penyimpanan Matrix datar tertua (`~/.openclaw/matrix/bot-storage.json` dan `~/.openclaw/matrix/crypto/`) berasal dari tata letak penyimpanan tunggal, sehingga OpenClaw hanya dapat memigrasikannya ke satu target akun Matrix yang terselesaikan
* penyimpanan Matrix lama yang sudah berlingkup akun dideteksi dan disiapkan per akun Matrix yang dikonfigurasi

## Yang tidak dapat dilakukan migrasi secara otomatis

Plugin Matrix publik sebelumnya **tidak** secara otomatis membuat cadangan kunci ruang Matrix. Plugin tersebut mempertahankan status crypto lokal dan meminta verifikasi perangkat, tetapi tidak menjamin bahwa kunci ruang Anda dicadangkan ke homeserver.

Artinya, beberapa instalasi terenkripsi hanya dapat dimigrasikan sebagian.

OpenClaw tidak dapat secara otomatis memulihkan:

* kunci ruang lokal saja yang tidak pernah dicadangkan
* status terenkripsi saat akun Matrix target belum dapat diselesaikan karena `homeserver`, `userId`, atau `accessToken` masih belum tersedia
* migrasi otomatis satu penyimpanan Matrix datar bersama saat beberapa akun Matrix dikonfigurasi tetapi `channels.matrix.defaultAccount` tidak diatur
* instalasi jalur Plugin kustom yang dipatok ke jalur repo alih-alih paket Matrix standar
* kunci pemulihan yang hilang saat penyimpanan lama memiliki kunci yang dicadangkan tetapi tidak menyimpan kunci dekripsi secara lokal

Cakupan peringatan saat ini:

* instalasi jalur Plugin Matrix kustom ditampilkan oleh startup Gateway dan `openclaw doctor`

Jika instalasi lama Anda memiliki riwayat terenkripsi lokal saja yang tidak pernah dicadangkan, beberapa pesan terenkripsi yang lebih lama mungkin tetap tidak dapat dibaca setelah peningkatan.

## Alur peningkatan yang direkomendasikan

1. Perbarui OpenClaw dan Plugin Matrix seperti biasa.
   Sebaiknya gunakan `openclaw update` biasa tanpa `--no-restart` agar startup dapat segera menyelesaikan migrasi Matrix.

2. Jalankan:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw doctor --fix
   ```

   Jika Matrix memiliki pekerjaan migrasi yang dapat ditindaklanjuti, doctor akan membuat atau menggunakan kembali snapshot pra-migrasi terlebih dahulu dan mencetak jalur arsip.

3. Mulai atau mulai ulang Gateway.

4. Periksa status verifikasi dan cadangan saat ini:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw matrix verify status
   openclaw matrix verify backup status
   ```

5. Letakkan kunci pemulihan untuk akun Matrix yang Anda perbaiki dalam variabel lingkungan khusus akun. Untuk satu akun default, `MATRIX_RECOVERY_KEY` sudah cukup. Untuk beberapa akun, gunakan satu variabel per akun, misalnya `MATRIX_RECOVERY_KEY_ASSISTANT`, dan tambahkan `--account assistant` ke perintah.

6. Jika OpenClaw memberi tahu Anda bahwa kunci pemulihan diperlukan, jalankan perintah untuk akun yang sesuai:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   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. Jika perangkat ini masih belum diverifikasi, jalankan perintah untuk akun yang sesuai:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   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
   ```

   Jika kunci pemulihan diterima dan cadangan dapat digunakan, tetapi `Cross-signing verified`
   masih `no`, selesaikan verifikasi mandiri dari klien Matrix lain:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw matrix verify self
   ```

   Terima permintaan di klien Matrix lain, bandingkan emoji atau desimal,
   dan ketik `yes` hanya saat semuanya cocok. Perintah berhasil keluar hanya
   setelah `Cross-signing verified` menjadi `yes`.

8. Jika Anda sengaja meninggalkan riwayat lama yang tidak dapat dipulihkan dan menginginkan baseline cadangan baru untuk pesan mendatang, jalankan:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw matrix verify backup reset --yes
   ```

9. Jika belum ada cadangan kunci sisi server, buat satu untuk pemulihan di masa mendatang:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw matrix verify bootstrap
   ```

## Cara kerja migrasi terenkripsi

Migrasi terenkripsi adalah proses dua tahap:

1. Startup atau `openclaw doctor --fix` membuat atau menggunakan kembali snapshot pra-migrasi jika migrasi terenkripsi dapat ditindaklanjuti.
2. Startup atau `openclaw doctor --fix` memeriksa penyimpanan crypto Matrix lama melalui instalasi Plugin Matrix aktif.
3. Jika kunci dekripsi cadangan ditemukan, OpenClaw menulisnya ke alur kunci pemulihan baru dan menandai pemulihan kunci ruang sebagai tertunda.
4. Pada startup Matrix berikutnya, OpenClaw memulihkan kunci ruang yang dicadangkan ke penyimpanan crypto baru secara otomatis.

Jika penyimpanan lama melaporkan kunci ruang yang tidak pernah dicadangkan, OpenClaw memperingatkan alih-alih berpura-pura pemulihan berhasil.

## Pesan umum dan artinya

### Pesan peningkatan dan deteksi

`Matrix plugin upgraded in place.`

* Arti: status Matrix lama di disk terdeteksi dan dimigrasikan ke tata letak saat ini.
* Yang harus dilakukan: tidak ada kecuali output yang sama juga menyertakan peringatan.

`Matrix migration snapshot created before applying Matrix upgrades.`

* Arti: OpenClaw membuat arsip pemulihan sebelum mengubah status Matrix.
* Yang harus dilakukan: simpan jalur arsip yang dicetak hingga Anda memastikan migrasi berhasil.

`Matrix migration snapshot reused before applying Matrix upgrades.`

* Arti: OpenClaw menemukan penanda snapshot migrasi Matrix yang sudah ada dan menggunakan kembali arsip tersebut alih-alih membuat cadangan duplikat.
* Yang harus dilakukan: simpan jalur arsip yang dicetak hingga Anda memastikan migrasi berhasil.

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

* Arti: status Matrix lama ada, tetapi OpenClaw tidak dapat memetakannya ke akun Matrix saat ini karena Matrix belum dikonfigurasi.
* Yang harus dilakukan: konfigurasikan `channels.matrix`, lalu jalankan ulang `openclaw doctor --fix` atau mulai ulang 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...).`

* Arti: OpenClaw menemukan status lama, tetapi masih belum dapat menentukan root akun/perangkat saat ini yang tepat.
* Yang harus dilakukan: mulai Gateway sekali dengan login Matrix yang berfungsi, atau jalankan ulang `openclaw doctor --fix` setelah kredensial yang di-cache tersedia.

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

* Arti: OpenClaw menemukan satu penyimpanan Matrix datar bersama, tetapi menolak menebak akun Matrix bernama mana yang harus menerimanya.
* Yang harus dilakukan: atur `channels.matrix.defaultAccount` ke akun yang dimaksud, lalu jalankan ulang `openclaw doctor --fix` atau mulai ulang Gateway.

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

* Arti: lokasi baru yang berlingkup akun sudah memiliki penyimpanan sinkronisasi atau crypto, sehingga OpenClaw tidak menimpanya secara otomatis.
* Yang harus dilakukan: verifikasi bahwa akun saat ini adalah akun yang benar sebelum menghapus atau memindahkan target yang bertentangan secara manual.

`Failed migrating Matrix legacy sync store (...)` atau `Failed migrating Matrix legacy crypto store (...)`

* Arti: OpenClaw mencoba memindahkan status Matrix lama tetapi operasi sistem file gagal.
* Yang harus dilakukan: periksa izin sistem file dan status disk, lalu jalankan ulang `openclaw doctor --fix`.

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

* Arti: OpenClaw menemukan penyimpanan Matrix terenkripsi lama, tetapi tidak ada konfigurasi Matrix saat ini untuk melampirkannya.
* Yang harus dilakukan: konfigurasikan `channels.matrix`, lalu jalankan ulang `openclaw doctor --fix` atau mulai ulang 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...).`

* Arti: penyimpanan terenkripsi ada, tetapi OpenClaw tidak dapat dengan aman memutuskan akun/perangkat saat ini mana yang memilikinya.
* Yang harus dilakukan: mulai Gateway sekali dengan login Matrix yang berfungsi, atau jalankan ulang `openclaw doctor --fix` setelah kredensial yang di-cache tersedia.

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

* Arti: OpenClaw menemukan satu penyimpanan crypto lama datar bersama, tetapi menolak menebak akun Matrix bernama mana yang harus menerimanya.
* Yang harus dilakukan: atur `channels.matrix.defaultAccount` ke akun yang dimaksud, lalu jalankan ulang `openclaw doctor --fix` atau mulai ulang Gateway.

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

* Arti: OpenClaw mendeteksi status Matrix lama, tetapi migrasi masih terblokir oleh data identitas atau kredensial yang hilang.
* Yang harus dilakukan: selesaikan login Matrix atau penyiapan konfigurasi, lalu jalankan ulang `openclaw doctor --fix` atau mulai ulang 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.`

* Arti: OpenClaw menemukan state Matrix terenkripsi lama, tetapi tidak dapat memuat entrypoint pembantu dari Plugin Matrix yang biasanya memeriksa store tersebut.
* Yang harus dilakukan: instal ulang atau perbaiki Plugin Matrix (`openclaw plugins install @openclaw/matrix`, atau `openclaw plugins install ./path/to/local/matrix-plugin` untuk checkout repo), lalu jalankan ulang `openclaw doctor --fix` atau mulai ulang gateway.

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

* Arti: OpenClaw menemukan jalur file pembantu yang keluar dari root plugin atau gagal melewati pemeriksaan batas plugin, sehingga OpenClaw menolak mengimpornya.
* Yang harus dilakukan: instal ulang Plugin Matrix dari jalur tepercaya, lalu jalankan ulang `openclaw doctor --fix` atau mulai ulang gateway.

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

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

* Arti: OpenClaw menolak mengubah state Matrix karena tidak dapat membuat snapshot pemulihan terlebih dahulu.
* Yang harus dilakukan: selesaikan kesalahan pencadangan, lalu jalankan ulang `openclaw doctor --fix` atau mulai ulang gateway.

`Failed migrating legacy Matrix client storage: ...`

* Arti: fallback sisi klien Matrix menemukan penyimpanan datar lama, tetapi pemindahannya gagal. OpenClaw sekarang membatalkan fallback tersebut alih-alih diam-diam memulai dengan store baru.
* Yang harus dilakukan: periksa izin atau konflik sistem file, pertahankan state lama tetap utuh, dan coba lagi setelah memperbaiki kesalahan.

`Matrix is installed from a custom path: ...`

* Arti: Matrix dipasang dengan path install tertentu, sehingga pembaruan mainline tidak otomatis menggantinya dengan paket Matrix standar dari repo.
* Yang harus dilakukan: instal ulang dengan `openclaw plugins install @openclaw/matrix` saat Anda ingin kembali ke Plugin Matrix default.

### Pesan pemulihan state terenkripsi

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

* Arti: kunci ruang yang dicadangkan berhasil dipulihkan ke crypto store baru.
* Yang harus dilakukan: biasanya tidak ada.

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

* Arti: beberapa kunci ruang lama hanya ada di store lokal lama dan belum pernah diunggah ke cadangan Matrix.
* Yang harus dilakukan: perkirakan sebagian riwayat terenkripsi lama tetap tidak tersedia kecuali Anda dapat memulihkan kunci tersebut secara manual dari klien terverifikasi lain.

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

* Arti: cadangan ada, tetapi OpenClaw tidak dapat memulihkan kunci pemulihan secara otomatis.
* Yang harus dilakukan: jalankan `printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin`.

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

* Arti: OpenClaw menemukan store terenkripsi lama, tetapi tidak dapat memeriksanya dengan cukup aman untuk menyiapkan pemulihan.
* Yang harus dilakukan: jalankan ulang `openclaw doctor --fix`. Jika berulang, pertahankan direktori state lama tetap utuh dan pulihkan menggunakan klien Matrix terverifikasi lain ditambah `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.`

* Arti: OpenClaw mendeteksi konflik kunci cadangan dan menolak menimpa file recovery-key saat ini secara otomatis.
* Yang harus dilakukan: verifikasi kunci pemulihan mana yang benar sebelum mencoba lagi perintah pemulihan apa pun.

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

* Arti: ini adalah batas keras format penyimpanan lama.
* Yang harus dilakukan: kunci yang dicadangkan masih dapat dipulihkan, tetapi riwayat terenkripsi yang hanya ada secara lokal mungkin tetap tidak tersedia.

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

* Arti: plugin baru mencoba pemulihan, tetapi Matrix mengembalikan kesalahan.
* Yang harus dilakukan: jalankan `openclaw matrix verify backup status`, lalu coba lagi dengan `printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin` jika perlu.

### Pesan pemulihan manual

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

* Arti: OpenClaw tahu Anda seharusnya memiliki kunci cadangan, tetapi kunci tersebut tidak aktif di perangkat ini.
* Yang harus dilakukan: jalankan `openclaw matrix verify backup restore`, atau atur `MATRIX_RECOVERY_KEY` dan jalankan `printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin` jika perlu.

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

* Arti: perangkat ini saat ini belum menyimpan kunci pemulihan.
* Yang harus dilakukan: atur `MATRIX_RECOVERY_KEY`, jalankan `printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin`, lalu pulihkan cadangan.

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

* Arti: kunci yang tersimpan tidak cocok dengan cadangan Matrix aktif.
* Yang harus dilakukan: atur `MATRIX_RECOVERY_KEY` ke kunci yang benar dan jalankan `printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin`.

Jika Anda menerima kehilangan riwayat terenkripsi lama yang tidak dapat dipulihkan, Anda dapat mereset
baseline cadangan saat ini dengan `openclaw matrix verify backup reset --yes`. Saat
rahasia cadangan yang tersimpan rusak, reset tersebut juga dapat membuat ulang secret storage agar
kunci cadangan baru dapat dimuat dengan benar setelah restart.

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

* Arti: cadangan ada, tetapi perangkat ini belum cukup memercayai rantai cross-signing.
* Yang harus dilakukan: atur `MATRIX_RECOVERY_KEY` dan jalankan `printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin`.

`Matrix recovery key is required`

* Arti: Anda mencoba langkah pemulihan tanpa menyediakan kunci pemulihan saat kunci tersebut diperlukan.
* Yang harus dilakukan: jalankan ulang perintah dengan `--recovery-key-stdin`, misalnya `printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin`.

`Invalid Matrix recovery key: ...`

* Arti: kunci yang diberikan tidak dapat diurai atau tidak cocok dengan format yang diharapkan.
* Yang harus dilakukan: coba lagi dengan kunci pemulihan persis dari klien Matrix atau file recovery-key Anda.

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

* Arti: OpenClaw dapat menerapkan kunci pemulihan, tetapi Matrix masih belum
  menetapkan kepercayaan identitas cross-signing penuh untuk perangkat ini. Periksa
  output perintah untuk `Recovery key accepted`, `Backup usable`,
  `Cross-signing verified`, dan `Device verified by owner`.
* Yang harus dilakukan: jalankan `openclaw matrix verify self`, terima permintaan di klien
  Matrix lain, bandingkan SAS, dan ketik `yes` hanya saat cocok. Perintah
  menunggu kepercayaan identitas Matrix penuh sebelum melaporkan sukses. Gunakan
  `printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify bootstrap --recovery-key-stdin --force-reset-cross-signing`
  hanya saat Anda sengaja ingin mengganti identitas cross-signing saat ini.

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

* Arti: secret storage tidak menghasilkan sesi cadangan aktif di perangkat ini.
* Yang harus dilakukan: verifikasi perangkat terlebih dahulu, lalu periksa ulang dengan `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.`

* Arti: perangkat ini tidak dapat memulihkan dari secret storage sampai verifikasi perangkat selesai.
* Yang harus dilakukan: jalankan `printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin` terlebih dahulu.

### Pesan instal plugin kustom

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

* Arti: catatan instal plugin Anda menunjuk ke jalur lokal yang sudah tidak ada.
* Yang harus dilakukan: instal ulang dengan `openclaw plugins install @openclaw/matrix`, atau jika Anda menjalankan dari checkout repo, `openclaw plugins install ./path/to/local/matrix-plugin`.

## Jika riwayat terenkripsi masih belum kembali

Jalankan pemeriksaan ini secara berurutan:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

Jika cadangan berhasil dipulihkan tetapi beberapa ruang lama masih kehilangan riwayat, kunci yang hilang tersebut kemungkinan belum pernah dicadangkan oleh plugin sebelumnya.

## Jika Anda ingin memulai baru untuk pesan mendatang

Jika Anda menerima kehilangan riwayat terenkripsi lama yang tidak dapat dipulihkan dan hanya ingin baseline cadangan bersih untuk ke depannya, jalankan perintah ini secara berurutan:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw matrix verify backup reset --yes
openclaw matrix verify backup status --verbose
openclaw matrix verify status
```

Jika perangkat masih belum terverifikasi setelah itu, selesaikan verifikasi dari klien Matrix Anda dengan membandingkan emoji SAS atau kode desimal dan mengonfirmasi bahwa keduanya cocok.

## Terkait

* [Matrix](/id/channels/matrix): penyiapan dan konfigurasi channel.
* [Aturan push Matrix](/id/channels/matrix-push-rules): perutean notifikasi.
* [Doctor](/id/gateway/doctor): pemeriksaan kesehatan dan pemicu migrasi otomatis.
* [Panduan migrasi](/id/install/migrating): semua jalur migrasi (pemindahan mesin, impor lintas sistem).
* [Plugin](/id/tools/plugin): instalasi dan pendaftaran plugin.