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

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

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

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

คุณไม่จำเป็นต้องเปลี่ยนชื่อคีย์การตั้งค่าหรือติดตั้ง Plugin ใหม่ภายใต้ชื่อใหม่ แพ็กเกจราก openclaw ไม่ได้รวมโค้ดรันไทม์ Matrix หรือดีเพนเดนซี Matrix SDK ไว้อีกต่อไป หาก openclaw channels status แสดงว่า Matrix ถูกตั้งค่าแล้วแต่ Plugin หายไปหลังการอัปเดต ให้รัน openclaw doctor --fix หรือ openclaw plugins install @openclaw/matrix; อย่าติดตั้งแพ็กเกจ Matrix SDK ลงในแพ็กเกจราก OpenClaw

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• การติดตั้งผ่านเส้นทาง Plugin Matrix แบบกำหนดเองจะแสดงโดยทั้งการเริ่มต้น Gateway และ openclaw doctor

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

โฟลว์อัปเกรดที่แนะนำ

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

2. รัน:

   openclaw doctor --fix

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

3. เริ่มหรือเริ่ม Gateway ใหม่

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

   openclaw matrix verify statusopenclaw matrix verify backup status

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

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

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

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

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

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

   openclaw matrix verify self

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

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

   openclaw matrix verify backup reset --yes

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

   openclaw matrix verify bootstrap

การย้ายข้อมูลเข้ารหัสทำงานอย่างไร

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

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

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

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

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

Matrix plugin upgraded in place.

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

Matrix migration snapshot created before applying Matrix upgrades.

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

Matrix migration snapshot reused before applying Matrix upgrades.

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

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

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

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

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

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

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

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

Failed migrating Matrix legacy sync store (...) หรือ Failed migrating Matrix legacy crypto store (...)

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

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

• ความหมาย: OpenClaw พบที่เก็บ Matrix แบบเข้ารหัสเก่า แต่ไม่มีการตั้งค่า Matrix ปัจจุบันให้ผูกกับที่เก็บนั้น
• สิ่งที่ต้องทำ: ตั้งค่า channels.matrix จากนั้นรัน openclaw 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...).

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

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

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

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

• ความหมาย: OpenClaw ตรวจพบสถานะ Matrix เก่า แต่การย้ายข้อมูลยังถูกบล็อกเพราะขาดข้อมูลระบุตัวตนหรือข้อมูลประจำตัว
• สิ่งที่ต้องทำ: ทำการเข้าสู่ระบบ Matrix หรือการตั้งค่าให้เสร็จ จากนั้นรัน openclaw doctor --fix อีกครั้งหรือเริ่ม 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.

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

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

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

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

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

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

Failed migrating legacy Matrix client storage: ...

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

Matrix is installed from a custom path: ...

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

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

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

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

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

• ความหมาย: กุญแจห้องเก่าบางรายการมีอยู่เฉพาะในที่เก็บภายในเครื่องเก่า และไม่เคยถูกอัปโหลดไปยังข้อมูลสำรอง 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 "openclaw matrix verify backup restore --recovery-key-stdin" after upgrade if they have the recovery key.

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

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

• ความหมาย: OpenClaw พบที่เก็บที่เข้ารหัสเก่า แต่ไม่สามารถตรวจสอบอย่างปลอดภัยพอที่จะเตรียมการกู้คืนได้
• สิ่งที่ต้องทำ: รัน openclaw doctor --fix อีกครั้ง หากเกิดซ้ำ ให้เก็บไดเรกทอรีสถานะเก่าไว้ให้สมบูรณ์ และกู้คืนโดยใช้ไคลเอนต์ Matrix อื่นที่ยืนยันแล้ว พร้อม 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.

• ความหมาย: OpenClaw ตรวจพบความขัดแย้งของกุญแจสำรอง และปฏิเสธที่จะเขียนทับไฟล์ 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 ส่งข้อผิดพลาดกลับมา
• สิ่งที่ต้องทำ: รัน openclaw matrix verify backup status แล้วลองใหม่ด้วย printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin หากจำเป็น

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

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

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

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

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

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

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

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

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

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

Matrix recovery key is required

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

Invalid Matrix recovery key: ...

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

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

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

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

• ความหมาย: secret storage ไม่ได้สร้างเซสชันข้อมูลสำรองที่ใช้งานอยู่บนอุปกรณ์นี้
• สิ่งที่ต้องทำ: ยืนยันอุปกรณ์ก่อน แล้วตรวจสอบอีกครั้งด้วย 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.

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

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

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

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

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

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

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

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

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

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

openclaw matrix verify backup reset --yesopenclaw matrix verify backup status --verboseopenclaw matrix verify status

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

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

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