Docker 入门与安装
不管什么系统，Docker 装好就成功一半了
为什么用 Docker
你可能听过 Docker 但没用过，或者用过但没搞懂。简单说就一句话：Docker 帮你把应用和它需要的所有依赖打包在一起，不管在哪台机器上跑，效果都一样。
用 Docker 部署 OpenClaw 有三个好处：
- 隔离 —— OpenClaw 跑在自己的容器里，不会搞乱你的系统环境
- 可复现 —— 你装好了，分享给同事，他那边也一定能跑起来
- 一键部署 —— 一条 docker run 命令就搞定，不用装一堆依赖
Ubuntu / Debian 安装 Docker
这是最常见的服务器系统，照着下面来就行：
Ubuntu / Debian 安装 Docker
# 更新包索引
sudo apt update
# 安装必要依赖
sudo apt install -y ca-certificates curl gnupg
# 添加 Docker 官方 GPG 密钥
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
# 添加 Docker 仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 安装 Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io
# 让当前用户不用 sudo 就能跑 Docker
sudo usermod -aG docker $USER
# 然后重新登录终端生效macOS 安装 Docker
Mac 上最省事的方式是用 Homebrew：
macOS 安装 Docker
# 用 Homebrew 安装 Docker Desktop
brew install --cask docker
# 安装完成后打开 Docker Desktop 应用
# 菜单栏出现小鲸鱼图标就说明启动了安装 docker-compose
docker-compose 用来管理多容器应用，OpenClaw 的正式部署会用到它：
安装 docker-compose
# Docker Desktop 自带 compose，Linux 服务器需要手动装
sudo apt install -y docker-compose-plugin
# 或者安装独立版本
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose验证安装
装完了跑两个命令确认一下：
验证安装
docker --version
# Docker version 24.x.x, build xxxxxx
docker compose version
# Docker Compose version v2.x.x
# 跑个 hello-world 测试一下
docker run hello-world从安装到跑起来
整个流程就四步：
1
安装 Docker
按上面的教程把 Docker 装好，确保 docker --version 能输出版本号。
2
安装 docker-compose
正式部署推荐用 compose 管理，比裸跑 docker run 方便。
3
拉取镜像
运行 docker pull openclaw/openclaw:latest，镜像大概几百 MB。
4
启动服务
用 docker-compose up -d 或者 docker run 把服务跑起来，然后浏览器访问 localhost:3000。
Docker Desktop vs Docker Engine：Mac 和 Windows 用 Docker Desktop（带 GUI），Linux 服务器用 Docker Engine（纯命令行）就够了。Docker Desktop 在 Linux 上也能装，但没必要，多占资源。
常用命令速查
刚接触 Docker 的话，这几个命令先记住就够用了：
Docker 常用命令
# 查看运行中的容器
docker ps
# 查看所有容器（包括停止的）
docker ps -a
# 停止容器
docker stop openclaw
# 启动容器
docker start openclaw
# 重启容器
docker restart openclaw
# 查看容器日志
docker logs openclaw
docker logs -f openclaw # 实时跟踪
# 进入容器内部
docker exec -it openclaw /bin/sh
# 删除容器
docker stop openclaw && docker rm openclaw
# 删除镜像
docker rmi openclaw/openclaw:latest