การย้ายข้อมูล Matrix

อัปเกรดจาก Plugin matrix สาธารณะก่อนหน้าไปยังการใช้งานปัจจุบัน

สำหรับผู้ใช้ส่วนใหญ่ การอัปเกรดจะทำในที่เดิม:

• Plugin ยังคงเป็น @OmeniaClaw/matrix
• ช่องทางยังคงเป็น matrix
• การกำหนดค่าของคุณยังอยู่ใต้ channels.matrix
• ข้อมูลรับรองที่แคชไว้ยังอยู่ใต้ ~/.OmeniaClaw/credentials/matrix/
• สถานะ runtime ยังอยู่ใต้ ~/.OmeniaClaw/matrix/

คุณไม่จำเป็นต้องเปลี่ยนชื่อคีย์การกำหนดค่าหรือติดตั้ง Plugin ใหม่ภายใต้ชื่อใหม่

การย้ายข้อมูลทำอะไรให้อัตโนมัติ

เมื่อ Gateway เริ่มทำงาน และเมื่อคุณรัน OmeniaClaw doctor --fix, OmeniaClaw จะพยายามซ่อมแซมสถานะ Matrix เก่าโดยอัตโนมัติ ก่อนที่ขั้นตอนการย้ายข้อมูล Matrix ที่ดำเนินการได้จะเปลี่ยนแปลงสถานะบนดิสก์ OmeniaClaw จะสร้างหรือใช้สแนปช็อตกู้คืนเฉพาะทางซ้ำ

เมื่อคุณใช้ OmeniaClaw update ตัวกระตุ้นที่แน่นอนจะขึ้นอยู่กับวิธีติดตั้ง OmeniaClaw:

• การติดตั้งจากซอร์สจะรัน OmeniaClaw doctor --fix ระหว่างขั้นตอนอัปเดต แล้วรีสตาร์ต Gateway โดยค่าเริ่มต้น
• การติดตั้งผ่าน package manager จะอัปเดตแพ็กเกจ รันรอบ doctor แบบไม่โต้ตอบ แล้วพึ่งพาการรีสตาร์ต Gateway ค่าเริ่มต้นเพื่อให้การเริ่มทำงานทำการย้ายข้อมูล Matrix ให้เสร็จ
• หากคุณใช้ OmeniaClaw update --no-restart การย้ายข้อมูล Matrix ที่พึ่งพาการเริ่มทำงานจะถูกเลื่อนออกไปจนกว่าคุณจะรัน OmeniaClaw doctor --fix ในภายหลังและรีสตาร์ต Gateway

การย้ายข้อมูลอัตโนมัติครอบคลุม:

• การสร้างหรือใช้สแนปช็อตก่อนย้ายข้อมูลซ้ำใต้ ~/Backups/OmeniaClaw-migrations/
• การใช้ข้อมูลรับรอง Matrix ที่แคชไว้ของคุณซ้ำ
• การคงการเลือกบัญชีและการกำหนดค่า channels.matrix เดิมไว้
• การย้าย sync store แบบแบนของ Matrix ที่เก่าที่สุดไปยังตำแหน่งปัจจุบันที่แยกตามบัญชี
• การย้าย crypto store แบบแบนของ Matrix ที่เก่าที่สุดไปยังตำแหน่งปัจจุบันที่แยกตามบัญชี เมื่อสามารถระบุบัญชีปลายทางได้อย่างปลอดภัย
• การดึงคีย์ถอดรหัสข้อมูลสำรอง room-key ของ Matrix ที่เคยบันทึกไว้จาก rust crypto store เก่า เมื่อคีย์นั้นมีอยู่ในเครื่อง
• การใช้ root การจัดเก็บ token-hash ที่มีอยู่และสมบูรณ์ที่สุดซ้ำสำหรับบัญชี Matrix, homeserver และผู้ใช้เดียวกันเมื่อ access token เปลี่ยนในภายหลัง
• การสแกน root การจัดเก็บ token-hash ข้างเคียงเพื่อหาเมทาดาทาการกู้คืนสถานะเข้ารหัสที่ค้างอยู่ เมื่อ access token ของ Matrix เปลี่ยนแต่ข้อมูลประจำตัวบัญชี/อุปกรณ์ยังคงเดิม
• การกู้คืน room keys ที่สำรองไว้เข้าสู่ crypto store ใหม่ในการเริ่ม Matrix ครั้งถัดไป

