前言¶

日常开发里，Docker 命令的坑往往不是「不会用」，而是「想不起来」：容器起了没起、端口映射写成 -p 还是 --publish、日志怎么看、进容器怎么敲命令。这些命令本身是固定的，问题在于分散在文档各处，临时去翻容易漏掉关键 flag。

docker-essentials-1-0-0 这个 Skill 做的事情就是把 Docker 的核心命令和工作流整理成一份结构化参考，让 Agent 在需要操作容器时直接取用，而不是临时拼凑命令。

这是什么¶

一句话定位：Docker 容器管理、镜像操作、调试与 Compose/网络/卷的常用命令合集。

• 名称：Docker Essentials 1.0.0
• 坐标：@clawhub_pespringer/docker-essentials-1-0-0
• 版本：1.0.0
• 发布者：pespringer
• 来源：clawhub（上游仓库 https://clawhub.ai/pespringer/docker-essentials-1-0-0）
• 许可：MIT-0
• 官方地址：https://api.skillhub.cn/zcwl/docker-essentials-1-0-0

它解决的是「命令找不全」和「flag 记不准」两个问题。全文按生命周期、调试、镜像、Compose、网络、卷、系统清理分组，每组直接给出可直接复制的命令。

需要说明的一点：官方简介写的是「核心 Docker 命令和工作流程，包括容器管理、镜像操作和调试」。它不是教学材料，不解释 Docker 原理，也不覆盖 Kubernetes、容器安全扫描这类外围主题。

核心功能¶

以下是 Skill 内已经核实存在的内容分组。

1. 容器生命周期：docker run（后台、命名、端口映射、环境变量、卷挂载、--rm、交互终端）、docker ps、docker stop|start|restart、docker rm、docker container prune。
2. 容器检查与调试：docker logs（-f、--tail、-t）、docker exec（-it、-u、-e）、docker inspect（含 JSON path 取值）、docker stats、docker top、docker cp。
3. 镜像管理：docker build（-f、--build-arg、--no-cache）、docker images、docker pull、docker tag、docker push、docker rmi、docker image prune。
4. Docker Compose：up/down（-d、-v）、logs、ps、exec、restart、build、up -d --build、--scale。
5. 网络与卷：docker network ls/create/connect/disconnect/inspect/rm、docker volume ls/create/inspect/rm/prune。
6. 系统管理：docker system df、docker system prune（含 -a 与 --volumes）、docker info、docker version。
7. 常用工作流与建议：开发容器、数据库容器、多阶段构建、.dockerignore、层数控制、镜像打版本标签、定期清理等。

其中还附带一份常用 flag 速查，覆盖 docker run 的 -d、-it、-p、-v、-e、--name、--rm、--network，以及 docker exec 的 -it、-u、-w。

安装与启用¶

上游 ClawHub 页面给出的安装命令如下。

openclaw skills install @pespringer/docker-essentials-1-0-0

这一步是把 Skill 安装到 OpenClaw 环境的 skills 目录中。同一个页面也提供了 CLI 与 Prompt 两种使用入口，其中 CLI 侧提到 npx skills 的方式。

SkillHub 侧的安装入口见官方地址 https://api.skillhub.cn/zcwl/docker-essentials-1-0-0 ，页面同时给出 SkillHub 的 skills 页面与上游仓库链接，按需选择入口即可。

配置层面没有额外要求：该 Skill 标注 requires_api_key=false，不需要提供任何 API key，也没有自定义配置字段。装完即可用，不需要写配置文件。

关于 Cursor / Codex CLI / Claude Code 等其他环境的适配，官方资料没有说明，这里不展开。

典型用法¶

以下示例全部来自 Skill 原文，可以直接复现。

开发容器，把当前目录挂进容器并开端口：

docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  -p 3000:3000 \
  node:18 \
  npm run dev

数据库容器，带环境变量与持久化卷：

docker run -d \
  --name postgres \
  -e POSTGRES_PASSWORD=secret \
  -e POSTGRES_DB=mydb \
  -v postgres-data:/var/lib/postgresql/data \
  -p 5432:5432 \
  postgres:15

快速调试，进容器、拷文件：

docker exec -it container_name sh
docker cp container_name:/path/to/file ./local/path
docker cp ./local/file container_name:/path/in/container

取容器 IP，用 JSON path 直接取字段：

docker inspect -f '{{.NetworkSettings.IPAddress}}' container_name

多阶段构建，减小镜像体积：

FROM node:18 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build

FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html

清理环境，按需选择清理范围：

docker system df
docker system prune
docker system prune -a
docker system prune --volumes

适用场景与注意¶

适合这几类人：日常用 Docker 跑本地服务、需要让 Agent 帮忙操作容器的开发者、以及想要一份统一命令清单避免团队内写法不一致的团队。

使用上的几点注意：

• 命令以官方文档为准，Skill 提供的是速查，不替代 Docker 官方文档（https://docs.docker.com/ ）。
• 涉及 Dockerfile 与 Compose 语法时，参考官方的 builder reference 与 compose file reference，不要照抄示例里的参数值。
• 示例中的密码、端口等都是占位写法，实际项目不要直接使用 secret 这类明文值。
• 清理类命令有破坏性：docker system prune --volumes 会删掉未使用的卷，可能包含数据，执行前先确认。
• Skill 内容基于常见的 Docker CLI 用法，未覆盖 Docker Desktop 特有行为、BuildKit 高级选项、安全与权限相关配置。

结尾¶

docker-essentials-1-0-0 的价值在于把零散的 Docker 命令收敛成一份按场景分组的可复用清单，装完不需要配置就能用。如果你的需求只是「快速查到正确的那条命令」，这个 Skill 足够；如果要深入镜像构建优化、容器编排或安全加固，它只是一个起点。

官方地址：https://api.skillhub.cn/zcwl/docker-essentials-1-0-0 （上游仓库 https://clawhub.ai/pespringer/docker-essentials-1-0-0 ）