Matrix geçişi

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• 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ığı işlemler

• 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 bir anlık görüntü oluşturma veya mevcut olanı 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 geçerli hesap kapsamlı konuma taşıma
• hedef hesap güvenli şekilde çözümlenebildiğinde en eski düz Matrix kripto deposunu geçerli hesap kapsamlı konuma taşıma
• daha önce kaydedilmiş bir Matrix oda anahtarı yedeği şifre çözme anahtarını, bu anahtar yerel olarak mevcutsa eski rust kripto deposundan çıkarma
• erişim belirteci daha sonra değiştiğinde aynı Matrix hesabı, homeserver ve kullanıcı için mevcut en eksiksiz belirteç karması depolama kökünü yeniden kullanma
• Matrix erişim belirteci değiştiği ancak hesap/cihaz kimliği aynı kaldığı zaman bekleyen şifrelenmiş durum geri yükleme meta verileri için kardeş belirteç karması depolama köklerini tarama
• bir 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şaretleyici dosya 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ırma + durum yedeği alır (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ü oluşturmaz çünkü eyleme dönüştürülebilir bir Matrix değişikliği 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 geldiği için OpenClaw bunu yalnızca çözümlenmiş tek bir Matrix hesabı 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 yapamayacağı işlemler

• hiç yedeklenmemiş yalnızca yerel oda anahtarları
• hedef Matrix hesabı homeserver, userId veya accessToken hâlâ mevcut olmadığı için henüz çözümlenemediğinde şifrelenmiş durum
• birden çok Matrix hesabı yapılandırılmış ancak channels.matrix.defaultAccount ayarlanmamış olduğunda 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 ancak şifre çözme anahtarını yerel olarak tutmadığı durumda eksik bir 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’i normal şekilde güncelleyin. Başlangıcın Matrix geçişini hemen tamamlayabilmesi için --no-restart olmadan düz openclaw update tercih edin.
2. Şunu çalıştırın:
   openclaw doctor --fix
   
   Matrix için eyleme dönüştürülebilir geçiş işi varsa doctor önce geçiş öncesi anlık görüntüyü oluşturur veya mevcut olanı yeniden kullanır ve arşiv yolunu yazdırır.
3. Gateway’i başlatın veya yeniden başlatın.
4. Geçerli 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 özel bir ortam değişkenine koyun. Tek bir varsayılan hesap için MATRIX_RECOVERY_KEY yeterlidir. Birden çok 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 bir 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 yedekleme 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, emoji veya ondalık değerleri karşılaştırın ve yalnızca eşleştiklerinde yes yazın. Komut yalnızca Cross-signing verified yes olduktan sonra başarıyla çıkar.
8. Kurtarılamaz eski geçmişi bilinçli olarak terk ediyorsanız ve gelecekteki iletiler için yeni bir yedekleme 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ş eyleme dönüştürülebilirse geçiş öncesi anlık görüntüyü oluşturur veya mevcut olanı yeniden kullanır.
2. Başlangıç veya openclaw doctor --fix, etkin Matrix Plugin kurulumu üzerinden eski Matrix kripto deposunu inceler.
3. Bir yedek şifre çözme anahtarı bulunursa OpenClaw bunu yeni kurtarma anahtarı akışına yazar ve oda anahtarı geri yüklemesini beklemede olarak işaretler.
4. Bir sonraki Matrix başlangıcında OpenClaw yedeklenmiş oda anahtarlarını yeni kripto deposuna otomatik olarak geri yükler.

​

Yaygın iletiler ve anlamları

​

Yükseltme ve algılama iletileri

• Anlamı: disk üzerindeki eski Matrix durumu algılandı ve geçerli düzene geçirildi.
• Yapılacak işlem: aynı çıktı uyarılar da içermiyorsa hiçbir şey.

• Anlamı: OpenClaw, Matrix durumunu değiştirmeden önce bir kurtarma arşivi oluşturdu.
• Yapılacak işlem: 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şaretleyicisi buldu ve yinelenen bir yedek oluşturmak yerine bu arşivi yeniden kullandı.
• Yapılacak işlem: 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 OpenClaw bunu geçerli bir Matrix hesabına eşleyemiyor çünkü Matrix yapılandırılmamış.
• Yapılacak işlem: 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 tam geçerli hesap/cihaz kökünü hâlâ belirleyemiyor.
• Yapılacak işlem: Gateway’i çalışan bir Matrix oturumuyla 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 bir paylaşılan düz Matrix deposu buldu, ancak hangi adlandırılmış Matrix hesabının bunu alacağını tahmin etmeyi reddediyor.
• Yapılacak işlem: 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 nedenle OpenClaw bunu otomatik olarak üzerine yazmadı.
• Yapılacak işlem: çakışan hedefi elle kaldırmadan veya taşımadan önce geçerli hesabın doğru hesap olduğunu doğrulayın.

• Anlamı: OpenClaw eski Matrix durumunu taşımayı denedi ancak dosya sistemi işlemi başarısız oldu.
• Yapılacak işlem: 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 bağlayacak geçerli Matrix yapılandırması yok.
• Yapılacak işlem: 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 geçerli hesap/cihaza ait olduğuna güvenli şekilde karar veremiyor.
• Yapılacak işlem: Gateway’i çalışan bir Matrix oturumuyla 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 bir paylaşılan düz eski kripto deposu buldu, ancak hangi adlandırılmış Matrix hesabının bunu alacağını tahmin etmeyi reddediyor.
• Yapılacak işlem: 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.
• Yapılacak işlem: Matrix oturum açma 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 yardımcı giriş noktasını yükleyemedi.
• Yapılacaklar: Matrix plugin’i yeniden kurun veya onarın (openclaw plugins install @openclaw/matrix, ya da bir repo checkout’ı 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.
• npm, OpenClaw sahipli Matrix paketini deprecated olarak bildirirse, daha yeni bir npm paketi yayımlanana kadar güncel paketlenmiş bir OpenClaw derlemesindeki gömülü plugin’i veya yerel checkout yolunu kullanı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 nedenle onu içe aktarmayı reddetti.
• Yapılacaklar: Matrix plugin’i güvenilir bir yoldan yeniden kurun, 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.
• Yapılacaklar: yedekleme hatasını çözün, ardından openclaw doctor --fix komutunu yeniden çalıştırın veya gateway’i yeniden başlatın.

• Anlamı: Matrix istemci tarafı yedeği eski düz depolamayı buldu, ancak taşıma başarısız oldu. OpenClaw artık sessizce yeni bir depoyla başlamak yerine bu yedeği durdurur.
• Yapılacaklar: dosya sistemi izinlerini veya çakışmaları inceleyin, eski durumu sağlam tutun ve hatayı düzelttikten sonra yeniden deneyin.

• Anlamı: Matrix bir yol kurulumuna sabitlenmiş, bu nedenle ana hat güncellemeleri onu repo’nun standart Matrix paketiyle otomatik olarak değiştirmez.
• Yapılacaklar: varsayılan Matrix plugin’e dönmek istediğinizde openclaw plugins install @openclaw/matrix ile yeniden kurun.
• npm, OpenClaw sahipli Matrix paketini deprecated olarak bildirirse, daha yeni bir npm paketi yayımlanana kadar güncel paketlenmiş bir OpenClaw derlemesindeki gömülü plugin’i kullanın.

​

Şifreli durum kurtarma iletileri

• Anlamı: yedeklenmiş oda anahtarları yeni kripto depoya başarıyla geri yüklendi.
• Yapılacaklar: genellikle hiçbir şey.

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

• Anlamı: yedek var, ancak OpenClaw kurtarma anahtarını otomatik olarak kurtaramadı.
• Yapılacaklar: 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 kurtarmayı hazırlayacak kadar güvenli biçimde inceleyemedi.
• Yapılacaklar: openclaw doctor --fix komutunu yeniden çalıştırın. Tekrarlanırsa eski durum dizinini sağlam tutun ve başka bir doğrulanmış Matrix istemcisiyle birlikte 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 üzerine otomatik olarak yazmayı reddetti.
• Yapılacaklar: 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 katı sınırıdır.
• Yapılacaklar: 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ü.
• Yapılacaklar: 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.
• Yapılacaklar: openclaw matrix verify backup restore komutunu çalıştırın ya da gerekirse MATRIX_RECOVERY_KEY ayarlayıp printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin çalıştırın.

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

• Anlamı: depolanmış anahtar etkin Matrix yedeğiyle eşleşmiyor.
• Yapılacaklar: 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 var, ancak bu cihaz çapraz imzalama zincirine henüz yeterince güçlü biçimde güvenmiyor.
• Yapılacaklar: 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ını denediniz.
• Yapılacaklar: 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.
• Yapılacaklar: 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üvenini kurmadı. Komut çıktısında Recovery key accepted, Backup usable, Cross-signing verified ve Device verified by owner değerlerini denetleyin.
• Yapılacaklar: openclaw matrix verify self komutunu çalıştırın, isteği başka bir Matrix istemcisinde kabul edin, SAS değerini 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 bilerek değiştirmek istediğinizde printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify bootstrap --recovery-key-stdin --force-reset-cross-signing kullanın.

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

• Anlamı: bu cihaz, cihaz doğrulaması tamamlanana kadar gizli depolamadan geri yükleme yapamaz.
• Yapılacaklar: ö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 gösteriyor.
• Yapılacaklar: openclaw plugins install @openclaw/matrix ile yeniden kurun ya da bir repo checkout’ından çalışıyorsanız openclaw plugins install ./path/to/local/matrix-plugin kullanın.
• npm, OpenClaw sahipli Matrix paketini deprecated olarak bildirirse, daha yeni bir npm paketi yayımlanana kadar güncel paketlenmiş bir OpenClaw derlemesindeki gömülü plugin’i veya yerel checkout yolunu kullanın.

​

Ş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ırma.
• Matrix push kuralları: bildirim yönlendirme.
• Doctor: sağlık denetimi ve otomatik migration tetikleyicisi.
• Migration kılavuzu: tüm migration yolları (makine taşıma, sistemler arası içe aktarmalar).
• Plugins: plugin kurulumu ve kaydı.