问题现象

shell
docker build -t numb-open-claw:1.0 ..
ERROR: error during connect: Head "http://%2F%2F.%2Fpipe%2FdockerDesktopLinuxEngine/_ping": open //./pipe/dockerDesktopLinuxEngine: The system cannot find the file specified.
原因
这个报错为:Docker 客户端尝试连接 //./pipe/dockerDesktopLinuxEngine 这个管道(Docker 引擎的通信通道),但系统找不到这个文件 / 管道;
步骤 1:检查 Docker Desktop 是否启动(Windows 核心)
Windows 下 Docker 依赖 Docker Desktop 运行引擎,首先确认:
打开任务栏托盘,查看 Docker 图标:
图标显示 ✅ 表示已启动;
图标显示 ⚠️ 或无图标,说明未启动 / 启动失败。
手动启动 Docker Desktop:
双击桌面 Docker Desktop 快捷方式,或在开始菜单搜索并启动;
等待启动完成(托盘图标显示 ✅,约 1-2 分钟)。
步骤 2:修复 Docker 引擎连接配置(常见问题)
如果 Docker Desktop 已启动但仍报错,大概率是客户端配置指向错误,执行以下操作:
打开 Docker Desktop → 点击右上角设置(⚙️)→ General;
确保勾选:
Use the WSL 2 based engine(推荐,Windows 10/11 优先用 WSL2);
Start Docker Desktop when you log in(开机自启,避免下次再出问题);
切换到 Resources → WSL Integration,确保启用你正在使用的 WSL 发行版(如 Ubuntu);
点击 Apply & Restart 重启 Docker Desktop。
步骤 3:重置 Docker 客户端配置(终极修复)
如果以上步骤无效,重置 Docker 配置:
关闭 Docker Desktop(右键托盘图标 → Quit Docker Desktop);
打开命令提示符(CMD),执行以下命令重置 Docker 上下文:
cmd
查看当前 Docker 上下文
docker context ls
切换到默认上下文(desktop-linux)
docker context use default
重置 Docker 客户端配置
docker system prune -f
重新启动 Docker Desktop,等待启动完成后,执行 docker info 验证:
如果输出 Docker 引擎的版本、CPU、内存等信息,说明连接成功;
如果仍报错,继续下一步。
步骤 4:检查 WSL 2 环境(WSL 引擎模式必看)
如果启用了 WSL 2 based engine,需确保 WSL 2 安装正常:
以管理员身份打开 CMD,执行:
cmd
检查 WSL 版本
wsl --version
确保输出 WSL 2 版本,若提示未安装,执行:
wsl --install
重启电脑后,再次启动 Docker Desktop。
步骤 5:测试 Docker 连接
修复后,执行以下命令验证:
cmd
测试 Docker 引擎连通性
docker run --rm hello-world