If the device is still unverified after that, finish verification from your Matrix client by comparing the SAS emoji or decimal codes and confirming that they match.

## Related pages

## Related

- [Matrix](/channels/matrix)

- [Doctor](/gateway/doctor)

- [Migrating](/install/migrating)

- [Plugins](/tools/plugin)

- [Matrix](/channels/matrix): channel setup and config.

- [Matrix push rules](/channels/matrix-push-rules): notification routing.

- [Doctor](/gateway/doctor): health check and automatic migration trigger.

- [Migration guide](/install/migrating): all migration paths (machine moves, cross-system imports).

- [Plugins](/tools/plugin): plugin install and registration.

Startup also runs a conservative crypto bootstrap pass that reuses the current secret storage and cross-signing identity. If bootstrap state is broken, OpenClaw attempts a guarded repair even without `channels.matrix.password`; if the homeserver requires password UIA, startup logs a warning and stays non-fatal. Already-owner-signed devices are preserved.

See [Matrix migration](/install/migrating-matrix) for the full upgrade flow.

See [Matrix migration](/channels/matrix-migration) for the full upgrade flow.

</Accordion>

]

},

"redirects": [

{

"source": "/install/migrating-matrix",

"destination": "/channels/matrix-migration"

},

{

"source": "/help/gpt54-codex-agentic-parity",

"destination": "/help/gpt55-codex-agentic-parity"

"pages": [

"install/migrating",

"install/migrating-claude",

"install/migrating-hermes",

"install/migrating-matrix"

"install/migrating-hermes"

]

},

"install/uninstall",

"channels/imessage",

"channels/bluebubbles",

"channels/matrix",

"channels/matrix-migration",

"channels/matrix-push-rules"

]

},

## Upgrade a plugin in place

In-place plugin upgrades preserve the same plugin id and config keys but may move on-disk state into the current layout. The Matrix plugin is the largest example because of its encrypted-state recovery requirements.

In-place plugin upgrades preserve the same plugin id and config keys but may move on-disk state into the current layout. Plugin-specific upgrade guides live alongside their channels:

<CardGroup cols={1}>

<Card title="Matrix plugin migration" href="/install/migrating-matrix" icon="key">

Encrypted-state recovery limits, automatic snapshot behavior, and manual recovery commands for the Matrix plugin.

</Card>

</CardGroup>

- [Matrix migration](/channels/matrix-migration): encrypted-state recovery limits, automatic snapshot behavior, and manual recovery commands.

## Related