> ## Documentation Index
> Fetch the complete documentation index at: https://autclaw.shop/llms.txt
> Use this file to discover all available pages before exploring further.

# How to upgrade autClaw

> Upgrade autClaw from the web console or an IM administrator command, and confirm which runtime directories and middleware files are preserved.

This page explains how to upgrade the autClaw application version and which files can be overwritten during online updates, first-run bundle pulls, or release bundle updates. For daily upgrades, prefer the web console or an administrator IM command.

## Recommended: system upgrade in the top-right corner

1. Open the autClaw web console.
2. Click **System upgrade** in the top-right corner.
3. Select the version you want to install.
4. Click **Online upgrade**.
5. Restart when the page tells you to.

For daily autClaw upgrades, you usually do not need to pull a new Docker image or recreate the container. The Docker image is only the runtime base. The autClaw main process handles application upgrades.

## IM channel update command

In a connected IM channel, an administrator can send:

```text theme={null}
更新
```

or:

```text theme={null}
update
```

The system checks the latest version, downloads the upgrade bundle, and asks you to confirm the restart when it is ready.

<Note>
  `更新` / `update` are administrator commands. Regular users cannot trigger system upgrades with them.
</Note>

## What updates do not overwrite

Release bundles, Docker first-run downloads, and online upgrades only overwrite baseline system middleware files.

They do not overwrite:

* Your own `plugin/adapters/`
* Your own `plugin/replies/`
* Your regular `plugin/scripts/`
* The database and runtime dependency directories

## Middleware files that can be overwritten

```text theme={null}
plugin/scripts/middleware.js
plugin/scripts/middleware.py
plugin/scripts/middleware_ql.js
plugin/scripts/middleware_ql.py
plugin/scripts/middleware_dd.js
plugin/scripts/middleware_dd.py
plugin/scripts/middleware/middleware.go
```

<Note>
  The default online update source and first-run release bundle target both point to `WGwuzhi/autClaw`.
</Note>

## Before upgrading

* Do not delete the database, plugin directory, or runtime dependency paths listed in [runtime directories and paths](/en/getting-started/runtime-paths).
* If you only need to update the Docker runtime base, use [autClaw Docker operations](/en/operations/docker) to pull a new image and recreate the container.
* After an upgrade, use `docker logs -f autclaw` first when troubleshooting startup issues.