Chuyển đến nội dung chính

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.

Nâng cấp từ Plugin matrix công khai trước đây lên triển khai hiện tại. Với hầu hết người dùng, quá trình nâng cấp diễn ra tại chỗ:
  • Plugin vẫn là @openclaw/matrix
  • kênh vẫn là matrix
  • cấu hình của bạn vẫn nằm trong channels.matrix
  • thông tin xác thực đã lưu trong bộ nhớ đệm vẫn nằm trong ~/.openclaw/credentials/matrix/
  • trạng thái thời gian chạy vẫn nằm trong ~/.openclaw/matrix/
Bạn không cần đổi tên khóa cấu hình hoặc cài đặt lại Plugin dưới một tên mới.

​
Quá trình di chuyển tự động làm gì

Khi gateway khởi động, và khi bạn chạy openclaw doctor --fix, OpenClaw cố gắng tự động sửa chữa trạng thái Matrix cũ. Trước khi bất kỳ bước di chuyển Matrix có thể hành động nào thay đổi trạng thái trên đĩa, OpenClaw tạo hoặc dùng lại một snapshot khôi phục chuyên biệt. Khi bạn dùng openclaw update, tác nhân kích hoạt chính xác phụ thuộc vào cách OpenClaw được cài đặt:
  • bản cài từ mã nguồn chạy openclaw doctor --fix trong luồng cập nhật, rồi mặc định khởi động lại gateway
  • bản cài qua trình quản lý gói cập nhật gói, chạy một lượt doctor không tương tác, rồi dựa vào lần khởi động lại gateway mặc định để quá trình khởi động có thể hoàn tất di chuyển Matrix
  • nếu bạn dùng openclaw update --no-restart, quá trình di chuyển Matrix dựa vào khởi động sẽ bị hoãn cho đến khi sau này bạn chạy openclaw doctor --fix và khởi động lại gateway
Di chuyển tự động bao gồm:
  • tạo hoặc dùng lại snapshot trước di chuyển trong ~/Backups/openclaw-migrations/
  • dùng lại thông tin xác thực Matrix đã lưu trong bộ nhớ đệm của bạn
  • giữ nguyên lựa chọn tài khoản và cấu hình channels.matrix
  • di chuyển kho đồng bộ Matrix phẳng cũ nhất sang vị trí hiện tại theo phạm vi tài khoản
  • di chuyển kho mã hóa Matrix phẳng cũ nhất sang vị trí hiện tại theo phạm vi tài khoản khi có thể phân giải tài khoản đích một cách an toàn
  • trích xuất khóa giải mã bản sao lưu khóa phòng Matrix đã lưu trước đó từ kho mã hóa rust cũ, khi khóa đó tồn tại cục bộ
  • dùng lại gốc lưu trữ token-hash hiện có đầy đủ nhất cho cùng tài khoản Matrix, homeserver và người dùng khi access token thay đổi sau này
  • quét các gốc lưu trữ token-hash cùng cấp để tìm siêu dữ liệu khôi phục trạng thái mã hóa đang chờ xử lý khi access token Matrix đã thay đổi nhưng danh tính tài khoản/thiết bị vẫn giữ nguyên
  • khôi phục các khóa phòng đã sao lưu vào kho mã hóa mới ở lần khởi động Matrix tiếp theo
Chi tiết snapshot:
  • OpenClaw ghi một tệp đánh dấu tại ~/.openclaw/matrix/migration-snapshot.json sau khi snapshot thành công để các lượt khởi động và sửa chữa sau này có thể dùng lại cùng kho lưu trữ.
  • Các snapshot di chuyển Matrix tự động này chỉ sao lưu cấu hình + trạng thái (includeWorkspace: false).
  • Nếu Matrix chỉ có trạng thái di chuyển dạng cảnh báo, ví dụ vì userId hoặc accessToken vẫn còn thiếu, OpenClaw chưa tạo snapshot vì chưa có thay đổi Matrix nào có thể hành động.
  • Nếu bước snapshot thất bại, OpenClaw bỏ qua di chuyển Matrix cho lượt chạy đó thay vì thay đổi trạng thái khi không có điểm khôi phục.
