凫跃 發表於 2026-3-6 16:25:00

centos7安装部署openclaw

<div class="qk-md-paragraph"><span class="qk-md-text complete" data-spm-anchor-id="5176.28103460.0.i20.5f516308EJ0ulL">在 CentOS 7 上安装部署&nbsp;<span class="qk-md-strong complete">OpenClaw<span class="qk-md-text complete">（一个开源的《百战天虫》（Worms）风格游戏，基于 Java 编写）需要完成以下步骤。由于 OpenClaw 是用 Java 编写的，主要依赖 Java 运行环境和一些图形/音频库。</span></span></span></div>
<hr class="qk-md-hr">
<h2 class="qk-md-head"><span class="qk-md-text complete">一、系统准备</span></h2>
<div class="qk-md-paragraph"><span class="qk-md-text complete">确保你的 CentOS 7 系统是最新的：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code><span class="token">sudo yum update -y</span></code></pre>
</div>
</div>
<div class="qk-md-paragraph"><span class="qk-md-text complete">安装常用工具（如 wget、git、unzip 等）：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<div class="h- sticky top-0 z-10 bg-primary">
<div class="flex items-center h- px-3 text-12 align-middle border border-">
<div class="flex items-center gap-2">
<div class="flex cursor-pointer items-center" data-state="closed">&nbsp;<code><span class="token">sudo yum <span class="token">install -y <span class="token">wget <span class="token">git <span class="token">unzip</span></span></span></span></span></code></div>
</div>
</div>
</div>
</div>
</div>
<hr class="qk-md-hr">
<h2 class="qk-md-head"><span class="qk-md-text complete">二、安装 Java 运行环境（JRE）</span></h2>
<div class="qk-md-paragraph"><span class="qk-md-text complete">OpenClaw 需要 Java 8 或更高版本。CentOS 7 官方仓库中的 OpenJDK 通常为 Java 8。</span></div>
<h3 class="qk-md-head"><span class="qk-md-text complete">安装 OpenJDK 8：</span></h3>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<div class="h- sticky top-0 z-10 bg-primary">
<div class="flex items-center h- px-3 text-12 align-middle border border-">
<div class="flex items-center gap-2">
<div class="flex cursor-pointer items-center" data-state="closed">&nbsp;<code><span class="token">sudo yum <span class="token">install -y java-1.8.0-openjdk</span></span></code></div>
</div>
</div>
</div>
</div>
</div>
<div class="qk-md-paragraph"><span class="qk-md-text complete">验证安装：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<div class="h- sticky top-0 z-10 bg-primary">
<div class="flex items-center h- px-3 text-12 align-middle border border-">
<div class="flex items-center gap-2">
<div class="flex cursor-pointer items-center" data-state="closed">&nbsp;<code>java -version</code></div>
</div>
</div>
</div>
</div>
</div>
<div class="qk-md-paragraph"><span class="qk-md-text complete">你应该看到类似：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<div class="h- sticky top-0 z-10 bg-primary">
<div class="flex items-center h- px-3 text-12 align-middle border border-"><span class="font-medium mr-auto text-12 overflow-ellipsis whitespace-nowrap overflow-hidden text-"><span class="font-medium mr-auto text-12 overflow-ellipsis whitespace-nowrap overflow-hidden text-">text</span></span>
<div class="flex items-center gap-2">
<div class="flex cursor-pointer items-center" data-state="closed">&nbsp;<code>openjdk version "1.8.0_362"</code></div>
</div>
</div>
</div>
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><em id="__mceDel"><code>...</code></em></pre>
</div>
</div>
<blockquote class="qk-md-blockquote complete">
<div class="qk-md-paragraph"><span class="qk-md-text complete">注意：如果后续运行时提示缺少 JavaFX，你可能需要额外处理（见下文“JavaFX 问题”）。</span></div>
</blockquote>
<hr class="qk-md-hr">
<h2 class="qk-md-head"><span class="qk-md-text complete">三、下载 OpenClaw</span></h2>
<div class="qk-md-paragraph"><span class="qk-md-text complete">前往&nbsp;OpenClaw GitHub Releases<span class="qk-md-text complete">&nbsp;页面获取最新版本。</span></span></div>
<div class="qk-md-paragraph"><span class="qk-md-text complete">以 v0.9.5 为例（请根据实际最新版调整）：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code><span class="token builtin">cd /opt
<span class="token">sudo <span class="token">mkdir -p openclaw
<span class="token builtin">cd openclaw
<span class="token">sudo <span class="token">wget https://github.com/OpenClaw/OpenClaw/releases/download/v0.9.5/openclaw-0.9.5.zip
<span class="token">sudo <span class="token">unzip openclaw-0.9.5.zip</span></span></span></span></span></span></span></span></code></pre>
</div>
</div>
<div class="qk-md-paragraph"><span class="qk-md-text complete">或者使用 git 克隆源码（不推荐用于普通用户，除非你要编译）：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code><span class="token">git clone https://github.com/OpenClaw/OpenClaw.git</span></code></pre>
</div>
</div>
<blockquote class="qk-md-blockquote complete">
<div class="qk-md-paragraph"><span class="qk-md-text complete">建议直接使用预编译的 release 包。</span></div>
</blockquote>
<hr class="qk-md-hr">
<h2 class="qk-md-head"><span class="qk-md-text complete">四、安装缺失的依赖（特别是 JavaFX）</span></h2>
<div class="qk-md-paragraph"><span class="qk-md-text complete">OpenClaw 依赖&nbsp;<span class="qk-md-strong complete">JavaFX<span class="qk-md-text complete">，而 OpenJDK 默认不包含 JavaFX。在 CentOS 7 上，你需要手动提供 JavaFX。</span></span></span></div>
<h3 class="qk-md-head"><span class="qk-md-text complete">方法 1：使用 OpenJFX（推荐）</span></h3>
<div class="qk-md-paragraph"><span class="qk-md-text complete">从&nbsp;Gluon OpenJFX<span class="qk-md-text complete">&nbsp;下载适用于 Linux 的 JavaFX SDK。</span></span></div>
<div class="qk-md-paragraph"><span class="qk-md-text complete">例如（以 JavaFX 17 为例，需与你的 Java 版本兼容）：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code><span class="token builtin">cd /opt
<span class="token">sudo <span class="token">wget https://download2.gluonhq.com/openjfx/17.0.2/openjfx-17.0.2_linux-x64_bin-sdk.zip
<span class="token">sudo <span class="token">unzip openjfx-17.0.2_linux-x64_bin-sdk.zip</span></span></span></span></span></code></pre>
</div>
</div>
<div class="qk-md-paragraph"><span class="qk-md-text complete">这会生成&nbsp;<code class="qk-md-code">/opt/javafx-sdk-17.0.2</code><span class="qk-md-text complete">&nbsp;目录。</span></span></div>
<h3 class="qk-md-head"><span class="qk-md-text complete">修改启动脚本</span></h3>
<div class="qk-md-paragraph"><span class="qk-md-text complete">OpenClaw 的启动脚本（通常是&nbsp;<code class="qk-md-code">run.sh</code><span class="qk-md-text complete">）需要添加 JavaFX 模块路径。</span></span></div>
<div class="qk-md-paragraph"><span class="qk-md-text complete">编辑&nbsp;<code class="qk-md-code">/opt/openclaw/run.sh</code><span class="qk-md-text complete">（如果没有，可自己创建）：</span></span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code><span class="token shebang">#!/bin/bash
<span class="token builtin">cd <span class="token">"<span class="token">$(<span class="token">dirname<span class="token"> <span class="token">"<span class="token">$0<span class="token">"<span class="token">)<span class="token">"

