博客 / 詳情

返回

centos7安裝部署openclaw

在 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

  1. 安裝 Java 11:
sudo yum install -y java-11-openjdk
  1. 下載並配置 OpenJFX 11(或 17)如上。
  2. 使用 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(百度智能雲)

user avatar
0 位用戶收藏了這個故事!

發佈 評論

Some HTML is okay.