在 CentOS 7 上安裝部署 OpenClaw(一個開源的《百戰天蟲》(Worms)風格遊戲,基於 Java 編寫)需要完成以下步驟。由於 OpenClaw 是用 Java 編寫的,主要依賴 Java 運行環境和一些圖形/音頻庫。
一、系統準備
確保你的 CentOS 7 系統是最新的:
sudo yum update -y
安裝常用工具(如 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"
...
注意:如果後續運行時提示缺少 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
- 安裝 Java 11:
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
運行:
/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 8 |
| 3 | 下載 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(百度智能雲)