Matrix geçişi

• plugin @openclaw/matrix olarak kalır
• kanal matrix olarak kalır
• yapılandırmanız channels.matrix altında kalır
• önbelleğe alınmış kimlik bilgileri ~/.openclaw/credentials/matrix/ altında kalır
• çalışma zamanı durumu ~/.openclaw/matrix/ altında kalır

​

Geçişin otomatik olarak yaptıkları

• kaynak kurulumları güncelleme akışı sırasında openclaw doctor --fix çalıştırır, ardından varsayılan olarak gateway’i yeniden başlatır
• paket yöneticisi kurulumları paketi günceller, etkileşimsiz bir doctor geçişi çalıştırır, ardından başlangıcın Matrix geçişini tamamlayabilmesi için varsayılan gateway yeniden başlatmasına güvenir
• openclaw update --no-restart kullanırsanız başlangıç destekli Matrix geçişi, daha sonra openclaw doctor --fix çalıştırıp gateway’i yeniden başlatana kadar ertelenir

• ~/Backups/openclaw-migrations/ altında geçiş öncesi anlık görüntü oluşturma veya yeniden kullanma
• önbelleğe alınmış Matrix kimlik bilgilerinizi yeniden kullanma
• aynı hesap seçimini ve channels.matrix yapılandırmasını koruma
• en eski düz Matrix eşitleme deposunu mevcut hesap kapsamlı konuma taşıma
• hedef hesap güvenle çözümlenebildiğinde en eski düz Matrix kripto deposunu mevcut hesap kapsamlı konuma taşıma
• daha önce kaydedilmiş bir Matrix oda anahtarı yedeği şifre çözme anahtarını, bu anahtar yerel olarak mevcut olduğunda eski rust kripto deposundan çıkarma
• erişim belirteci daha sonra değiştiğinde aynı Matrix hesabı, homeserver ve kullanıcı için en eksiksiz mevcut belirteç karması depolama kökünü yeniden kullanma
• Matrix erişim belirteci değişmiş ama hesap/cihaz kimliği aynı kalmışsa bekleyen şifrelenmiş durum geri yükleme meta verileri için kardeş belirteç karması depolama köklerini tarama
• sonraki Matrix başlangıcında yedeklenmiş oda anahtarlarını yeni kripto deposuna geri yükleme

• OpenClaw başarılı bir anlık görüntüden sonra ~/.openclaw/matrix/migration-snapshot.json konumuna bir işaretçi dosyası yazar; böylece sonraki başlangıç ve onarım geçişleri aynı arşivi yeniden kullanabilir.
• Bu otomatik Matrix geçiş anlık görüntüleri yalnızca yapılandırmayı + durumu yedekler (includeWorkspace: false).
• Matrix yalnızca uyarı niteliğinde geçiş durumuna sahipse, örneğin userId veya accessToken hâlâ eksik olduğu için, OpenClaw henüz anlık görüntüyü oluşturmaz çünkü işlem yapılabilir bir Matrix mutasyonu yoktur.
• Anlık görüntü adımı başarısız olursa OpenClaw, kurtarma noktası olmadan durumu değiştirmek yerine o çalıştırma için Matrix geçişini atlar.

• en eski düz Matrix deposu (~/.openclaw/matrix/bot-storage.json ve ~/.openclaw/matrix/crypto/) tek depolu bir düzenden gelmiştir, bu yüzden OpenClaw onu yalnızca çözümlenmiş tek bir Matrix hesap hedefine geçirebilir
• zaten hesap kapsamlı olan eski Matrix depoları, yapılandırılmış her Matrix hesabı için algılanır ve hazırlanır

​

Geçişin otomatik olarak yapamadıkları