<span class="token assign-left">JAVA_HOME<span class="token">=/usr/lib/jvm/java-1.8.0-openjdk
<span class="token assign-left">JAVAFX_PATH<span class="token">=/opt/javafx-sdk-17.0.2/lib

<span class="token">$JAVA_HOME/bin/java <span class="token">\
--module-path <span class="token">"<span class="token">$JAVAFX_PATH<span class="token">" <span class="token">\
--add-modules javafx.controls,javafx.media,javafx.fxml,javafx.swing <span class="token">\
-jar openclaw.jar</span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></code></pre>
</div>
</div>
<blockquote class="qk-md-blockquote complete">
<div class="qk-md-paragraph"><span class="qk-md-text complete">⚠️ 注意：Java 8 不支持&nbsp;<code class="qk-md-code">--module-path</code><span class="qk-md-text complete">&nbsp;参数！<br><span class="qk-md-text complete">如果你使用的是&nbsp;<span class="qk-md-strong complete">Java 8<span class="qk-md-text complete">，则必须使用&nbsp;<span class="qk-md-strong complete">包含 JavaFX 的 JDK<span class="qk-md-text complete">（如 Oracle JDK 8），或使用旧版 OpenClaw（早期版本可能不强制 JavaFX 11+）。</span></span></span></span></span></span></span></div>



