错误本质是客户端调用的api版本低于服务端最低要求，需通过which docker确认实际执行路径、journalctl查daemon声明的minimum client api版本、env检查docker_api_version变量、ps和daemon.json排查daemon降级配置。

升级 Docker 后出现“client version too old”类错误，本质是客户端调用的 API 版本低于服务端要求（比如报错提示 client version 1.22 is too old. Minimum supported API version is 1.24），但你本地 docker --version 显示的是新版本（如 26.1.4）——这说明实际执行命令的不是你预期的那个 docker 客户端。日志本身不直接记录“哪个 docker 二进制被调用了”，但可通过系统级日志和诊断命令快速交叉定位。

查当前实际调用的 docker 路径和版本

这是最直接的第一步，绕过 PATH 混淆：

• 运行 which docker 看路径（例如输出 /usr/bin/docker 或 /usr/local/bin/docker）
• 立刻执行该路径下的版本检查：/usr/bin/docker --version（替换为上一步结果）
• 再对比 docker version（不带路径）的输出，若两者版本不一致，就确认了 PATH 中存在多个版本，且旧版路径优先

看 systemd 日志确认服务端 API 版本要求

Docker daemon 启动时会在日志中声明它支持的最小客户端 API 版本。执行：

OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

• sudo journalctl -u docker.service --since "1 hour ago" | grep -i "api\|version"
• 重点关注类似 API listen on /var/run/docker.sock, minimum client API version: 1.24 的行（不同版本措辞略有差异，但必含 minimum client API 或 min api version）
• 该值就是你客户端必须满足的底线，不是看 server version 数字，而是看这个明确声明的 minimum

检查环境变量是否覆盖了 API 版本

即使客户端版本够新，如果设置了 DOCKER_API_VERSION 环境变量指向一个过低的值（如 1.22），也会触发同样报错：

• 运行 env | grep DOCKER_API_VERSION
• 如果输出非空（例如 DOCKER_API_VERSION=1.22），立即 unset：unset DOCKER_API_VERSION
• 临时测试：在 unset 后重试原命令；若恢复正常，说明是该变量导致“降级”了客户端行为

扫一眼进程启动参数确认 daemon 是否被降级启动

极少数情况是 Docker daemon 自身被手动指定了旧版兼容参数（如 --api-cors-header 或通过 daemon.json 强制限制）：

• 运行 ps aux | grep dockerd，查看启动命令中是否含 --api-version 或类似显式降级参数
• 检查配置文件：sudo cat /etc/docker/daemon.json 2>/dev/null，确认没有 "api-version" 或 "experimental" 相关异常配置
• 若 daemon 配置异常，修改后需 sudo systemctl restart docker