• hiç yedeklenmemiş, yalnızca yerel oda anahtarları
• hedef Matrix hesabı homeserver, userId veya accessToken hâlâ kullanılamadığı için henüz çözümlenemediğinde şifrelenmiş durum
• birden fazla Matrix hesabı yapılandırılmış ama channels.matrix.defaultAccount ayarlanmamışsa tek bir paylaşılan düz Matrix deposunun otomatik geçişi
• standart Matrix paketi yerine bir repo yoluna sabitlenmiş özel plugin yolu kurulumları
• eski depoda yedeklenmiş anahtarlar olduğu halde şifre çözme anahtarı yerel olarak tutulmamışsa eksik kurtarma anahtarı

• özel Matrix plugin yolu kurulumları hem gateway başlangıcı hem de openclaw doctor tarafından gösterilir

​

Önerilen yükseltme akışı

1. OpenClaw’ı ve Matrix plugin’ini normal şekilde güncelleyin. Başlangıcın Matrix geçişini hemen tamamlayabilmesi için --no-restart olmadan düz openclaw update komutunu tercih edin.
2. Şunu çalıştırın:
   openclaw doctor --fix
   
   Matrix için işlem yapılabilir geçiş işi varsa doctor önce geçiş öncesi anlık görüntüyü oluşturur veya yeniden kullanır ve arşiv yolunu yazdırır.
3. Gateway’i başlatın veya yeniden başlatın.
4. Mevcut doğrulama ve yedekleme durumunu kontrol edin:
   openclaw matrix verify status
   openclaw matrix verify backup status
   
5. Onardığınız Matrix hesabının kurtarma anahtarını hesaba özgü bir ortam değişkenine koyun. Tek bir varsayılan hesap için MATRIX_RECOVERY_KEY uygundur. Birden fazla hesap için hesap başına bir değişken kullanın, örneğin MATRIX_RECOVERY_KEY_ASSISTANT, ve komuta --account assistant ekleyin.
6. OpenClaw size kurtarma anahtarı gerektiğini söylerse eşleşen hesap için komutu çalıştırın:
   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. Bu cihaz hâlâ doğrulanmamışsa eşleşen hesap için komutu çalıştırın:
   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
   
   Kurtarma anahtarı kabul edilirse ve yedek kullanılabiliyorsa, ancak Cross-signing verified hâlâ no ise başka bir Matrix istemcisinden kendi kendine doğrulamayı tamamlayın:
   openclaw matrix verify self
   
   İsteği başka bir Matrix istemcisinde kabul edin, emojileri veya ondalıkları karşılaştırın ve yalnızca eşleştiklerinde yes yazın. Komut yalnızca Cross-signing verified yes olduğunda başarıyla çıkar.
8. Kurtarılamayan eski geçmişi bilerek terk ediyorsanız ve gelecekteki mesajlar için yeni bir yedek temeli istiyorsanız şunu çalıştırın:
   openclaw matrix verify backup reset --yes
   
9. Henüz sunucu tarafı anahtar yedeği yoksa gelecekteki kurtarmalar için bir tane oluşturun:
   openclaw matrix verify bootstrap
   

​

Şifrelenmiş geçiş nasıl çalışır

1. Başlangıç veya openclaw doctor --fix, şifrelenmiş geçiş işlem yapılabilir durumdaysa geçiş öncesi anlık görüntüyü oluşturur veya yeniden kullanır.
2. Başlangıç veya openclaw doctor --fix, eski Matrix kripto deposunu etkin Matrix plugin kurulumu üzerinden inceler.
3. Bir yedek şifre çözme anahtarı bulunursa OpenClaw bunu yeni kurtarma anahtarı akışına yazar ve oda anahtarı geri yüklemeyi beklemede olarak işaretler.
4. Sonraki Matrix başlangıcında OpenClaw yedeklenmiş oda anahtarlarını otomatik olarak yeni kripto deposuna geri yükler.

​

Yaygın iletiler ve anlamları

​

Yükseltme ve algılama iletileri

• Anlamı: eski disk üzerindeki Matrix durumu algılandı ve mevcut düzene geçirildi.
• Ne yapılmalı: aynı çıktı uyarılar da içermiyorsa hiçbir şey.

