Langsung ke konten
Panduan

Enkripsi dan verifikasi Matrix di OpenClaw

Mengaktifkan E2EE, tiga sinyal kepercayaan, kunci pemulihan lewat stdin, perbaikan cross-signing, cadangan kunci ruangan, verifikasi SAS, dan kebersihan perangkat

7 menit baca

Ruangan Matrix terenkripsi hanya berfungsi jika perangkat Gateway dipercaya oleh akun yang memilikinya, dan kepercayaan di Matrix adalah sebuah rantai: penyimpanan rahasia, kunci cross-signing, perangkat yang terverifikasi, dan cadangan kunci ruangan. OpenClaw membungkus rantai itu dalam sekumpulan kecil perintah dan menyatakan secara eksplisit apa yang dibuktikan oleh setiap sinyal kepercayaan. Berikut cara enkripsi diaktifkan, cara kerja status dan verifikasi, cara cross-signing di-bootstrap atau diperbaiki, cara cadangan dipulihkan atau di-reset, perintah SAS, dan catatan operasionalnya.

Pengaktifan dan status

  • Di ruangan terenkripsi, event gambar keluar menggunakan file thumbnail terenkripsi sehingga pratinjau ikut dienkripsi bersama lampirannya, tanpa konfigurasi karena plugin mendeteksi status enkripsi ruangan; setiap perintah Matrix menerima flag verbose, JSON, dan akun, dan output-nya ringkas secara default.
  • Perintah penyiapan enkripsi melakukan bootstrap penyimpanan rahasia dan cross-signing serta membuat cadangan kunci ruangan bila perlu, dengan kunci pemulihan dibaca dari stdin sehingga tidak pernah muncul di argumen proses, dan sebuah flag yang disengaja untuk membuang identitas cross-signing saat ini; akun baru dapat mengaktifkan enkripsi saat dibuat, dan kedua jalur menyelesaikan operasi kliennya sebelum menyimpan konfigurasi sehingga Gateway yang sedang berjalan dapat memuat ulang sesudahnya, sementara bootstrap yang gagal tetap menyimpan pengaturan dan melaporkan langkah berikutnya.
  • Status verifikasi melaporkan tiga sinyal independen: locally trusted, dipercaya oleh klien ini saja; cross-signing verified, dilaporkan oleh SDK; dan signed by owner, diagnostik bahwa perangkat membawa kunci self-signing Anda. Flag include-recovery-key hanya mengonfirmasi di output teks bahwa kunci mentah tersedia dan mengarahkan Anda ke JSON, yang kemudian harus dijaga kerahasiaannya.
  • Memverifikasi perangkat dengan kunci pemulihan lewat stdin melaporkan tiga status, key accepted, backup usable, dan device verified by owner, dan keluar dengan kode bukan nol bila kepercayaan identitas penuh belum lengkap, meskipun kunci itu telah membuka materi cadangan; untuk menuntaskannya diperlukan verifikasi mandiri dari klien lain, yang ditunggu oleh perintah self-verify sampai cross-signing melaporkan terverifikasi.
Verified by owner bernilai yes hanya jika Cross-signing verified bernilai yes; kepercayaan lokal atau tanda tangan pemilik saja tidak cukup.

Perbaikan dan cadangan

Perintah bootstrap adalah jalur perbaikan dan penyiapan untuk akun terenkripsi: perintah ini melakukan bootstrap penyimpanan rahasia dengan memakai ulang kunci pemulihan yang sudah ada bila memungkinkan, melakukan bootstrap cross-signing dan mengunggah kunci publik yang hilang, menandai perangkat saat ini dan melakukan cross-signing padanya, serta membuat cadangan kunci ruangan di sisi server jika belum ada; ketika homeserver mewajibkan autentikasi interaktif untuk mengunggah kunci, OpenClaw mencoba tanpa autentikasi, lalu tahap login dummy, lalu login dengan kata sandi, yang memerlukan kata sandi akun di konfigurasi. Status cadangan menunjukkan apakah cadangan di sisi server ada dan apakah perangkat ini dapat mendekripsinya, pemulihan mengimpor kunci ruangan yang dicadangkan ke penyimpanan kripto lokal, dan editan yang riwayatnya belum sepenuhnya terdekripsi diperbaiki dengan memulihkan kunci yang hilang lalu mencoba lagi, atau dengan mengirim pesan baru bila kuncinya sudah tidak ada. Reset cadangan mengganti cadangan yang rusak dengan baseline baru, dengan menerima hilangnya riwayat yang tidak dapat dipulihkan dan secara opsional membuat ulang penyimpanan rahasia, dan flag rotate hanya ditambahkan bila kunci pemulihan sebelumnya tidak boleh lagi membuka baseline baru.

