Upgrade OpenClaw

Before upgrading an existing OpenClaw installation, review the version-specific changes and troubleshooting steps on this page to ensure a smooth transition.

Upgrade to 2026.03.22

Prerequisite

You must upgrade your Olares OS to V1.12.5 before updating OpenClaw to 2026.03.22.

The OpenClaw 2026.03.22 update introduced several changes that restrict plugin permissions. Because of this security enhancement, older plugins might no longer be compatible. For more information, see the OpenClaw release notes.

If you find that a previously working plugin is unavailable after upgrading to this version, try the following solutions:

• Update the plugin: Check if a newer version is available that complies with the updated permission restrictions.
• Verify configuration methods: Check with the plugin provider to see if new configurations are required for OpenClaw 2026.03.22 and later.

Upgrade to 2026.02.25

The OpenClaw 2026.02.25 update introduced a security enhancement that requires existing users to explicitly declare the allowed Control UI access address. Therefore, if your Control UI fails to start after the upgrade, follow these steps to resolve the issue.

1. Open Control Hub on your desktop to check the container logs for clawdbot.

   

2. Look for the following error message. If it appears, proceed to the next step.

   Gateway failed to start: Error: non-loopback Control UI requires gateway.controlUi.allowedOrigins (set explicit origins), or set gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true to use Host-header origin fallback mode

   

3. Open Settings, go to Application > OpenClaw > Control UI > Set up endpoint, and then copy the endpoint address.

   

4. Open Files, go to Application > Data > clawdbot > config, right-click the openclaw.json file, and then download it.

   

5. Open the downloaded file in a text editor, find the gateway section, and then add a controlUi block with your endpoint address.

   "controlUi": {
     "allowedOrigins": ["Endpoint-Address"]
   },

   

   INFO

   If you access the Control UI using multiple addresses such as local URLs or custom domains, add them to the allowedOrigins array separated by commas. For example, ["https://url-one.com", "https://url-two.com"].

6. Return to Files, rename the original openclaw.json file to keep it as a backup, and then upload your modified openclaw.json file.

7. Return to Control Hub, click clawdbot under Deployments, and then click Restart in the upper-right corner.

   

8. In the Restart clawdbot window, type clawdbot exactly as shown, and then click Confirm. Wait for the program status to show as Running, which is indicated by a green dot.

   

9. Check the container logs again to verify the gateway has started successfully.

   

10. Open the Control UI. Refresh the browser page if an error still displays.