• Anlamı: OpenClaw, Matrix durumunu değiştirmeden önce bir kurtarma arşivi oluşturdu.
• Ne yapılmalı: geçişin başarılı olduğunu doğrulayana kadar yazdırılan arşiv yolunu saklayın.

• Anlamı: OpenClaw mevcut bir Matrix geçiş anlık görüntüsü işaretçisi buldu ve yinelenen yedek oluşturmak yerine bu arşivi yeniden kullandı.
• Ne yapılmalı: geçişin başarılı olduğunu doğrulayana kadar yazdırılan arşiv yolunu saklayın.

• Anlamı: eski Matrix durumu var, ancak Matrix yapılandırılmadığı için OpenClaw bunu mevcut bir Matrix hesabına eşleyemiyor.
• Ne yapılmalı: channels.matrix yapılandırın, ardından openclaw doctor --fix komutunu yeniden çalıştırın veya gateway’i yeniden başlatın.

• Anlamı: OpenClaw eski durumu buldu, ancak hâlâ kesin mevcut hesap/cihaz kökünü belirleyemiyor.
• Ne yapılmalı: çalışan bir Matrix oturum açmasıyla gateway’i bir kez başlatın veya önbelleğe alınmış kimlik bilgileri mevcut olduktan sonra openclaw doctor --fix komutunu yeniden çalıştırın.

• Anlamı: OpenClaw tek bir paylaşılan düz Matrix deposu buldu, ancak hangi adlandırılmış Matrix hesabının onu alacağını tahmin etmeyi reddediyor.
• Ne yapılmalı: channels.matrix.defaultAccount değerini hedeflenen hesaba ayarlayın, ardından openclaw doctor --fix komutunu yeniden çalıştırın veya gateway’i yeniden başlatın.

• Anlamı: yeni hesap kapsamlı konumda zaten bir eşitleme veya kripto deposu var, bu yüzden OpenClaw otomatik olarak üzerine yazmadı.
• Ne yapılmalı: çakışan hedefi elle kaldırmadan veya taşımadan önce mevcut hesabın doğru hesap olduğunu doğrulayın.

• Anlamı: OpenClaw eski Matrix durumunu taşımayı denedi ama dosya sistemi işlemi başarısız oldu.
• Ne yapılmalı: dosya sistemi izinlerini ve disk durumunu inceleyin, ardından openclaw doctor --fix komutunu yeniden çalıştırın.

• Anlamı: OpenClaw eski bir şifrelenmiş Matrix deposu buldu, ancak bunu iliştirecek mevcut Matrix yapılandırması yok.
• Ne yapılmalı: channels.matrix yapılandırın, ardından openclaw doctor --fix komutunu yeniden çalıştırın veya gateway’i yeniden başlatın.

• Anlamı: şifrelenmiş depo var, ancak OpenClaw bunun hangi mevcut hesap/cihaza ait olduğuna güvenle karar veremiyor.
• Ne yapılmalı: çalışan bir Matrix oturum açmasıyla gateway’i bir kez başlatın veya önbelleğe alınmış kimlik bilgileri mevcut olduktan sonra openclaw doctor --fix komutunu yeniden çalıştırın.

• Anlamı: OpenClaw tek bir paylaşılan düz eski kripto deposu buldu, ancak hangi adlandırılmış Matrix hesabının onu alacağını tahmin etmeyi reddediyor.
• Ne yapılmalı: channels.matrix.defaultAccount değerini hedeflenen hesaba ayarlayın, ardından openclaw doctor --fix komutunu yeniden çalıştırın veya gateway’i yeniden başlatın.

• Anlamı: OpenClaw eski Matrix durumunu algıladı, ancak geçiş hâlâ eksik kimlik veya kimlik bilgisi verileri nedeniyle engelleniyor.
• Ne yapılmalı: Matrix oturum açmayı veya yapılandırma kurulumunu tamamlayın, ardından openclaw doctor --fix komutunu yeniden çalıştırın veya gateway’i yeniden başlatın.

