跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
Shell / Bash

使用 Docker 在 Ubuntu 虚拟机中安装 OpenClaw

综述由AI生成如何在 Ubuntu 虚拟机环境中通过 Docker 部署 OpenClaw 游戏引擎。主要步骤包括安装 Docker 环境、编写 Dockerfile 构建镜像、运行容器并配置图形界面支持,以及获取必要的游戏资源文件。同时提供了常见问题的解决方案,如 X11 显示权限和资源缺失问题,帮助用户顺利完成本地化部署。

竹影清风发布于 2026/3/23更新于 2026/4/265.1K 浏览
使用 Docker 在 Ubuntu 虚拟机中安装 OpenClaw

图片

前提条件
  • 已安装并运行的虚拟机(推荐使用 Ubuntu 或其他 Linux 发行版)
  • 虚拟机已连接网络
  • 具有 sudo 或 root 权限

步骤 1:在虚拟机上安装 Docker

Ubuntu/Debian 系统
# 更新包列表
sudo apt update
# 安装必要的依赖
sudo apt install apt-transport-https ca-certificates curl software-properties-common
# 添加 Docker GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
# 添加 Docker 仓库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
# 再次更新包列表
sudo apt update
# 安装 Docker
sudo apt install docker-ce
# 验证 Docker 是否安装成功
sudo docker --version
CentOS/RHEL 系统
# 安装必要的依赖
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
# 添加 Docker 仓库
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
# 安装 Docker
sudo yum install docker-ce docker-ce-cli containerd.io
# 启动 Docker 服务
sudo systemctl start docker
# 验证 Docker 是否安装成功
sudo docker --version

步骤 2:获取 OpenClaw Docker 镜像

目前官方可能没有提供 OpenClaw 的 Docker 镜像,因此我们需要创建一个 Dockerfile 来构建镜像。

创建 Dockerfile

在虚拟机中创建一个名为 Dockerfile 的文件,内容如下:

# 使用 Ubuntu 作为基础镜像
FROM ubuntu:20.04
# 设置环境变量
ENV DEBIAN_FRONTEND=noninteractive
# 更新包列表并安装依赖
RUN apt update && apt install -y \
    build-essential \
    cmake \
    git \
    libsdl2-dev \
    libsdl2-image-dev \
    libsdl2-mixer-dev \
    libsdl2-ttf-dev \
    libpng-dev \
    libjpeg-dev \
    libvorbis-dev \
    libogg-dev \
    && rm -rf /var/lib/apt/lists/*
# 克隆 OpenClaw 仓库
RUN git clone https://github.com/OpenClaw/openclaw.git /openclaw
# 构建 OpenClaw
WORKDIR /openclaw
RUN mkdir build && cd build && cmake .. && make
# 设置工作目录
WORKDIR /openclaw/build
# 运行 OpenClaw
CMD ["./openclaw"]
构建 Docker 镜像
# 在包含 Dockerfile 的目录中执行
sudo docker build -t openclaw .

步骤 3:运行 OpenClaw 容器

基本运行命令
sudo docker run -it --name openclaw-container openclaw
带图形界面的运行命令

由于 OpenClaw 是一个图形界面应用,需要将 X11 显示传递给容器:

# 允许 X11 连接
xhost +local:docker
# 运行容器并映射 X11 显示
sudo docker run -it --name openclaw-container \
-e DISPLAY=$DISPLAY \
-v /tmp/.X11-unix:/tmp/.X11-unix \
openclaw

步骤 4:获取游戏资源文件

OpenClaw 需要原始 Claw 游戏的资源文件才能运行。你需要:

  1. 拥有原始 Claw 游戏
  2. 将游戏资源文件复制到容器中
# 假设游戏资源在主机的 /path/to/claw/assets 目录
sudo docker cp /path/to/claw/assets openclaw-container:/openclaw/build

可能的问题及解决方案

1. 图形界面显示问题
  • 确保虚拟机已安装并运行 X11 服务器
  • 确保容器能够访问 X11 显示
2. 缺少游戏资源
  • 确保已正确复制原始 Claw 游戏的资源文件到容器中
3. 权限问题
  • 确保使用 sudo 或具有适当权限运行 Docker 命令

总结

通过以上步骤,你应该能够在虚拟机上使用 Docker 成功安装和运行 OpenClaw。如果遇到任何问题,可以查看 Docker 和 OpenClaw 的官方文档获取更多帮助。

注意:OpenClaw 是一个开源项目,使用它需要你拥有原始 Claw 游戏的合法副本。请确保你已购买并拥有原始游戏,以遵守相关版权法律。

目录

  1. 前提条件
  2. 步骤 1:在虚拟机上安装 Docker
  3. Ubuntu/Debian 系统
  4. 更新包列表
  5. 安装必要的依赖
  6. 添加 Docker GPG 密钥
  7. 添加 Docker 仓库
  8. 再次更新包列表
  9. 安装 Docker
  10. 验证 Docker 是否安装成功
  11. CentOS/RHEL 系统
  12. 安装必要的依赖
  13. 添加 Docker 仓库
  14. 安装 Docker
  15. 启动 Docker 服务
  16. 验证 Docker 是否安装成功
  17. 步骤 2:获取 OpenClaw Docker 镜像
  18. 创建 Dockerfile
  19. 使用 Ubuntu 作为基础镜像
  20. 设置环境变量
  21. 更新包列表并安装依赖
  22. 克隆 OpenClaw 仓库
  23. 构建 OpenClaw
  24. 设置工作目录
  25. 运行 OpenClaw
  26. 构建 Docker 镜像
  27. 在包含 Dockerfile 的目录中执行
  28. 步骤 3:运行 OpenClaw 容器
  29. 基本运行命令
  30. 带图形界面的运行命令
  31. 允许 X11 连接
  32. 运行容器并映射 X11 显示
  33. 步骤 4:获取游戏资源文件
  34. 假设游戏资源在主机的 /path/to/claw/assets 目录
  35. 可能的问题及解决方案
  36. 1. 图形界面显示问题
  37. 2. 缺少游戏资源
  38. 3. 权限问题
  39. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • GPT-5.5 超高智商模型1元抵1刀ChatGPT中转购买
  • 代充Chatgpt Plus/pro 帐号了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • QGroundControl 跨平台安装与配置教程
  • OpenGlass:大模型赋能的开源智能眼镜方案,支持语音控制与 AR 叠加
  • Python 推导式底层实现:从语法糖到 CPython 字节码分析
  • Linux 进程状态详解:内核视角与代码实例
  • Python 爬虫技术实战指南:从入门到分布式采集
  • 基于Python的B站用户视频喜好倾向分析与可视化系统
  • 大模型微调实战指南:使用 LLaMA Factory
  • 萤石可编程设备 Python SDK 使用说明
  • Nginx 反向代理配置 React 前端与 Python 后端
  • Neo4j 图数据库安装与操作指南
  • GitHub Copilot 配置性能优化关键技术
  • OpenClaw macOS Sequoia M1 Pro 架构安装指南
  • AIGC 在元宇宙与虚拟世界中的应用及技术实现
  • LLM 大模型学习指南:从原理到工程化应用实战
  • Ubuntu 24.04 安装 ToDesk 远程桌面及配置
  • Python 变量命名规则与规范代码习惯
  • Python 分支结构与循环结构应用实战
  • Flutter 三方库 dart_webrtc 的鸿蒙化适配指南
  • 大语言模型基础:核心概念、架构与应用详解
  • Qt 与 Linux Socket 跨平台通信深度解析

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online