Về nâng cấp nhiều tài khoản:
  • kho Matrix phẳng cũ nhất (~/.openclaw/matrix/bot-storage.json và ~/.openclaw/matrix/crypto/) đến từ bố cục một kho duy nhất, nên OpenClaw chỉ có thể di chuyển nó vào một đích tài khoản Matrix đã phân giải
  • các kho Matrix cũ đã theo phạm vi tài khoản sẽ được phát hiện và chuẩn bị theo từng tài khoản Matrix đã cấu hình

​
Quá trình di chuyển không thể tự động làm gì

Plugin Matrix công khai trước đây không tự động tạo bản sao lưu khóa phòng Matrix. Nó lưu giữ trạng thái mã hóa cục bộ và yêu cầu xác minh thiết bị, nhưng không bảo đảm rằng khóa phòng của bạn đã được sao lưu lên homeserver. Điều đó có nghĩa là một số bản cài mã hóa chỉ có thể được di chuyển một phần. OpenClaw không thể tự động khôi phục:
  • khóa phòng chỉ tồn tại cục bộ và chưa từng được sao lưu
  • trạng thái mã hóa khi tài khoản Matrix đích chưa thể được phân giải vì homeserver, userId hoặc accessToken vẫn chưa có
  • tự động di chuyển một kho Matrix phẳng dùng chung khi có nhiều tài khoản Matrix được cấu hình nhưng channels.matrix.defaultAccount chưa được đặt
  • bản cài Plugin theo đường dẫn tùy chỉnh được ghim vào đường dẫn repo thay vì gói Matrix tiêu chuẩn
  • khóa khôi phục bị thiếu khi kho cũ có các khóa đã sao lưu nhưng không giữ khóa giải mã cục bộ
Phạm vi cảnh báo hiện tại:
  • bản cài Plugin Matrix theo đường dẫn tùy chỉnh được hiển thị bởi cả quá trình khởi động gateway và openclaw doctor
Nếu bản cài cũ của bạn có lịch sử mã hóa chỉ tồn tại cục bộ và chưa từng được sao lưu, một số tin nhắn mã hóa cũ hơn có thể vẫn không đọc được sau khi nâng cấp.

​
Luồng nâng cấp được khuyến nghị

  1. Cập nhật OpenClaw và Plugin Matrix như bình thường. Nên dùng openclaw update đơn thuần, không có --no-restart, để quá trình khởi động có thể hoàn tất di chuyển Matrix ngay lập tức.
  2. Chạy: 
    openclaw doctor --fix
    Nếu Matrix có công việc di chuyển có thể hành động, doctor sẽ tạo hoặc dùng lại snapshot trước di chuyển trước và in đường dẫn kho lưu trữ.
  3. Khởi động hoặc khởi động lại gateway.
  4. Kiểm tra trạng thái xác minh và sao lưu hiện tại: 
    openclaw matrix verify status
openclaw matrix verify backup status
  5. Đặt khóa khôi phục cho tài khoản Matrix bạn đang sửa chữa vào biến môi trường dành riêng cho tài khoản. Với một tài khoản mặc định duy nhất, MATRIX_RECOVERY_KEY là được. Với nhiều tài khoản, dùng một biến cho mỗi tài khoản, ví dụ MATRIX_RECOVERY_KEY_ASSISTANT, và thêm --account assistant vào lệnh.
  6. Nếu OpenClaw cho biết cần khóa khôi phục, hãy chạy lệnh cho tài khoản tương ứng: 
    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. Nếu thiết bị này vẫn chưa được xác minh, hãy chạy lệnh cho tài khoản tương ứng: 
    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
    Nếu khóa khôi phục được chấp nhận và bản sao lưu có thể dùng được, nhưng Cross-signing verified vẫn là no, hãy hoàn tất tự xác minh từ một ứng dụng Matrix khác: 
    openclaw matrix verify self
    Chấp nhận yêu cầu trong một ứng dụng Matrix khác, so sánh emoji hoặc số thập phân, và chỉ nhập yes khi chúng khớp. Lệnh chỉ thoát thành công sau khi Cross-signing verified trở thành yes.
  8. Nếu bạn cố ý bỏ qua lịch sử cũ không thể khôi phục và muốn một đường cơ sở sao lưu mới cho các tin nhắn trong tương lai, hãy chạy: 
    openclaw matrix verify backup reset --yes
  9. Nếu chưa có bản sao lưu khóa phía máy chủ, hãy tạo một bản cho các lần khôi phục trong tương lai: 
    openclaw matrix verify bootstrap

