在 CentOS 7 上安装部署 OpenClaw(一个开源的《百战天虫》(Worms)风格游戏,基于 Java 编写)需要完成以下步骤。由于 OpenClaw 是用 Java 编写的,主要依赖 Java 运行环境和一些图形/音频库。 一、系统准备
确保你的 CentOS 7 系统是最新的:安装常用工具(如 wget、git、unzip 等): sudo yum install -y wget git unzip 二、安装 Java 运行环境(JRE)
OpenClaw 需要 Java 8 或更高版本。CentOS 7 官方仓库中的 OpenJDK 通常为 Java 8。安装 OpenJDK 8:
sudo yum install -y java-1.8.0-openjdk验证安装: java -version你应该看到类似:text openjdk version "1.8.0_362"- <em id="__mceDel">...</em>
复制代码注意:如果后续运行时提示缺少 JavaFX,你可能需要额外处理(见下文“JavaFX 问题”)。 三、下载 OpenClaw
前往 OpenClaw GitHub Releases 页面获取最新版本。以 v0.9.5 为例(请根据实际最新版调整):- cd /opt
- sudo mkdir -p openclaw
- cd openclaw
- sudo wget https://github.com/OpenClaw/OpenClaw/releases/download/v0.9.5/openclaw-0.9.5.zip
- sudo unzip openclaw-0.9.5.zip
复制代码 或者使用 git 克隆源码(不推荐用于普通用户,除非你要编译):- git clone https://github.com/OpenClaw/OpenClaw.git
复制代码建议直接使用预编译的 release 包。 四、安装缺失的依赖(特别是 JavaFX)
OpenClaw 依赖 JavaFX,而 OpenJDK 默认不包含 JavaFX。在 CentOS 7 上,你需要手动提供 JavaFX。方法 1:使用 OpenJFX(推荐)
从 Gluon OpenJFX 下载适用于 Linux 的 JavaFX SDK。例如(以 JavaFX 17 为例,需与你的 Java 版本兼容):- cd /opt
- sudo wget https://download2.gluonhq.com/openjfx/17.0.2/openjfx-17.0.2_linux-x64_bin-sdk.zip
- sudo unzip openjfx-17.0.2_linux-x64_bin-sdk.zip
复制代码 这会生成 /opt/javafx-sdk-17.0.2 目录。修改启动脚本
OpenClaw 的启动脚本(通常是 run.sh)需要添加 JavaFX 模块路径。编辑 /opt/openclaw/run.sh(如果没有,可自己创建):- #!/bin/bash
- cd "$(dirname "$0")"
- JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk
- JAVAFX_PATH=/opt/javafx-sdk-17.0.2/lib
- $JAVA_HOME/bin/java \
- --module-path "$JAVAFX_PATH" \
- --add-modules javafx.controls,javafx.media,javafx.fxml,javafx.swing \
- -jar openclaw.jar
复制代码⚠️ 注意:Java 8 不支持 --module-path 参数!
如果你使用的是 Java 8,则必须使用 包含 JavaFX 的 JDK(如 Oracle JDK 8),或使用旧版 OpenClaw(早期版本可能不强制 JavaFX 11+)。 五、解决方案建议(针对 Java 8 用户)
由于 CentOS 7 默认只有 OpenJDK 8(无 JavaFX),而 OpenClaw 新版本要求 JavaFX 11+,你有两个选择:✅ 推荐方案:升级到 Java 11 + OpenJFX
- sudo yum install -y java-11-openjdk
复制代码
- 下载并配置 OpenJFX 11(或 17)如上。
- 使用 Java 11 运行,并指定模块路径。
替代方案:使用旧版 OpenClaw(兼容 Java 8)
查找早期版本(如 v0.8.x),这些版本可能基于 Swing 而非 JavaFX。但功能较少。 六、运行 OpenClaw
赋予脚本执行权限:- chmod +x /opt/openclaw/run.sh
复制代码 运行:如果你在图形界面(GNOME/KDE)下运行,应该能正常启动。
如果通过 SSH 无图形界面,请确保已启用 X11 转发(ssh -X)或在本地桌面环境中运行。 七、常见问题
1. “Error: JavaFX runtime components are missing”
说明未正确加载 JavaFX。请确认:
- 使用了 Java 11+
- 正确设置了 --module-path
- JavaFX 版本与 Java 主版本兼容
2. 黑屏或卡死
可能是显卡驱动问题。确保安装了 Mesa 或 NVIDIA 驱动:- sudo yum install -y mesa-libGL
复制代码 3. 声音问题
安装 ALSA/PulseAudio 支持:- sudo yum install -y alsa-lib pulseaudio-libs
复制代码 八、创建桌面快捷方式(可选)
在 ~/.local/share/applications/openclaw.desktop 创建:ini - [Desktop Entry]
- Name=OpenClaw
- Exec=/opt/openclaw/run.sh
- Icon=/opt/openclaw/icon.png
- Type=Application
- Categories=Game;
复制代码 总结
表格 步骤操作1更新系统,安装基础工具2安装 Java 11(推荐)或 Java 83下载 OpenClaw release 包4安装 OpenJFX 并配置模块路径5编写启动脚本并运行最后再给大家附上几个云厂商官方部署方法:https://developer.aliyun.com/article/1709759(阿里云)
https://cloud.tencent.com/developer/article/2624973(腾讯云)
https://cloud.baidu.com/doc/LS/s/6ml9f3cvl(百度智能云)
来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作! |