Skip to main content
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.
  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: 
更新
or: 
update
The system checks the latest version, downloads the upgrade bundle, and asks you to confirm the restart when it is ready.
更新 / update are administrator commands. Regular users cannot trigger system upgrades with them.

​
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

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
The default online update source and first-run release bundle target both point to WGwuzhi/autClaw.

​
Before upgrading

  • Do not delete the database, plugin directory, or runtime dependency paths listed in runtime directories and paths.
  • If you only need to update the Docker runtime base, use autClaw Docker operations to pull a new image and recreate the container.
  • After an upgrade, use docker logs -f autclaw first when troubleshooting startup issues.
Last modified on June 3, 2026