รายละเอียดสแนปช็อต:

• OmeniaClaw เขียนไฟล์ตัวทำเครื่องหมายที่ ~/.OmeniaClaw/matrix/migration-snapshot.json หลังจากสแนปช็อตสำเร็จ เพื่อให้รอบเริ่มทำงานและรอบซ่อมแซมภายหลังสามารถใช้ archive เดิมซ้ำได้
• สแนปช็อตการย้ายข้อมูล Matrix อัตโนมัติเหล่านี้สำรองเฉพาะ config + state (includeWorkspace: false)
• หาก Matrix มีเพียงสถานะการย้ายข้อมูลระดับคำเตือนเท่านั้น เช่น เพราะ userId หรือ accessToken ยังขาดอยู่ OmeniaClaw จะยังไม่สร้างสแนปช็อต เพราะยังไม่มีการเปลี่ยนแปลง Matrix ที่ดำเนินการได้
• หากขั้นตอนสแนปช็อตล้มเหลว OmeniaClaw จะข้ามการย้ายข้อมูล Matrix สำหรับรอบนั้น แทนที่จะเปลี่ยนแปลงสถานะโดยไม่มีจุดกู้คืน

เกี่ยวกับการอัปเกรดหลายบัญชี:

• store แบบแบนของ Matrix ที่เก่าที่สุด (~/.OmeniaClaw/matrix/bot-storage.json และ ~/.OmeniaClaw/matrix/crypto/) มาจากเลย์เอาต์แบบ store เดียว ดังนั้น OmeniaClaw จึงย้ายข้อมูลไปยังเป้าหมายบัญชี Matrix ที่ระบุได้เพียงบัญชีเดียว
• store Matrix แบบเก่าที่แยกตามบัญชีอยู่แล้วจะถูกตรวจพบและเตรียมต่อบัญชี Matrix ที่กำหนดค่าไว้

สิ่งที่การย้ายข้อมูลทำให้อัตโนมัติไม่ได้

Plugin Matrix สาธารณะก่อนหน้า ไม่ได้ สร้างข้อมูลสำรอง room-key ของ Matrix โดยอัตโนมัติ มันคงสถานะ crypto ในเครื่องและขอการยืนยันอุปกรณ์ แต่ไม่ได้รับประกันว่า room keys ของคุณถูกสำรองไปยัง homeserver แล้ว

นั่นหมายความว่าการติดตั้งแบบเข้ารหัสบางชุดสามารถย้ายข้อมูลได้เพียงบางส่วนเท่านั้น

OmeniaClaw ไม่สามารถกู้คืนโดยอัตโนมัติได้:

• room keys ที่มีเฉพาะในเครื่องและไม่เคยถูกสำรอง
• สถานะเข้ารหัสเมื่อยังไม่สามารถระบุบัญชี Matrix ปลายทางได้ เพราะ homeserver, userId หรือ accessToken ยังไม่พร้อมใช้งาน
• การย้ายข้อมูลอัตโนมัติของ store Matrix แบบแบนที่ใช้ร่วมกันหนึ่งรายการ เมื่อกำหนดค่าหลายบัญชี Matrix แต่ไม่ได้ตั้งค่า channels.matrix.defaultAccount
• การติดตั้ง Plugin ผ่านพาธกำหนดเองที่ pin ไว้กับพาธ repo แทนแพ็กเกจ Matrix มาตรฐาน
• คีย์กู้คืนที่ขาดหายเมื่อ store เก่ามีคีย์ที่สำรองไว้ แต่ไม่ได้เก็บคีย์ถอดรหัสไว้ในเครื่อง

ขอบเขตคำเตือนปัจจุบัน:

