Skip to main content
After deployment, day-to-day maintenance is mostly logs, image updates, and switching image variants. Data lives in /opt/autclaw, so recreating the container with a different image does not lose it.

The two images

The ffmpeg in the full image handles audio and video transcoding:
  • Feishu: voice to Opus, video to MP4
  • WeChat Official Account: voice to AMR, AMR to WAV
  • Qianxun: voice to AMR, video to MP4
QQ, Telegram, and the official WeChat Bot send media in its original format, so the slim image is enough. Neither image includes Chromium. If you need web screenshots, install it temporarily as shown below.

View logs

Stop or remove the container

Removing the container does not delete the data in /opt/autclaw.

Update the image

Upgrading the autClaw application does not require recreating the container. Use System upgrade in the top-right corner of the web console instead; see How to upgrade autClaw.

Switch between slim and full

Only the image name changes; keep the same volume:
Change the image back to :latest to return to the slim image.

Add ffmpeg temporarily

If you want to try transcoding on the slim image, install ffmpeg inside the running container. It takes effect immediately:
Packages installed this way are lost when the container is recreated or the image is updated. For long-term use, switch to :full or build your own image.

Web screenshots (Chromium)

Chromium is about 300MB, and the full dependency tree usually pushes it past 400MB, so neither image bundles it. Install it when needed:
Chinese text needs a font: fonts-wqy-zenhei is about 16MB and covers common characters; fonts-noto-cjk is about 91MB and has broader coverage. The container runs as root by default, so Chromium must be started with --no-sandbox. Without it you will see Running as root without --no-sandbox is not supported; add the flag in your plugin (chromedp: chromedp.Flag("no-sandbox", true)).

Long-term option: build your own image

Bake the dependencies into the image so they survive container recreation. If you only need transcoding, use :full directly and skip the build. If you need transcoding plus screenshots, build your own image:

Use Docker Compose

Save the following as compose.yaml, then run docker compose up -d:
  • Change variants: set image to nolan1121953/autclaw:full.
  • Change directories: replace /opt/autclaw on the left side of volumes with your NAS path.
  • Change ports: replace the host port on the left side of "8200:8200".
Last modified on October 28, 2026