错误本质是客户端调用的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