• Anlamı: OpenClaw eski şifreli Matrix durumunu buldu, ancak normalde bu depoyu inceleyen Matrix Plugin’deki yardımcı giriş noktasını yükleyemedi.
• Ne yapılmalı: Matrix Plugin’i yeniden yükleyin veya onarın (openclaw plugins install @openclaw/matrix ya da bir repo checkout’u için openclaw plugins install ./path/to/local/matrix-plugin), ardından openclaw doctor --fix komutunu yeniden çalıştırın veya gateway’i yeniden başlatın.

• Anlamı: OpenClaw, Plugin kökünün dışına çıkan veya Plugin sınırı denetimlerinden geçemeyen bir yardımcı dosya yolu buldu, bu yüzden içe aktarmayı reddetti.
• Ne yapılmalı: Matrix Plugin’i güvenilir bir yoldan yeniden yükleyin, ardından openclaw doctor --fix komutunu yeniden çalıştırın veya gateway’i yeniden başlatın.

• Anlamı: OpenClaw, önce kurtarma anlık görüntüsünü oluşturamadığı için Matrix durumunu değiştirmeyi reddetti.
• Ne yapılmalı: yedekleme hatasını giderin, ardından openclaw doctor --fix komutunu yeniden çalıştırın veya gateway’i yeniden başlatın.

• Anlamı: Matrix istemci tarafı geri dönüşü eski düz depolamayı buldu, ancak taşıma başarısız oldu. OpenClaw artık sessizce yeni bir depo ile başlamak yerine bu geri dönüşü durdurur.
• Ne yapılmalı: dosya sistemi izinlerini veya çakışmaları inceleyin, eski durumu olduğu gibi koruyun ve hatayı düzelttikten sonra yeniden deneyin.

• Anlamı: Matrix bir yol kurulumuna sabitlenmiş, bu yüzden ana hat güncellemeleri onu otomatik olarak reponun standart Matrix paketiyle değiştirmez.
• Ne yapılmalı: varsayılan Matrix Plugin’e dönmek istediğinizde openclaw plugins install @openclaw/matrix ile yeniden yükleyin.

​

Şifreli durum kurtarma iletileri

• Anlamı: yedeklenmiş oda anahtarları yeni kripto deposuna başarıyla geri yüklendi.
• Ne yapılmalı: genellikle hiçbir şey.

• Anlamı: bazı eski oda anahtarları yalnızca eski yerel depoda vardı ve Matrix yedeğine hiç yüklenmemişti.
• Ne yapılmalı: bu anahtarları başka bir doğrulanmış istemciden elle kurtaramazsanız bazı eski şifreli geçmişin kullanılamaz kalmasını bekleyin.

• Anlamı: yedek mevcut, ancak OpenClaw kurtarma anahtarını otomatik olarak kurtaramadı.
• Ne yapılmalı: printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin komutunu çalıştırın.

• Anlamı: OpenClaw eski şifreli depoyu buldu, ancak kurtarmaya hazırlanmak için yeterince güvenli biçimde inceleyemedi.
• Ne yapılmalı: openclaw doctor --fix komutunu yeniden çalıştırın. Tekrarlanırsa eski durum dizinini olduğu gibi koruyun ve başka bir doğrulanmış Matrix istemcisi ile printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin kullanarak kurtarın.

• Anlamı: OpenClaw bir yedek anahtar çakışması algıladı ve geçerli recovery-key dosyasının otomatik olarak üzerine yazmayı reddetti.
• Ne yapılmalı: herhangi bir geri yükleme komutunu yeniden denemeden önce hangi kurtarma anahtarının doğru olduğunu doğrulayın.

• Anlamı: bu, eski depolama biçiminin kesin sınırıdır.
• Ne yapılmalı: yedeklenmiş anahtarlar yine de geri yüklenebilir, ancak yalnızca yerel olan şifreli geçmiş kullanılamaz kalabilir.

