在 Docker 容器中部署OpenClaw

注意：docker 容器运行的 Linux 非完整系统，部分依赖于 systemd 的服务无法使用（如 openclaw-getaway），建议仅用于测试环境。本文档默认已完成 docker 环境安装。

一、拉取并运行镜像

1. 拉取镜像

为防止安装 OpenClaw 所依赖环境时出现网络问题，本人基于 Ubuntu 官方 docker 镜像，安装了基础环境和 OpenClaw 后重新打包，并通过阿里云容器镜像服务 ACR 进行分发，可通过以下命令直接拉取：

docker pull crpi-hijxdpfaextk8vbk.cn-beijing.personal.cr.aliyuncs.com/jab-public/openclaw:v3.0

注：个人版阿里云容器镜像服务的拉取服务限速 5MB/s，需稍微等待～☕️☕️☕️

v3.0为纯净安装版本，镜像内OpenClaw版本为 v2026.4.5

2. 部署容器（Docker Compose）

# docker-compose.yml
version: '3.8'
 
# 定义服务
services:
  openclaw:
    # 使用官方 Ubuntu 镜像（选择 LTS 版本更稳定）
    image: crpi-hijxdpfaextk8vbk.cn-beijing.personal.cr.aliyuncs.com/jab-public/openclaw:v2.0
    # 自定义容器名称，方便管理
    container_name: openclaw
    # 设置容器的重启策略（除非手动停止，否则一直重启）
    restart: unless-stopped
    network_mode: host
    volumes:
     - [宿主机目录]:/root/.openclaw
    # 设置环境变量
    environment:
      - TZ=Asia/Shanghai  # 设置时区为上海
      - LANG=en_US.UTF-8  # 设置字符编码
    # 可选：添加端口映射（如果容器内运行了需要对外访问的服务）
    # ports:
    #   - "8080:80"  # 宿主机 8080 端口映射到容器 80 端口

二、配置 OpenClaw

1. 初始化配置

openclaw onboard

按照提示完成配置：

Model：选择使用的 AI 模型
Channel：配置通讯渠道（如飞书）
Skills：可暂时跳过，后续再配置

2. 启动 Gateway

openclaw gateway

3. 配置渠道

根据需要配置飞书、QQ 等通讯渠道。

4. 主配置文件

编辑主配置文件：

nano ~/.openclaw/openclaw.json

注意：修改配置文件后需重启 Gateway，由于 docker 环境无法正常安装 systemd 服务，需手动 kill 后重启：

ps -ef | grep gateway
 
kill [pid]
 
openclaw gateway

三、访问方式

OpenClaw 支持多种访问方式：

1. 通讯渠道访问

如果配置了渠道（如飞书、QQ），可直接通过机器人访问。

2. TUI 终端访问

openclaw tui

3. Web 访问(需做容器的端口映射)

安装时会自动生成访问地址
在浏览器中打开该地址即可访问
Token 保存在主配置文件 ~/.openclaw/openclaw.json 中，如忘记可查看该文件

常见问题

Q1: 如何查看当前配置？

A: 查看 ~/.openclaw/openclaw.json 文件

Q2: 如何更新 OpenClaw？

A: 运行 npm update -g openclaw

窝头记

目录