核心是用docker load加载docker save导出的tar包，不依赖网络，需确保架构匹配（如arm设备用arm64镜像）、存储驱动兼容、磁盘内存充足，并通过docker images和docker run验证成功导入与运行。

在嵌入式设备上导入轻量 Docker 镜像，核心是用 docker load 命令加载通过 docker save 导出的 tar 包。整个过程不依赖网络拉取，适合离线、带宽受限或无公网访问能力的嵌入式环境。

确认镜像导出格式是否兼容

导出时必须使用 docker save（不是 docker export），否则无法还原镜像元数据和分层结构：

• docker save -o app.tar myapp:1.0 → 正确：保存完整镜像（含标签、历史层、配置）
• docker export -o container.tar container_id → 错误：仅导出容器文件系统快照，无镜像信息，不能直接 load

导出包需完整传输到嵌入式设备，建议校验 SHA256 值确保未损坏。

OpenClaw Docker Setup

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

下载

在嵌入式设备上执行导入

导入前确认 Docker 已运行（systemctl status docker 或 docker info），然后执行：

• docker load -i app.tar → 自动恢复镜像名、TAG 和所有镜像层
• 如需重命名或打标，可追加：docker tag myapp:1.0 myapp:embedded
• 验证是否成功：docker images | grep myapp，应显示 REPOSITORY、TAG、IMAGE ID 和 SIZE

适配嵌入式环境的关键细节

轻量镜像导入后能否正常运行，还需注意三点：

• 架构匹配：ARM 设备（如树莓派、RK3566）必须导入 arm64v8 或 linux/arm64 镜像，x86_64 镜像无法运行（除非启用 qemu-user-static，但性能损耗大）
• 存储驱动兼容性：嵌入式 Linux 常用 overlay2，若目标设备用 aufs 或 devicemapper，可能报错；可通过 docker info | grep "Storage Driver" 检查并提前统一
• 磁盘空间与内存：轻量镜像（如 alpine:latest 约 5MB）更稳妥；导入前运行 df -h /var/lib/docker 和 free -h 确保余量充足

验证镜像可用性

导入后别跳过测试，尤其在资源受限设备上：

• docker run --rm myapp:1.0 echo "OK" → 快速验证基础运行能力
• 若含端口暴露，加 -p 8080:80 并用 curl http://localhost:8080 测试服务可达性
• 查看日志：docker run --rm -it myapp:1.0 sh -c "cat /proc/version"，确认内核兼容性