​
Cách di chuyển mã hóa hoạt động

Di chuyển mã hóa là một quy trình hai giai đoạn:
  1. Khởi động hoặc openclaw doctor --fix tạo hoặc dùng lại snapshot trước di chuyển nếu việc di chuyển mã hóa có thể hành động.
  2. Khởi động hoặc openclaw doctor --fix kiểm tra kho mã hóa Matrix cũ thông qua bản cài Plugin Matrix đang hoạt động.
  3. Nếu tìm thấy khóa giải mã bản sao lưu, OpenClaw ghi khóa đó vào luồng khóa khôi phục mới và đánh dấu khôi phục khóa phòng là đang chờ.
  4. Ở lần khởi động Matrix tiếp theo, OpenClaw tự động khôi phục các khóa phòng đã sao lưu vào kho mã hóa mới.
Nếu kho cũ báo cáo các khóa phòng chưa từng được sao lưu, OpenClaw sẽ cảnh báo thay vì giả vờ rằng khôi phục đã thành công.

​
Thông báo thường gặp và ý nghĩa

​
Thông báo nâng cấp và phát hiện

Matrix plugin upgraded in place.
  • Ý nghĩa: trạng thái Matrix cũ trên đĩa đã được phát hiện và di chuyển vào bố cục hiện tại.
  • Cần làm gì: không cần làm gì trừ khi cùng đầu ra cũng bao gồm cảnh báo.
Matrix migration snapshot created before applying Matrix upgrades.
  • Ý nghĩa: OpenClaw đã tạo một kho lưu trữ khôi phục trước khi thay đổi trạng thái Matrix.
  • Cần làm gì: giữ đường dẫn kho lưu trữ được in ra cho đến khi bạn xác nhận di chuyển đã thành công.
Matrix migration snapshot reused before applying Matrix upgrades.
  • Ý nghĩa: OpenClaw tìm thấy một dấu đánh snapshot di chuyển Matrix hiện có và dùng lại kho lưu trữ đó thay vì tạo bản sao lưu trùng lặp.
  • Cần làm gì: giữ đường dẫn kho lưu trữ được in ra cho đến khi bạn xác nhận di chuyển đã thành công.
Legacy Matrix state detected at ... but channels.matrix is not configured yet.
  • Ý nghĩa: trạng thái Matrix cũ tồn tại, nhưng OpenClaw không thể ánh xạ nó tới tài khoản Matrix hiện tại vì Matrix chưa được cấu hình.
  • Cần làm gì: cấu hình channels.matrix, rồi chạy lại openclaw doctor --fix hoặc khởi động lại 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...).
  • Ý nghĩa: OpenClaw tìm thấy trạng thái cũ, nhưng vẫn không thể xác định chính xác gốc tài khoản/thiết bị hiện tại.
  • Cần làm gì: khởi động gateway một lần với đăng nhập Matrix hoạt động, hoặc chạy lại openclaw doctor --fix sau khi thông tin xác thực đã lưu trong bộ nhớ đệm tồn tại.
Legacy Matrix state detected at ... but multiple Matrix accounts are configured and channels.matrix.defaultAccount is not set.
  • Ý nghĩa: OpenClaw tìm thấy một kho Matrix phẳng dùng chung, nhưng từ chối đoán tài khoản Matrix được đặt tên nào nên nhận nó.
  • Cần làm gì: đặt channels.matrix.defaultAccount thành tài khoản dự định, rồi chạy lại openclaw doctor --fix hoặc khởi động lại gateway.
Matrix legacy sync store not migrated because the target already exists (...)
  • Ý nghĩa: vị trí mới theo phạm vi tài khoản đã có kho đồng bộ hoặc kho mã hóa, nên OpenClaw không tự động ghi đè.
  • Cần làm gì: xác minh rằng tài khoản hiện tại là tài khoản đúng trước khi xóa hoặc di chuyển thủ công đích xung đột.
Failed migrating Matrix legacy sync store (...) hoặc Failed migrating Matrix legacy crypto store (...)
  • Ý nghĩa: OpenClaw đã cố di chuyển trạng thái Matrix cũ nhưng thao tác hệ thống tệp thất bại.
  • Cần làm gì: kiểm tra quyền hệ thống tệp và trạng thái đĩa, rồi chạy lại openclaw doctor --fix.