• การติดตั้ง Plugin Matrix ผ่านพาธกำหนดเองจะแสดงทั้งตอน Gateway เริ่มทำงานและใน OmeniaClaw doctor

หากการติดตั้งเก่าของคุณมีประวัติเข้ารหัสเฉพาะในเครื่องที่ไม่เคยสำรอง ข้อความเข้ารหัสเก่าบางรายการอาจยังอ่านไม่ได้หลังอัปเกรด

ขั้นตอนอัปเกรดที่แนะนำ

1. อัปเดต OmeniaClaw และ Plugin Matrix ตามปกติ ควรใช้ OmeniaClaw update แบบธรรมดาโดยไม่มี --no-restart เพื่อให้การเริ่มทำงานทำการย้ายข้อมูล Matrix ให้เสร็จทันที

2. รัน:

   OmeniaClaw doctor --fix

   หาก Matrix มีงานย้ายข้อมูลที่ดำเนินการได้ doctor จะสร้างหรือใช้สแนปช็อตก่อนย้ายข้อมูลซ้ำก่อน และพิมพ์พาธ archive

3. เริ่มหรือรีสตาร์ต Gateway

4. ตรวจสอบสถานะการยืนยันและการสำรองปัจจุบัน:

   OmeniaClaw matrix verify statusOmeniaClaw matrix verify backup status

5. ใส่คีย์กู้คืนสำหรับบัญชี Matrix ที่คุณกำลังซ่อมในตัวแปรสภาพแวดล้อมเฉพาะบัญชี สำหรับบัญชีค่าเริ่มต้นบัญชีเดียว MATRIX_RECOVERY_KEY ใช้ได้ สำหรับหลายบัญชี ให้ใช้ตัวแปรหนึ่งตัวต่อบัญชี เช่น MATRIX_RECOVERY_KEY_ASSISTANT และเพิ่ม --account assistant ในคำสั่ง

6. หาก OmeniaClaw บอกว่าต้องใช้คีย์กู้คืน ให้รันคำสั่งสำหรับบัญชีที่ตรงกัน:

   printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify backup restore --recovery-key-stdinprintf '%s\n' "$MATRIX_RECOVERY_KEY_ASSISTANT" | OmeniaClaw matrix verify backup restore --recovery-key-stdin --account assistant

7. หากอุปกรณ์นี้ยังไม่ได้รับการยืนยัน ให้รันคำสั่งสำหรับบัญชีที่ตรงกัน:

   printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify device --recovery-key-stdinprintf '%s\n' "$MATRIX_RECOVERY_KEY_ASSISTANT" | OmeniaClaw matrix verify device --recovery-key-stdin --account assistant

   หากคีย์กู้คืนได้รับการยอมรับและข้อมูลสำรองใช้งานได้ แต่ Cross-signing verified ยังเป็น no ให้ทำ self-verification ให้เสร็จจากไคลเอนต์ Matrix อีกตัว:

   OmeniaClaw matrix verify self

   ยอมรับคำขอในไคลเอนต์ Matrix อีกตัว เปรียบเทียบ emoji หรือทศนิยม และพิมพ์ yes เฉพาะเมื่อค่าตรงกันเท่านั้น คำสั่งจะจบสำเร็จเฉพาะ หลังจาก Cross-signing verified กลายเป็น yes

8. หากคุณตั้งใจละทิ้งประวัติเก่าที่กู้คืนไม่ได้และต้องการ baseline สำรองใหม่สำหรับข้อความในอนาคต ให้รัน:

   OmeniaClaw matrix verify backup reset --yes

9. หากยังไม่มีข้อมูลสำรองคีย์ฝั่งเซิร์ฟเวอร์ ให้สร้างรายการหนึ่งสำหรับการกู้คืนในอนาคต:

   OmeniaClaw matrix verify bootstrap

วิธีทำงานของการย้ายข้อมูลเข้ารหัส

การย้ายข้อมูลเข้ารหัสเป็นกระบวนการสองระยะ:

