Docker — Install and Use Containers
Enables OpenClaw (and Cursor) to install Docker and use it reliably. Base all guidance on official Docker docs; when in doubt, fetch from canonical URLs below.
When to Apply
- - User wants to install Docker (macOS, Linux, Windows)
- User asks about containers, images, Dockerfile, docker compose
- Building, running, or debugging Docker commands or workflows
- User asks for "latest Docker docs" or "how do I use Docker"
Canonical Documentation URLs
| Purpose | URL |
|---|
| Get started / overview | https://docs.docker.com/get-started/overview/ |
| Get Docker (install) |
https://docs.docker.com/get-started/get-docker/ |
| Develop with containers | https://docs.docker.com/get-started/introduction/develop-with-containers/ |
| Guides | https://docs.docker.com/guides/ |
| Manuals (install, config, use) | https://docs.docker.com/manuals/ |
| Reference (CLI, Dockerfile, API) | https://docs.docker.com/reference/ |
| Engine install (Linux) | https://docs.docker.com/engine/install/ |
| Docker Desktop Mac | https://docs.docker.com/desktop/install/mac-install/ |
| Docker CLI reference | https://docs.docker.com/reference/cli/docker/ |
| Dockerfile reference | https://docs.docker.com/reference/dockerfile/ |
Rule: For install steps, CLI syntax, or Dockerfile instructions, fetch the relevant doc URL and use that content. Do not rely on training data for version-specific install or command details.
Installation (Reliable Paths)
macOS
Recommended: Docker Desktop
- 1. Download from official docs: Install Docker Desktop on Mac.
- Apple Silicon:
https://desktop.docker.com/mac/main/arm64/Docker.dmg
- Intel:
https://desktop.docker.com/mac/main/amd64/Docker.dmg
- 2. Open
Docker.dmg, drag Docker to Applications, then open Docker.app and accept terms. - CLI install (optional): After downloading the DMG:
sudo hdiutil attach Docker.dmg
sudo /Volumes/Docker/Docker.app/Contents/MacOS/install
sudo hdiutil detach /Volumes/Docker
- 4. Verify: INLINECODE3
OpenClaw / automation: If docker is missing and the user is on macOS, suggest installing via Homebrew: brew install --cask docker, then starting Docker Desktop so the daemon is running.
Linux (Ubuntu example)
- 1. Prefer Docker Engine from apt (see Install Docker Engine on Ubuntu).
- Remove conflicting packages first:
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc 2>/dev/null | cut -f1)
- 3. Add Docker’s apt repo, then:
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl start docker
sudo docker run hello-world
- 4. Optional (run without sudo): Linux postinstall — add user to
docker group.
Convenience script (dev/test only): curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh. Not recommended for production.
Windows
Use Get Docker and follow Docker Desktop for Windows (WSL2 backend recommended).
Core Workflow: Build and Run
- 1. Dockerfile in app directory (see reference.md or Dockerfile reference).
- Build image: INLINECODE8
- Run container:
docker run -d -p HOST_PORT:CONTAINER_PORT <name> (e.g. -p 127.0.0.1:3000:3000). - List containers:
docker ps (running), docker ps -a (all). - Stop/remove:
docker stop <container>, docker rm <container>.
Example from official getting-started:
CODEBLOCK3
Daemon Must Be Running
- - Docker Desktop (Mac/Windows): Ensure Docker Desktop app is running;
docker CLI talks to its daemon. - Linux:
sudo systemctl start docker (and enable if needed). - If the user sees "Cannot connect to the Docker daemon", direct them to start Docker Desktop or the engine service and try again.
Quick Reference
- - Images:
docker pull <image>, docker images, INLINECODE20 - Containers:
docker run, docker ps, docker stop, docker rm, INLINECODE25 - Compose:
docker compose up -d, docker compose down — use compose.yaml in project root (see Compose file reference). - Cleanup:
docker system prune -a (removes unused images/containers/networks; use with care).
Additional Resources
Docker — 安装与使用容器
使OpenClaw（及Cursor）能够安装Docker并可靠地使用它。所有指导均基于官方Docker文档；如有疑问，请从下方权威URL获取信息。
适用场景
- - 用户想要安装Docker（macOS、Linux、Windows）
- 用户询问关于容器、镜像、Dockerfile、docker compose 的问题
- 构建、运行或调试Docker命令或工作流
- 用户询问最新的Docker文档或如何使用Docker
权威文档URL
| 用途 | URL |
|---|
| 入门/概述 | https://docs.docker.com/get-started/overview/ |
| 获取Docker（安装） |
https://docs.docker.com/get-started/get-docker/ |
| 使用容器进行开发 | https://docs.docker.com/get-started/introduction/develop-with-containers/ |
| 指南 | https://docs.docker.com/guides/ |
| 手册（安装、配置、使用） | https://docs.docker.com/manuals/ |
| 参考（CLI、Dockerfile、API） | https://docs.docker.com/reference/ |
| 引擎安装（Linux） | https://docs.docker.com/engine/install/ |
| Docker Desktop Mac | https://docs.docker.com/desktop/install/mac-install/ |
| Docker CLI参考 | https://docs.docker.com/reference/cli/docker/ |
| Dockerfile参考 | https://docs.docker.com/reference/dockerfile/ |
规则： 对于安装步骤、CLI语法或Dockerfile指令，获取相关文档URL并使用其内容。不要依赖训练数据获取特定版本的安装或命令详情。
安装（可靠路径）
macOS
推荐：Docker Desktop
- 1. 从官方文档下载：在Mac上安装Docker Desktop。
- Apple Silicon：https://desktop.docker.com/mac/main/arm64/Docker.dmg
- Intel：https://desktop.docker.com/mac/main/amd64/Docker.dmg
- 2. 打开Docker.dmg，将Docker拖入应用程序，然后打开Docker.app并接受条款。
- CLI安装（可选）： 下载DMG后：
bash
sudo hdiutil attach Docker.dmg
sudo /Volumes/Docker/Docker.app/Contents/MacOS/install
sudo hdiutil detach /Volumes/Docker
- 4. 验证：docker run hello-world
OpenClaw / 自动化： 如果缺少docker且用户使用macOS，建议通过Homebrew安装：brew install --cask docker，然后启动Docker Desktop以使守护进程运行。
Linux（以Ubuntu为例）
- 1. 优先使用来自apt的Docker引擎（参见在Ubuntu上安装Docker引擎）。
- 首先移除冲突包：
bash
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc 2>/dev/null | cut -f1)
- 3. 添加Docker的apt仓库，然后：
bash
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl start docker
sudo docker run hello-world
- 4. 可选（无需sudo运行）：Linux安装后配置 — 将用户添加到docker组。
便捷脚本（仅限开发/测试）： curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh。不推荐用于生产环境。
Windows
使用获取Docker并按照适用于Windows的Docker Desktop（推荐WSL2后端）操作。
核心工作流：构建与运行
- 1. 在应用目录中创建Dockerfile（参见reference.md或Dockerfile参考）。
- 构建镜像： docker build -t <名称> .
- 运行容器： docker run -d -p 主机端口:容器端口 <名称>（例如-p 127.0.0.1:3000:3000）。
- 列出容器： docker ps（运行中），docker ps -a（全部）。
- 停止/删除： docker stop <容器>，docker rm <容器>。
官方入门示例：
bash
docker build -t getting-started .
docker run -d -p 127.0.0.1:3000:3000 getting-started
打开 http://localhost:3000
守护进程必须运行
- - Docker Desktop（Mac/Windows）： 确保Docker Desktop应用正在运行；docker CLI与其守护进程通信。
- Linux： sudo systemctl start docker（如需开机自启则使用enable）。
- 如果用户看到无法连接到Docker守护进程，请指导他们启动Docker Desktop或引擎服务，然后重试。
快速参考
- - 镜像： docker pull <镜像>，docker images，docker rmi <镜像>
- 容器： docker run，docker ps，docker stop，docker rm，docker logs <容器>
- Compose： docker compose up -d，docker compose down — 在项目根目录使用compose.yaml（参见Compose文件参考）。
- 清理： docker system prune -a（移除未使用的镜像/容器/网络；谨慎使用）。
其他资源