Legacy Matrix encrypted state detected at ... but channels.matrix is not configured yet.
  • Ý nghĩa: OpenClaw tìm thấy một kho Matrix mã hóa cũ, nhưng không có cấu hình Matrix hiện tại để gắn nó vào.
  • Cần làm gì: cấu hình channels.matrix, rồi chạy lại openclaw doctor --fix hoặc khởi động lại 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...).
  • Ý nghĩa: kho mã hóa tồn tại, nhưng OpenClaw không thể quyết định an toàn nó thuộc về tài khoản/thiết bị hiện tại nào.
  • Cần làm gì: khởi động gateway một lần với đăng nhập Matrix hoạt động, hoặc chạy lại openclaw doctor --fix sau khi thông tin xác thực đã lưu trong bộ nhớ đệm khả dụng.
Legacy Matrix encrypted state detected at ... but multiple Matrix accounts are configured and channels.matrix.defaultAccount is not set.
  • Ý nghĩa: OpenClaw tìm thấy một kho mã hóa cũ phẳng dùng chung, nhưng từ chối đoán tài khoản Matrix được đặt tên nào nên nhận nó.
  • Cần làm gì: đặt channels.matrix.defaultAccount thành tài khoản dự định, rồi chạy lại openclaw doctor --fix hoặc khởi động lại gateway.
Matrix migration warnings are present, but no on-disk Matrix mutation is actionable yet. No pre-migration snapshot was needed.
  • Ý nghĩa: OpenClaw phát hiện trạng thái Matrix cũ, nhưng quá trình di chuyển vẫn bị chặn do thiếu dữ liệu danh tính hoặc thông tin xác thực.
  • Cần làm gì: hoàn tất đăng nhập Matrix hoặc thiết lập cấu hình, rồi chạy lại openclaw doctor --fix hoặc khởi động lại 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.
  • Ý nghĩa: OpenClaw tìm thấy trạng thái Matrix mã hóa cũ, nhưng không thể tải entrypoint trợ giúp từ Plugin Matrix vốn thường kiểm tra kho lưu trữ đó.
  • Cần làm: cài đặt lại hoặc sửa chữa Plugin Matrix (openclaw plugins install @openclaw/matrix, hoặc openclaw plugins install ./path/to/local/matrix-plugin cho một bản checkout repo), rồi chạy lại openclaw doctor --fix hoặc khởi động lại gateway.
  • Nếu npm báo cáo gói Matrix do OpenClaw sở hữu là đã ngừng khuyến nghị sử dụng, hãy dùng Plugin được đóng gói kèm từ một bản dựng OpenClaw đóng gói hiện tại hoặc đường dẫn checkout cục bộ cho đến khi một gói npm mới hơn được phát hành.
Matrix plugin helper path is unsafe: ... Reinstall @openclaw/matrix and try again.
  • Ý nghĩa: OpenClaw tìm thấy một đường dẫn tệp trợ giúp thoát ra ngoài gốc Plugin hoặc không vượt qua được kiểm tra ranh giới Plugin, nên đã từ chối nhập nó.
  • Cần làm: cài đặt lại Plugin Matrix từ một đường dẫn đáng tin cậy, rồi chạy lại openclaw doctor --fix hoặc khởi động lại gateway.
- Failed creating a Matrix migration snapshot before repair: ... - Skipping Matrix migration changes for now. Resolve the snapshot failure, then rerun "openclaw doctor --fix".
  • Ý nghĩa: OpenClaw từ chối thay đổi trạng thái Matrix vì trước tiên không thể tạo snapshot khôi phục.
  • Cần làm: xử lý lỗi sao lưu, rồi chạy lại openclaw doctor --fix hoặc khởi động lại gateway.
Failed migrating legacy Matrix client storage: ...
  • Ý nghĩa: fallback phía máy khách Matrix tìm thấy kho lưu trữ phẳng cũ, nhưng thao tác di chuyển thất bại. OpenClaw hiện hủy bỏ fallback đó thay vì âm thầm khởi động với một kho lưu trữ mới.
  • Cần làm: kiểm tra quyền hệ thống tệp hoặc các xung đột, giữ nguyên trạng thái cũ, rồi thử lại sau khi sửa lỗi.
