前言¶
日常开发里，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 内已经核实存在的内容分组。
- 容器生命周期：
docker run（后台、命名、端口映射、环境变量、卷挂载、--rm、交互终端）、docker ps、docker stop|start|restart、docker rm、docker container prune。 - 容器检查与调试：
docker logs（-f、--tail、-t）、docker exec（-it、-u、-e）、docker inspect（含 JSON path 取值）、docker stats、docker top、docker cp。 - 镜像管理：
docker build（-f、--build-arg、--no-cache）、docker images、docker pull、docker tag、docker push、docker rmi、docker image prune。 - Docker Compose：
up/down（-d、-v）、logs、ps、exec、restart、build、up -d --build、--scale。 - 网络与卷：
docker network ls/create/connect/disconnect/inspect/rm、docker volume ls/create/inspect/rm/prune。 - 系统管理：
docker system df、docker system prune（含-a与--volumes）、docker info、docker version。 - 常用工作流与建议：开发容器、数据库容器、多阶段构建、
.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 ）