1. การเริ่มทำงานหรือ OmeniaClaw doctor --fix สร้างหรือใช้สแนปช็อตก่อนย้ายข้อมูลซ้ำ หากการย้ายข้อมูลเข้ารหัสดำเนินการได้
2. การเริ่มทำงานหรือ OmeniaClaw doctor --fix ตรวจสอบ crypto store ของ Matrix เก่าผ่านการติดตั้ง Plugin Matrix ที่ใช้งานอยู่
3. หากพบคีย์ถอดรหัสข้อมูลสำรอง OmeniaClaw จะเขียนคีย์นั้นเข้าสู่โฟลว์ recovery-key ใหม่และทำเครื่องหมายว่าการกู้คืน room-key ค้างอยู่
4. ในการเริ่ม Matrix ครั้งถัดไป OmeniaClaw จะกู้คืน room keys ที่สำรองไว้เข้าสู่ crypto store ใหม่โดยอัตโนมัติ

หาก store เก่ารายงาน room keys ที่ไม่เคยถูกสำรอง OmeniaClaw จะเตือนแทนที่จะแสร้งว่ากู้คืนสำเร็จ

ข้อความทั่วไปและความหมาย

ข้อความการอัปเกรดและการตรวจพบ

Matrix plugin upgraded in place.

• ความหมาย: ตรวจพบสถานะ Matrix บนดิสก์เก่าและย้ายเข้าสู่เลย์เอาต์ปัจจุบันแล้ว
• สิ่งที่ต้องทำ: ไม่ต้องทำอะไร เว้นแต่ผลลัพธ์เดียวกันจะมีคำเตือนด้วย

Matrix migration snapshot created before applying Matrix upgrades.

• ความหมาย: OmeniaClaw สร้าง archive กู้คืนก่อนเปลี่ยนแปลงสถานะ Matrix
• สิ่งที่ต้องทำ: เก็บพาธ archive ที่พิมพ์ออกมาไว้จนกว่าคุณจะยืนยันว่าการย้ายข้อมูลสำเร็จ

Matrix migration snapshot reused before applying Matrix upgrades.

• ความหมาย: OmeniaClaw พบตัวทำเครื่องหมายสแนปช็อตการย้ายข้อมูล Matrix ที่มีอยู่ และใช้ archive นั้นซ้ำแทนการสร้างข้อมูลสำรองซ้ำ
• สิ่งที่ต้องทำ: เก็บพาธ archive ที่พิมพ์ออกมาไว้จนกว่าคุณจะยืนยันว่าการย้ายข้อมูลสำเร็จ

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

• ความหมาย: มีสถานะ Matrix เก่าอยู่ แต่ OmeniaClaw ไม่สามารถแมปไปยังบัญชี Matrix ปัจจุบันได้ เพราะ Matrix ยังไม่ได้กำหนดค่า
• สิ่งที่ต้องทำ: กำหนดค่า channels.matrix แล้วรัน OmeniaClaw doctor --fix อีกครั้งหรือรีสตาร์ต 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...).

• ความหมาย: OmeniaClaw พบสถานะเก่า แต่ยังไม่สามารถระบุ root บัญชี/อุปกรณ์ปัจจุบันที่แน่นอนได้
• สิ่งที่ต้องทำ: เริ่ม Gateway หนึ่งครั้งด้วยการเข้าสู่ระบบ Matrix ที่ใช้งานได้ หรือรัน OmeniaClaw doctor --fix อีกครั้งหลังจากมีข้อมูลรับรองที่แคชไว้

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

• ความหมาย: OmeniaClaw พบ store Matrix แบบแบนที่ใช้ร่วมกันหนึ่งรายการ แต่ปฏิเสธที่จะเดาว่าบัญชี Matrix ที่ตั้งชื่อไว้บัญชีใดควรรับข้อมูลนั้น
• สิ่งที่ต้องทำ: ตั้งค่า channels.matrix.defaultAccount เป็นบัญชีที่ต้องการ แล้วรัน OmeniaClaw doctor --fix อีกครั้งหรือรีสตาร์ต Gateway

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

