OpenClawSkills
GitHub
部署 • 6 分钟阅读

Docker 部署

在服务器和本地机器上容器化 OpenClaw 的专业部署指南。

官方镜像

官方镜像位于 <code>ghcr.io/openclaw/openclaw:latest</code>。它包含浏览器自动化和网关服务所需的所有依赖项。
Tutorial.step

快速开始

对于快速临时会话，使用最少的标志直接运行容器：

Terminal
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest \
  openclaw gateway
Tutorial.step

Docker Compose（推荐）

对于生产和长期使用，Docker Compose 是管理 OpenClaw 实例的标准方式。

docker-compose.yml
version: '3.8'
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789" # Gateway
      - "18793:18793" # Canvas Host (Optional)
    volumes:
      - ~/.openclaw:/root/.openclaw # Configuration & Workspace
    environment:
      - NODE_ENV=production
    command: openclaw gateway
Tutorial.step

卷持久化

关键：防止数据丢失

如果您不挂载这些卷，您的代理将在每次容器重启时丢失其个性、配置和记忆。
~/.openclaw

存储 openclaw.json、加密密钥和通道凭证。

~/.openclaw/workspace

工作空间。包含您的 Markdown 记忆、SOUL 和自定义技能。

Tutorial.step

高级环境变量

  • PORT：覆盖内部网关端口。
  • OPENCLAW_CONFIG_PATH：容器内配置的路径。
  • OPENCLAW_GATEWAY_TOKEN：为网关强制使用静态身份验证令牌。
Tutorial.step

Unraid 和 NAS 设置

在 Unraid 或 Synology 上部署时，确保将路径映射到您的 appdata 共享：

  • 配置路径：/mnt/user/appdata/openclaw/config 映射到 /root/.openclaw
  • 数据路径：/mnt/user/appdata/openclaw/workspace 映射到 /root/.openclaw/workspace
Tutorial.step

故障排除

日志和健康

Terminal
docker logs -f openclaw

如果您看到 Error: listen EADDRINUSE，另一个进程正在使用端口 18789。将 compose 文件中的主机端口映射更改为 "18790:18789"。

架构深度

了解 Docker 如何与代理循环交互。

下一步：架构