• Anlamı: yeni Plugin geri yüklemeyi denedi, ancak Matrix bir hata döndürdü.
• Ne yapılmalı: openclaw matrix verify backup status komutunu çalıştırın, ardından gerekirse printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin ile yeniden deneyin.

​

Elle kurtarma iletileri

• Anlamı: OpenClaw bir yedek anahtarınız olması gerektiğini biliyor, ancak bu cihazda etkin değil.
• Ne yapılmalı: openclaw matrix verify backup restore komutunu çalıştırın veya gerekirse MATRIX_RECOVERY_KEY ayarlayıp printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin komutunu çalıştırın.

• Anlamı: bu cihazda şu anda kurtarma anahtarı depolanmıyor.
• Ne yapılmalı: MATRIX_RECOVERY_KEY ayarlayın, printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin komutunu çalıştırın, ardından yedeği geri yükleyin.

• Anlamı: depolanan anahtar etkin Matrix yedeğiyle eşleşmiyor.
• Ne yapılmalı: MATRIX_RECOVERY_KEY değerini doğru anahtara ayarlayın ve printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin komutunu çalıştırın.

• Anlamı: yedek mevcut, ancak bu cihaz çapraz imzalama zincirine henüz yeterince güçlü biçimde güvenmiyor.
• Ne yapılmalı: MATRIX_RECOVERY_KEY ayarlayın ve printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin komutunu çalıştırın.

• Anlamı: bir kurtarma anahtarı gerekli olduğu halde sağlamadan bir kurtarma adımı denediniz.
• Ne yapılmalı: komutu --recovery-key-stdin ile yeniden çalıştırın; örneğin printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin.

• Anlamı: sağlanan anahtar ayrıştırılamadı veya beklenen biçimle eşleşmedi.
• Ne yapılmalı: Matrix istemcinizdeki veya recovery-key dosyanızdaki tam kurtarma anahtarıyla yeniden deneyin.

• Anlamı: OpenClaw kurtarma anahtarını uygulayabildi, ancak Matrix bu cihaz için hâlâ tam çapraz imzalama kimlik güveni oluşturmadı. Komut çıktısında Recovery key accepted, Backup usable, Cross-signing verified ve Device verified by owner değerlerini denetleyin.
• Ne yapılmalı: openclaw matrix verify self komutunu çalıştırın, isteği başka bir Matrix istemcisinde kabul edin, SAS’i karşılaştırın ve yalnızca eşleştiğinde yes yazın. Komut, başarı bildirmeden önce tam Matrix kimlik güvenini bekler. Yalnızca geçerli çapraz imzalama kimliğini bilinçli olarak değiştirmek istediğinizde printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify bootstrap --recovery-key-stdin --force-reset-cross-signing komutunu kullanın.

• Anlamı: gizli depolama bu cihazda etkin bir yedekleme oturumu üretmedi.
• Ne yapılmalı: önce cihazı doğrulayın, ardından openclaw matrix verify backup status ile yeniden denetleyin.

• Anlamı: cihaz doğrulaması tamamlanana kadar bu cihaz gizli depolamadan geri yükleyemez.
• Ne yapılmalı: önce printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin komutunu çalıştırın.

​

Özel Plugin kurulum iletileri

• Anlamı: Plugin kurulum kaydınız artık mevcut olmayan bir yerel yolu işaret ediyor.
• Ne yapılmalı: openclaw plugins install @openclaw/matrix ile yeniden yükleyin veya bir repo checkout’undan çalıştırıyorsanız openclaw plugins install ./path/to/local/matrix-plugin.

​

Şifreli geçmiş hâlâ geri gelmiyorsa

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

​

Gelecekteki iletiler için temiz başlamak istiyorsanız

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

​

İlgili

• Matrix: kanal kurulumu ve yapılandırması.
• Matrix push rules: bildirim yönlendirmesi.
• Doctor: sağlık denetimi ve otomatik migration tetikleyicisi.
• Migration guide: tüm migration yolları (makine taşımaları, sistemler arası içe aktarmalar).
• Plugins: Plugin kurulumu ve kaydı.