• ความหมาย: ตำแหน่งใหม่ที่แยกตามบัญชีมี sync หรือ crypto store อยู่แล้ว ดังนั้น OmeniaClaw จึงไม่เขียนทับโดยอัตโนมัติ
• สิ่งที่ต้องทำ: ตรวจสอบว่าบัญชีปัจจุบันเป็นบัญชีที่ถูกต้องก่อนลบหรือย้ายเป้าหมายที่ขัดแย้งด้วยตนเอง

Failed migrating Matrix legacy sync store (...) or Failed migrating Matrix legacy crypto store (...)

• ความหมาย: OmeniaClaw พยายามย้ายสถานะ Matrix เก่า แต่การดำเนินการระบบไฟล์ล้มเหลว
• สิ่งที่ต้องทำ: ตรวจสอบสิทธิ์ระบบไฟล์และสถานะดิสก์ แล้วรัน OmeniaClaw doctor --fix อีกครั้ง

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

• ความหมาย: OmeniaClaw พบ store Matrix เข้ารหัสเก่า แต่ไม่มีการกำหนดค่า Matrix ปัจจุบันให้แนบเข้าด้วย
• สิ่งที่ต้องทำ: กำหนดค่า channels.matrix แล้วรัน OmeniaClaw doctor --fix อีกครั้งหรือรีสตาร์ต 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...).

• ความหมาย: มี store เข้ารหัสอยู่ แต่ OmeniaClaw ไม่สามารถตัดสินใจอย่างปลอดภัยได้ว่าเป็นของบัญชี/อุปกรณ์ปัจจุบันใด
• สิ่งที่ต้องทำ: เริ่ม Gateway หนึ่งครั้งด้วยการเข้าสู่ระบบ Matrix ที่ใช้งานได้ หรือรัน OmeniaClaw doctor --fix อีกครั้งหลังจากมีข้อมูลรับรองที่แคชไว้

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

• ความหมาย: OmeniaClaw พบ legacy crypto store แบบแบนที่ใช้ร่วมกันหนึ่งรายการ แต่ปฏิเสธที่จะเดาว่าบัญชี Matrix ที่ตั้งชื่อไว้บัญชีใดควรรับข้อมูลนั้น
• สิ่งที่ต้องทำ: ตั้งค่า channels.matrix.defaultAccount เป็นบัญชีที่ต้องการ แล้วรัน OmeniaClaw doctor --fix อีกครั้งหรือรีสตาร์ต Gateway

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

• ความหมาย: OmeniaClaw ตรวจพบสถานะ Matrix เก่า แต่การย้ายข้อมูลยังถูกบล็อกเพราะขาดข้อมูลระบุตัวตนหรือข้อมูลรับรอง
• สิ่งที่ต้องทำ: ทำการเข้าสู่ระบบ Matrix หรือการตั้งค่า config ให้เสร็จ แล้วรัน OmeniaClaw doctor --fix อีกครั้งหรือรีสตาร์ต Gateway

Legacy Matrix encrypted state was detected, but the Matrix plugin helper is unavailable. Install or repair @OmeniaClaw/matrix so OmeniaClaw can inspect the old rust crypto store before upgrading.

• ความหมาย: OmeniaClaw พบสถานะ Matrix เข้ารหัสเก่า แต่โหลด helper entrypoint จาก Plugin Matrix ที่ปกติใช้ตรวจสอบ store นั้นไม่ได้
• สิ่งที่ต้องทำ: ติดตั้งใหม่หรือซ่อมแซม Plugin Matrix (OmeniaClaw plugins install @OmeniaClaw/matrix หรือ OmeniaClaw plugins install ./path/to/local/matrix-plugin สำหรับ repo checkout) แล้วรัน OmeniaClaw doctor --fix อีกครั้งหรือรีสตาร์ต Gateway

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

• ความหมาย: OmeniaClaw พบพาธไฟล์ตัวช่วยที่หลุดออกจากรากของ Plugin หรือไม่ผ่านการตรวจสอบขอบเขต Plugin จึงปฏิเสธที่จะนำเข้าไฟล์นั้น
• สิ่งที่ต้องทำ: ติดตั้ง Matrix Plugin ใหม่จากพาธที่เชื่อถือได้ จากนั้นรัน OmeniaClaw doctor --fix อีกครั้ง หรือรีสตาร์ท gateway

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

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