</blockquote>
<hr class="qk-md-hr">
<h2 class="qk-md-head"><span class="qk-md-text complete">五、解决方案建议（针对 Java 8 用户）</span></h2>
<div class="qk-md-paragraph"><span class="qk-md-text complete">由于 CentOS 7 默认只有 OpenJDK 8（无 JavaFX），而 OpenClaw 新版本要求 JavaFX 11+，你有两个选择：</span></div>
<h3 class="qk-md-head"><span class="qk-md-text complete">✅ 推荐方案：升级到 Java 11 + OpenJFX</span></h3>
<ol class="qk-md-ol" start="1">
<li class="qk-md-li complete"><span class="qk-md-text complete">安装 Java 11：</span></li>

</ol>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code><span class="token">sudo yum <span class="token">install -y java-11-openjdk</span></span></code></pre>
</div>
</div>
<ol class="qk-md-ol" start="2">
<li class="qk-md-li complete">
<div class="qk-md-paragraph"><span class="qk-md-text complete">下载并配置 OpenJFX 11（或 17）如上。</span></div>
</li>
<li class="qk-md-li complete">
<div class="qk-md-paragraph"><span class="qk-md-text complete">使用 Java 11 运行，并指定模块路径。</span></div>
</li>
</ol>
<h3 class="qk-md-head"><span class="qk-md-text complete">替代方案：使用旧版 OpenClaw（兼容 Java 8）</span></h3>
<div class="qk-md-paragraph"><span class="qk-md-text complete">查找早期版本（如 v0.8.x），这些版本可能基于 Swing 而非 JavaFX。但功能较少。</span></div>
<hr class="qk-md-hr">
<h2 class="qk-md-head"><span class="qk-md-text complete">六、运行 OpenClaw</span></h2>
<div class="qk-md-paragraph"><span class="qk-md-text complete">赋予脚本执行权限：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code><span class="token">chmod +x /opt/openclaw/run.sh</span></code></pre>
</div>
</div>
<div class="qk-md-paragraph"><span class="qk-md-text complete">运行：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code>/opt/openclaw/run.sh</code></pre>
</div>
</div>
<blockquote class="qk-md-blockquote complete">
<div class="qk-md-paragraph"><span class="qk-md-text complete">如果你在图形界面（GNOME/KDE）下运行，应该能正常启动。<br><span class="qk-md-text complete">如果通过 SSH 无图形界面，请确保已启用 X11 转发（<code class="qk-md-code">ssh -X</code><span class="qk-md-text complete">）或在本地桌面环境中运行。</span></span></span></div>



</blockquote>
<hr class="qk-md-hr">
<h2 class="qk-md-head"><span class="qk-md-text complete">七、常见问题</span></h2>
<h3 class="qk-md-head"><span class="qk-md-text complete">1. “Error: JavaFX runtime components are missing”</span></h3>
<div class="qk-md-paragraph"><span class="qk-md-text complete">说明未正确加载 JavaFX。请确认：</span></div>
<ul class="qk-md-ul">
<li class="qk-md-li complete"><span class="qk-md-text complete">使用了 Java 11+</span></li>
<li class="qk-md-li complete"><span class="qk-md-text complete">正确设置了&nbsp;<code class="qk-md-code">--module-path</code></span></li>
<li class="qk-md-li complete"><span class="qk-md-text complete">JavaFX 版本与 Java 主版本兼容</span></li>



