OpenClaw 镜像构建

• OpenClaw 容器化部署（上篇）：快速启动指南

> 让强大的 AI 系统架构工具跑在 Docker 里——零配置、开箱即用

📦 三步搞定 OpenClaw 容器镜像

第一步：编写 Dockerfile

创建 `Dockerfile` 文件，内容如下：

FROM alpine:latest# 安装运行时依赖# - Node.js & npm：OpenClaw 的 JavaScript 运行环境# - git：源码管理和拉取依赖# - python3：支持 Python 工具链RUN apk add --no-cache nodejs npm git python3# 配置 npm 仓库（可选，用于私有源或加速）COPY .npmrc /root/.npmrc# 全局安装 OpenClaw 最新版本RUN npm install -g openclaw@latest

**💡 为什么这样做？**

- `alpine:latest` 基础镜像极轻量（仅 ~7MB），适合云原生部署

- 一键安装 OpenClaw 全家桶，无需手动配置

---

### 第二步：构建镜像

在 Dockerfile 所在目录执行：

```bash

podman build -t openclawd:0.0.1 .

```

**参数说明：**

| 参数 | 含义 |

|------|------|

| `-t openclawd:0.0.1` | 镜像名称 + 版本标签 |

| `.` | 使用当前目录的 Dockerfile |

**等待片刻后，你就有了一个可复用的 OpenClaw 镜像** ✨

---

### 第三步：快速测试运行

```bash

podman run --privileged -it \

  -p 18789-18790:18789-18790 \

  localhost/openclawd:0.0.1 \

  /bin/sh

```

**参数说明：**

| 参数 | 含义 |

|------|------|

| `--privileged` | 赋予容器特殊权限（某些系统功能需要） |

| `-it` | 交互式终端模式 |

| `-p 18789-18790:18789-18790` | 端口映射（OpenClaw Gateway API 端口） |

| `/bin/sh` | 进入容器 Shell（测试用） |

**看到 `#` 提示符就成功了！** 🎉

---

## 🚀 下一步

✅ **本篇完成了：** Dockerfile 编写 → 镜像构建 → 快速验证

⏭️ **下篇内容预告：**

- OpenClaw 容器内初始化配置（认证、Gateway 启动、插件加载）

- 容器持久化部署方案（volumes、环境变量、守护进程）

---

## 💬 常见问题

**Q: 为什么用 Alpine 而不是 Ubuntu？**  

A: Alpine 镜像仅 7MB vs Ubuntu 70MB+，拉取和启动都快，适合云环境。

**Q: 能用 Docker 替代 Podman 吗？**  

A: 完全可以，命令 100% 兼容。

**Q: 端口 18789-18790 是什么？**  

A: OpenClaw Gateway 的 HTTP API 和 WebSocket 端口，后续配置会用到。

---

**喜欢这篇文章？👍 点个赞，下篇更快到来！**

系统架构师小蒋 🏗️