• ความหมาย: OmeniaClaw ปฏิเสธที่จะเปลี่ยนแปลงสถานะ Matrix เพราะไม่สามารถสร้างสแนปช็อตสำหรับกู้คืนก่อน
• สิ่งที่ต้องทำ: แก้ไขข้อผิดพลาดของการสำรองข้อมูล แล้วรัน OmeniaClaw doctor --fix อีกครั้ง หรือรีสตาร์ท gateway

Failed migrating legacy Matrix client storage: ...

• ความหมาย: fallback ฝั่งไคลเอนต์ Matrix พบพื้นที่จัดเก็บแบบแบนเดิม แต่การย้ายล้มเหลว ตอนนี้ OmeniaClaw จะยกเลิก fallback นั้นแทนที่จะเริ่มด้วย store ใหม่แบบเงียบๆ
• สิ่งที่ต้องทำ: ตรวจสอบสิทธิ์ของระบบไฟล์หรือข้อขัดแย้ง รักษาสถานะเดิมไว้ไม่ให้เสียหาย แล้วลองอีกครั้งหลังแก้ไขข้อผิดพลาด

Matrix is installed from a custom path: ...

• ความหมาย: Matrix ถูกตรึงไว้กับการติดตั้งจากพาธ ดังนั้นการอัปเดต mainline จะไม่แทนที่ด้วยแพ็กเกจ Matrix มาตรฐานของ repo โดยอัตโนมัติ
• สิ่งที่ต้องทำ: ติดตั้งใหม่ด้วย OmeniaClaw plugins install @OmeniaClaw/matrix เมื่อต้องการกลับไปใช้ Matrix Plugin ค่าเริ่มต้น

ข้อความการกู้คืนสถานะที่เข้ารหัส

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

• ความหมาย: กู้คืนคีย์ห้องที่สำรองไว้เข้าสู่ crypto store ใหม่สำเร็จแล้ว
• สิ่งที่ต้องทำ: โดยปกติไม่ต้องทำอะไร

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

• ความหมาย: คีย์ห้องเก่าบางรายการมีอยู่เฉพาะใน store ภายในเครื่องเดิม และไม่เคยถูกอัปโหลดไปยังข้อมูลสำรองของ Matrix
• สิ่งที่ต้องทำ: คาดว่าประวัติที่เข้ารหัสเก่าบางส่วนจะยังไม่พร้อมใช้งาน เว้นแต่คุณจะกู้คืนคีย์เหล่านั้นด้วยตนเองจากไคลเอนต์อื่นที่ยืนยันแล้วได้

Legacy Matrix encrypted state for account "..." has backed-up room keys, but no local backup decryption key was found. Ask the operator to run "OmeniaClaw matrix verify backup restore --recovery-key-stdin" after upgrade if they have the recovery key.

• ความหมาย: มีข้อมูลสำรองอยู่ แต่ OmeniaClaw ไม่สามารถกู้คืน recovery key โดยอัตโนมัติ
• สิ่งที่ต้องทำ: รัน printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify backup restore --recovery-key-stdin

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

• ความหมาย: OmeniaClaw พบ encrypted store เดิม แต่ไม่สามารถตรวจสอบอย่างปลอดภัยพอเพื่อเตรียมการกู้คืน
• สิ่งที่ต้องทำ: รัน OmeniaClaw doctor --fix อีกครั้ง หากยังเกิดซ้ำ ให้รักษาไดเรกทอรีสถานะเดิมไว้ไม่ให้เสียหาย และกู้คืนโดยใช้ไคลเอนต์ Matrix อื่นที่ยืนยันแล้วร่วมกับ printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw 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.

• ความหมาย: OmeniaClaw ตรวจพบข้อขัดแย้งของ backup key และปฏิเสธที่จะเขียนทับไฟล์ recovery-key ปัจจุบันโดยอัตโนมัติ
• สิ่งที่ต้องทำ: ตรวจสอบว่า recovery key ใดถูกต้องก่อนลองคำสั่งกู้คืนใดๆ อีกครั้ง

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.