Matrix is installed from a custom path: ...
  • Ý nghĩa: Matrix được ghim vào một bản cài đặt theo đường dẫn, nên các bản cập nhật mainline không tự động thay thế nó bằng gói Matrix chuẩn của repo.
  • Cần làm: cài đặt lại bằng openclaw plugins install @openclaw/matrix khi bạn muốn quay lại Plugin Matrix mặc định.
  • Nếu npm báo cáo gói Matrix do OpenClaw sở hữu là đã ngừng khuyến nghị sử dụng, hãy dùng Plugin được đóng gói kèm từ một bản dựng OpenClaw đóng gói hiện tại cho đến khi một gói npm mới hơn được phát hành.

​
Thông báo khôi phục trạng thái mã hóa

matrix: restored X/Y room key(s) from legacy encrypted-state backup
  • Ý nghĩa: các khóa phòng đã sao lưu được khôi phục thành công vào kho crypto mới.
  • Cần làm: thường không cần làm gì.
matrix: N legacy local-only room key(s) were never backed up and could not be restored automatically
  • Ý nghĩa: một số khóa phòng cũ chỉ tồn tại trong kho cục bộ cũ và chưa từng được tải lên bản sao lưu Matrix.
  • Cần làm: dự kiến một phần lịch sử mã hóa cũ sẽ vẫn không khả dụng, trừ khi bạn có thể khôi phục các khóa đó theo cách thủ công từ một máy khách đã xác minh khác.
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.
  • Ý nghĩa: bản sao lưu tồn tại, nhưng OpenClaw không thể tự động khôi phục khóa khôi phục.
  • Cần làm: chạy printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin.
Failed inspecting legacy Matrix encrypted state for account "..." (...): ...
  • Ý nghĩa: OpenClaw tìm thấy kho mã hóa cũ, nhưng không thể kiểm tra kho đó đủ an toàn để chuẩn bị khôi phục.
  • Cần làm: chạy lại openclaw doctor --fix. Nếu lỗi lặp lại, giữ nguyên thư mục trạng thái cũ và khôi phục bằng một máy khách Matrix đã xác minh khác cộng với 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.
  • Ý nghĩa: OpenClaw phát hiện xung đột khóa sao lưu và từ chối tự động ghi đè tệp recovery-key hiện tại.
  • Cần làm: xác minh khóa khôi phục nào là chính xác trước khi thử lại bất kỳ lệnh khôi phục nào.
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.
  • Ý nghĩa: đây là giới hạn cứng của định dạng lưu trữ cũ.
  • Cần làm: các khóa đã sao lưu vẫn có thể được khôi phục, nhưng lịch sử mã hóa chỉ có cục bộ có thể vẫn không khả dụng.
matrix: failed restoring room keys from legacy encrypted-state backup: ...
  • Ý nghĩa: Plugin mới đã thử khôi phục nhưng Matrix trả về lỗi.
  • Cần làm: chạy openclaw matrix verify backup status, rồi thử lại với printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin nếu cần.

​
Thông báo khôi phục thủ công

Backup key is not loaded on this device. Run 'openclaw matrix verify backup restore' to load it and restore old room keys.
  • Ý nghĩa: OpenClaw biết bạn phải có khóa sao lưu, nhưng khóa đó chưa hoạt động trên thiết bị này.
  • Cần làm: chạy openclaw matrix verify backup restore, hoặc đặt MATRIX_RECOVERY_KEY và chạy printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin nếu cần.
Store a recovery key with 'openclaw matrix verify device --recovery-key-stdin', then run 'openclaw matrix verify backup restore'.
  • Ý nghĩa: thiết bị này hiện chưa lưu khóa khôi phục.
  • Cần làm: đặt MATRIX_RECOVERY_KEY, chạy printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin, rồi khôi phục bản sao lưu.
Backup key mismatch on this device. Re-run 'openclaw matrix verify device --recovery-key-stdin' with the matching recovery key.
  • Ý nghĩa: khóa đã lưu không khớp với bản sao lưu Matrix đang hoạt động.
  • Cần làm: đặt MATRIX_RECOVERY_KEY thành khóa chính xác và chạy printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin.