</ul>
<h3 class="qk-md-head"><span class="qk-md-text complete">2. 黑屏或卡死</span></h3>
<div class="qk-md-paragraph"><span class="qk-md-text complete">可能是显卡驱动问题。确保安装了 Mesa 或 NVIDIA 驱动：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code><span class="token">sudo yum <span class="token">install -y mesa-libGL</span></span></code></pre>
</div>
</div>
<h3 class="qk-md-head"><span class="qk-md-text complete">3. 声音问题</span></h3>
<div class="qk-md-paragraph"><span class="qk-md-text complete">安装 ALSA/PulseAudio 支持：</span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code><span class="token">sudo yum <span class="token">install -y alsa-lib pulseaudio-libs</span></span></code></pre>
</div>
</div>
<hr class="qk-md-hr">
<h2 class="qk-md-head"><span class="qk-md-text complete">八、创建桌面快捷方式（可选）</span></h2>
<div class="qk-md-paragraph"><span class="qk-md-text complete">在&nbsp;<code class="qk-md-code">~/.local/share/applications/openclaw.desktop</code><span class="qk-md-text complete">&nbsp;创建：</span></span></div>
<div class="contain-layout-style relative mb-4 flex min-h- flex-col rounded-12 bg-capsule qw-md-code">
<div class="rounded- bg-[#fff]">
<div class="h- sticky top-0 z-10 bg-primary">
<div class="flex items-center h- px-3 text-12 align-middle border border-"><span class="font-medium mr-auto text-12 overflow-ellipsis whitespace-nowrap overflow-hidden text-"><span class="font-medium mr-auto text-12 overflow-ellipsis whitespace-nowrap overflow-hidden text-">ini</span></span>
<div class="flex items-center gap-2">
<div data-state="closed">&nbsp;</div>
</div>
</div>
</div>
<pre class="sc-etsjJW cjtjZA codeHighlighterScrollbar-V1Z1Px"><code><span class="token section">[<span class="token section section-name">Desktop Entry<span class="token section">]
<span class="token key">Name<span class="token">=<span class="token value">OpenClaw
<span class="token key">Exec<span class="token">=<span class="token value">/opt/openclaw/run.sh
<span class="token key">Icon<span class="token">=<span class="token value">/opt/openclaw/icon.png
<span class="token key">Type<span class="token">=<span class="token value">Application
<span class="token key">Categories<span class="token">=<span class="token value">Game;</span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></code></pre>
</div>
</div>
<hr class="qk-md-hr">
<h2 class="qk-md-head"><span class="qk-md-text complete">总结</span></h2>
<div class="qk-md-table-section">
<div class="qk-md-table-wrapper">
<div class="qk-md-table-action"><span class="qk-md-table-action-title"><span class="qk-md-table-action-title">表格</span></span>
<div class="qk-md-table-action-bar">&nbsp;</div>
</div>
<div class="qk-md-table-container">
<table class="qk-md-table">
<thead class="qk-md-table-head">
<tr><th><span class="qk-md-text complete">步骤</span></th><th><span class="qk-md-text complete">操作</span></th></tr>
</thead>
<tbody class="qk-md-table-body">
<tr class="qk-md-table-row">
<td><span class="qk-md-text complete">1</span></td>
<td><span class="qk-md-text complete">更新系统，安装基础工具</span></td>
</tr>
<tr class="qk-md-table-row">
<td><span class="qk-md-text complete">2</span></td>
<td><span class="qk-md-text complete">安装 Java 11（推荐）或 Java 8</span></td>
</tr>
<tr class="qk-md-table-row">
<td><span class="qk-md-text complete">3</span></td>
<td><span class="qk-md-text complete">下载 OpenClaw release 包</span></td>
</tr>
<tr class="qk-md-table-row">
<td><span class="qk-md-text complete">4</span></td>
<td><span class="qk-md-text complete">安装 OpenJFX 并配置模块路径</span></td>
</tr>
<tr class="qk-md-table-row">
<td><span class="qk-md-text complete">5</span></td>
<td><span class="qk-md-text complete">编写启动脚本并运行</span></td>
</tr>
</tbody>
</table>
<p data-layout-id="61" data-pm-slice="2 2 []"><span><span>最后再给大家附上几个云厂商官方部署方法：<span><span>https://developer.aliyun.com/article/1709759（阿里云）</span></span></span></span></p>
<p><span>https://cloud.tencent.com/developer/article/2624973（腾讯云）</span></p>
<p><span>https://cloud.baidu.com/doc/LS/s/6ml9f3cvl（百度智能云）</span></p>
</div>
</div>
</div><br><br>
来源：https://www.cnblogs.com/Johny-zhao/p/19678898
頁: [1]
查看完整版本: centos7安装部署openclaw