• ความหมาย: นี่คือข้อจำกัดจริงของรูปแบบพื้นที่จัดเก็บเดิม
• สิ่งที่ต้องทำ: คีย์ที่สำรองไว้ยังสามารถกู้คืนได้ แต่ประวัติที่เข้ารหัสแบบ local-only อาจยังไม่พร้อมใช้งาน

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

• ความหมาย: Plugin ใหม่พยายามกู้คืนแล้ว แต่ Matrix ส่งคืนข้อผิดพลาด
• สิ่งที่ต้องทำ: รัน OmeniaClaw matrix verify backup status แล้วลองอีกครั้งด้วย printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify backup restore --recovery-key-stdin หากจำเป็น

ข้อความการกู้คืนด้วยตนเอง

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

• ความหมาย: OmeniaClaw รู้ว่าคุณควรมี backup key แต่คีย์นั้นยังไม่ active บนอุปกรณ์นี้
• สิ่งที่ต้องทำ: รัน OmeniaClaw matrix verify backup restore หรือกำหนด MATRIX_RECOVERY_KEY แล้วรัน printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify backup restore --recovery-key-stdin หากจำเป็น

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

• ความหมาย: อุปกรณ์นี้ยังไม่มี recovery key ที่จัดเก็บไว้
• สิ่งที่ต้องทำ: กำหนด MATRIX_RECOVERY_KEY รัน printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify device --recovery-key-stdin จากนั้นกู้คืนข้อมูลสำรอง

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

• ความหมาย: คีย์ที่จัดเก็บไว้ไม่ตรงกับข้อมูลสำรอง Matrix ที่ active
• สิ่งที่ต้องทำ: กำหนด MATRIX_RECOVERY_KEY เป็นคีย์ที่ถูกต้อง แล้วรัน printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify device --recovery-key-stdin

หากคุณยอมรับการสูญเสียประวัติที่เข้ารหัสเก่าซึ่งกู้คืนไม่ได้ คุณสามารถรีเซ็ต baseline ข้อมูลสำรองปัจจุบันด้วย OmeniaClaw matrix verify backup reset --yes แทนได้ เมื่อ backup secret ที่จัดเก็บไว้เสียหาย การรีเซ็ตนั้นอาจสร้าง secret storage ใหม่ด้วย เพื่อให้ backup key ใหม่โหลดได้อย่างถูกต้องหลังรีสตาร์ท

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

• ความหมาย: มีข้อมูลสำรองอยู่ แต่อุปกรณ์นี้ยังไม่เชื่อถือ cross-signing chain มากพอ
• สิ่งที่ต้องทำ: กำหนด MATRIX_RECOVERY_KEY แล้วรัน printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify device --recovery-key-stdin

Matrix recovery key is required

• ความหมาย: คุณพยายามทำขั้นตอนกู้คืนโดยไม่ได้ระบุ recovery key ทั้งที่จำเป็นต้องใช้
• สิ่งที่ต้องทำ: รันคำสั่งอีกครั้งพร้อม --recovery-key-stdin เช่น printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify device --recovery-key-stdin

Invalid Matrix recovery key: ...

• ความหมาย: คีย์ที่ระบุไม่สามารถแยกวิเคราะห์ได้ หรือไม่ตรงกับรูปแบบที่คาดไว้
• สิ่งที่ต้องทำ: ลองอีกครั้งด้วย recovery key ที่ตรงจากไคลเอนต์ Matrix หรือไฟล์ recovery-key ของคุณ

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