Nếu bạn chấp nhận mất lịch sử mã hóa cũ không thể khôi phục, thay vào đó bạn có thể đặt lại baseline sao lưu hiện tại bằng openclaw matrix verify backup reset --yes. Khi bí mật sao lưu đã lưu bị hỏng, thao tác đặt lại đó cũng có thể tạo lại kho lưu trữ bí mật để khóa sao lưu mới có thể tải đúng sau khi khởi động lại. Backup trust chain is not verified on this device. Re-run 'openclaw matrix verify device --recovery-key-stdin'.
  • Ý nghĩa: bản sao lưu tồn tại, nhưng thiết bị này chưa đủ tin cậy chuỗi ký chéo.
  • Cần làm: đặt MATRIX_RECOVERY_KEY và chạy printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin.
Matrix recovery key is required
  • Ý nghĩa: bạn đã thử một bước khôi phục mà không cung cấp khóa khôi phục khi khóa đó là bắt buộc.
  • Cần làm: chạy lại lệnh với --recovery-key-stdin, ví dụ printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin.
Invalid Matrix recovery key: ...
  • Ý nghĩa: khóa được cung cấp không thể phân tích cú pháp hoặc không khớp định dạng mong đợi.
  • Cần làm: thử lại với đúng khóa khôi phục từ máy khách Matrix hoặc tệp recovery-key của bạn.
Matrix recovery key was applied, but this device still lacks full Matrix identity trust.
  • Ý nghĩa: OpenClaw có thể áp dụng khóa khôi phục, nhưng Matrix vẫn chưa thiết lập đầy đủ độ tin cậy danh tính ký chéo cho thiết bị này. Kiểm tra đầu ra lệnh để tìm Recovery key accepted, Backup usable, Cross-signing verified, và Device verified by owner.
  • Cần làm: chạy openclaw matrix verify self, chấp nhận yêu cầu trong một máy khách Matrix khác, so sánh SAS, và chỉ nhập yes khi nó khớp. Lệnh chờ đến khi có đầy đủ độ tin cậy danh tính Matrix trước khi báo thành công. Chỉ dùng printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify bootstrap --recovery-key-stdin --force-reset-cross-signing khi bạn chủ ý muốn thay thế danh tính ký chéo hiện tại.
Matrix key backup is not active on this device after loading from secret storage.
  • Ý nghĩa: kho lưu trữ bí mật không tạo ra phiên sao lưu hoạt động trên thiết bị này.
  • Cần làm: xác minh thiết bị trước, rồi kiểm tra lại bằng 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.
  • Ý nghĩa: thiết bị này không thể khôi phục từ kho lưu trữ bí mật cho đến khi hoàn tất xác minh thiết bị.
  • Cần làm: chạy printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin trước.

​
Thông báo cài đặt Plugin tùy chỉnh

Matrix is installed from a custom path that no longer exists: ...
  • Ý nghĩa: bản ghi cài đặt Plugin của bạn trỏ đến một đường dẫn cục bộ không còn tồn tại.
  • Cần làm: cài đặt lại bằng openclaw plugins install @openclaw/matrix, hoặc nếu bạn đang chạy từ một bản checkout repo, dùng openclaw plugins install ./path/to/local/matrix-plugin.
  • Nếu npm báo cáo gói Matrix do OpenClaw sở hữu là đã ngừng khuyến nghị sử dụng, hãy dùng Plugin được đóng gói kèm từ một bản dựng OpenClaw đóng gói hiện tại hoặc đường dẫn checkout cục bộ cho đến khi một gói npm mới hơn được phát hành.

​
Nếu lịch sử mã hóa vẫn không quay lại

Chạy các kiểm tra này theo thứ tự: 
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
Nếu bản sao lưu khôi phục thành công nhưng một số phòng cũ vẫn thiếu lịch sử, các khóa bị thiếu đó có lẽ chưa từng được Plugin trước đó sao lưu.

​
Nếu bạn muốn bắt đầu lại từ đầu cho các tin nhắn trong tương lai

Nếu bạn chấp nhận mất lịch sử mã hóa cũ không thể khôi phục và chỉ muốn một baseline sao lưu sạch cho tương lai, hãy chạy các lệnh này theo thứ tự: 
openclaw matrix verify backup reset --yes
openclaw matrix verify backup status --verbose
openclaw matrix verify status
Nếu sau đó thiết bị vẫn chưa được xác minh, hãy hoàn tất xác minh từ máy khách Matrix của bạn bằng cách so sánh emoji SAS hoặc mã thập phân và xác nhận rằng chúng khớp.

​
Liên quan