SAS, akun, startup

  • Perintah verify list menampilkan permintaan yang tertunda, dan verify request mengirim satu permintaan, baik verifikasi mandiri dengan flag own-user untuk diterima di klien lain milik pengguna yang sama, maupun ke pengguna, perangkat, atau ruangan tertentu; perintah siklus hidup tingkat lebih rendah menerima permintaan, memulai alur SAS, mencetak emoji atau angka desimal, mengonfirmasi atau menolak kecocokan, dan membatalkan dengan alasan dan kode, semuanya menerima petunjuk tindak lanjut DM bila ditambatkan ke ruangan langsung.
  • Tanpa flag akun, perintah memakai akun default implisit; jika ada beberapa akun bernama tanpa default, perintah menolak menebak; dan akun bernama tanpa enkripsi melaporkan kunci konfigurasinya sendiri. Dengan enkripsi aktif, verifikasi saat startup default-nya if-unverified: perangkat yang belum terverifikasi meminta verifikasi mandiri di klien lain, melewatkan duplikat selama cooldown dua puluh empat jam yang dapat disesuaikan atau dimatikan, dan startup juga menjalankan putaran bootstrap konservatif yang mencoba perbaikan dengan pengaman tanpa kata sandi dan tetap tidak fatal bila autentikasi kata sandi diperlukan.
  • Pemberitahuan siklus hidup verifikasi, yaitu permintaan, siap dengan panduan emoji, mulai, selesai, dan detail SAS, diposting ke ruangan verifikasi DM yang ketat sebagai notice dan tidak pernah sampai ke pipeline agen; permintaan masuk dari klien lain dilacak dan diterima otomatis, dan verifikasi mandiri memulai alur SAS secara otomatis serta mengonfirmasi sisinya sendiri sementara Anda masih membandingkan di klien Anda. Perangkat yang tidak lagi tercantum di homeserver diganti dengan menambahkan akun kembali menggunakan login kata sandi atau token akses baru, perangkat usang dicantumkan dan dipangkas dengan perintah devices, dan state kripto disimpan di bawah direktori state dalam root per akun yang diindeks berdasarkan homeserver, pengguna, dan hash token; satu root lama yang tersisa adalah kesinambungan rotasi yang normal, tetapi beberapa root yang berisi data sebaiknya diperiksa dan diarsipkan, bukan dihapus.

OpenClaw di Matrix adalah artikel saluran yang diperdalam oleh tulisan ini, dan akun dan homeserver Matrix OpenClaw adalah halaman pendampingnya tentang tata letak multi-akun, homeserver privat, dan bentuk target.

Di Diali

Matrix ada dalam daftar saluran yang dapat dihubungkan di Diali, bersama WhatsApp, Telegram, Discord, Slack, Mattermost, SMS, dan suara: akun homeserver dan daftar izin ruangan adalah milik Anda, Gateway adalah milik kami. Hubungkan saluran pertama Anda dalam lima menit menjelaskan cara keduanya ditautkan, dan keamanan Diali menjelaskan batas yang berlaku untuk masing-masing.

Apa yang diberikan aturan kepercayaan ini

Mewajibkan verifikasi cross-signing alih-alih kepercayaan lokal berarti perangkat yang dicuri atau diputar ulang tidak dapat diloloskan begitu saja oleh Gateway itu sendiri; hanya pemilik akun, dari klien lain, yang dapat melengkapi rantainya. OpenClaw yang di-hosting di Diali adalah asistennya, dan OpenClaw doctor adalah perintah yang memunculkan masalah state kripto bersama masalah konfigurasi lainnya.

  • Siapkan, verifikasi, bootstrap, cadangkan: empat perintah.
  • Kunci pemulihan lewat stdin, tidak pernah di baris perintah.
  • Hanya cross-signing yang dihitung; tuntaskan dari klien lain.
Mulai sekarang

Berhenti membaca, buat agen Anda sendiri

Siapkan agen, pilih saluran, dan biarkan ia bekerja di dalam aplikasi yang sudah selalu Anda buka.