• ความหมาย: OmeniaClaw สามารถใช้ recovery key ได้ แต่ Matrix ยังไม่ได้ สร้างความเชื่อถือ identity แบบ cross-signing เต็มรูปแบบสำหรับอุปกรณ์นี้ ตรวจสอบ เอาต์พุตคำสั่งสำหรับ Recovery key accepted, Backup usable, Cross-signing verified และ Device verified by owner
• สิ่งที่ต้องทำ: รัน OmeniaClaw matrix verify self ยอมรับคำขอใน ไคลเอนต์ Matrix อื่น เปรียบเทียบ SAS แล้วพิมพ์ yes เฉพาะเมื่อค่าตรงกัน คำสั่งจะรอจนกว่าจะมีความเชื่อถือ identity ของ Matrix เต็มรูปแบบก่อนรายงานว่าสำเร็จ ใช้ printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify bootstrap --recovery-key-stdin --force-reset-cross-signing เฉพาะเมื่อคุณตั้งใจจะแทนที่ cross-signing identity ปัจจุบันเท่านั้น

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

• ความหมาย: secret storage ไม่ได้สร้างเซสชันข้อมูลสำรองที่ active บนอุปกรณ์นี้
• สิ่งที่ต้องทำ: ยืนยันอุปกรณ์ก่อน จากนั้นตรวจสอบอีกครั้งด้วย OmeniaClaw matrix verify backup status

Matrix crypto backend cannot load backup keys from secret storage. Verify this device with 'OmeniaClaw matrix verify device --recovery-key-stdin' first.

• ความหมาย: อุปกรณ์นี้ไม่สามารถกู้คืนจาก secret storage ได้จนกว่าการยืนยันอุปกรณ์จะเสร็จสมบูรณ์
• สิ่งที่ต้องทำ: รัน printf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify device --recovery-key-stdin ก่อน

ข้อความการติดตั้ง Plugin แบบกำหนดเอง

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

• ความหมาย: ระเบียนการติดตั้ง Plugin ของคุณชี้ไปยังพาธภายในเครื่องที่ไม่มีอยู่แล้ว
• สิ่งที่ต้องทำ: ติดตั้งใหม่ด้วย OmeniaClaw plugins install @OmeniaClaw/matrix หรือหากคุณรันจาก repo checkout ให้ใช้ OmeniaClaw plugins install ./path/to/local/matrix-plugin

หากประวัติที่เข้ารหัสยังไม่กลับมา

รันการตรวจสอบเหล่านี้ตามลำดับ:

OmeniaClaw matrix verify status --verboseOmeniaClaw matrix verify backup status --verboseprintf '%s\n' "$MATRIX_RECOVERY_KEY" | OmeniaClaw matrix verify backup restore --recovery-key-stdin --verbose

หากกู้คืนข้อมูลสำรองสำเร็จ แต่บางห้องเก่ายังไม่มีประวัติ แสดงว่าคีย์ที่หายไปเหล่านั้นน่าจะไม่เคยถูกสำรองโดย Plugin ก่อนหน้า

หากคุณต้องการเริ่มใหม่สำหรับข้อความในอนาคต

หากคุณยอมรับการสูญเสียประวัติที่เข้ารหัสเก่าซึ่งกู้คืนไม่ได้ และต้องการเพียง baseline ข้อมูลสำรองที่สะอาดสำหรับอนาคต ให้รันคำสั่งเหล่านี้ตามลำดับ:

OmeniaClaw matrix verify backup reset --yesOmeniaClaw matrix verify backup status --verboseOmeniaClaw matrix verify status

หากอุปกรณ์ยังไม่ได้รับการยืนยันหลังจากนั้น ให้ดำเนินการยืนยันให้เสร็จจากไคลเอนต์ Matrix ของคุณโดยเปรียบเทียบอีโมจิ SAS หรือรหัสทศนิยม และยืนยันว่าตรงกัน

ที่เกี่ยวข้อง

• Matrix: การตั้งค่าและการกำหนดค่าช่องทาง
• กฎ push ของ Matrix: การกำหนดเส้นทางการแจ้งเตือน
• Doctor: การตรวจสุขภาพและตัวกระตุ้นการย้ายข้อมูลอัตโนมัติ
• คู่มือการย้ายข้อมูล: เส้นทางการย้ายข้อมูลทั้งหมด (การย้ายเครื่อง, การนำเข้าข้ามระบบ)
• Plugins: การติดตั้งและการลงทะเบียน Plugin