Migration to openclaw-simplex

Use this guide only if you previously configured or paired the plugin under the old simplex ids. For a fresh install, start with Getting Started.

What changed in `1.0.0`

Gateway method names did not change. Programmatic invite flows still use simplex.invite.create, simplex.invite.list, and simplex.invite.revoke.

The migration helper updates config keys and stored pairing/allowlist state so existing approvals can carry forward.

Start the external SimpleX runtime

Run simplex-chat yourself and expose the WebSocket endpoint the channel should use:

simplex-chat -p 5225

Make sure your config points to that endpoint under channels.openclaw-simplex.connection.wsUrl.

Preview the migration

openclaw simplex migrate --dry-run

Review the planned config/state renames before writing anything.

Apply the migration

openclaw simplex migrate

This rewrites the old simplex config keys and renames the related pairing/allowlist state files in the OpenClaw state directory.

Verify the new ids and pairing flow

Check the plugin under its new id:

openclaw plugins info openclaw-simplex

If you need to re-add the channel explicitly, use the new channel id:

openclaw channels add --channel openclaw-simplex --url ws://127.0.0.1:5225

Pairing approval also uses the new channel id:

openclaw pairing approve openclaw-simplex <pairingCode>

Send a SimpleX message from an already approved contact and confirm the approval still holds after migration.

After migration, the channel should be configured under openclaw-simplex:

{
  "channels": {
    "openclaw-simplex": {
      "connection": {
        "wsUrl": "ws://127.0.0.1:5225"
      }
    }
  }
}