主机板 OpenClaw 常见问题解决

本文汇总宝塔主机板 OpenClaw 插件安装失败、更新异常的核心问题，提供排查步骤和解决方案，帮助快速定位并解决插件使用故障。

安装问题

通用排查方法

插件安装失败时，优先通过终端手动执行安装脚本，查看具体报错信息定位问题根源：

1. 登录服务器终端。

2. 执行安装脚本命令：

   bash /www/server/panel/plugin/openclaw/install.sh install

3. 查看命令执行后的报错提示，对照下方方案解决。

未安装 Node.js 导致安装失败

报错特征：执行脚本后提示 Node.js is not installed（无 Node.js 环境）。

解决步骤：

1. 进入宝塔面板，点击左侧菜单栏【网站】→【Node 项目】→【Node 版本管理器】。

   

2. 安装 v22.x.x 及以上版本的 Node.js。

   

3. 安装完成后，将该版本设置为全局命令行版本。

   

4. 重新执行手动安装命令：

   bash /www/server/panel/plugin/openclaw/install.sh install

未安装 Git 导致安装失败

报错特征：执行脚本后提示 Git is not installed（无 Git 环境）。

解决步骤：

1. 根据服务器操作系统，执行对应命令安装 Git：

   # Debian / Ubuntu 系统
   apt update && apt install -y git
   
   # CentOS / RHEL 系统
   yum install -y git

2. 验证 Git 安装成功（输出版本号即为正常）：

   git --version

3. 重新执行 OpenClaw 安装命令：

   bash /www/server/panel/plugin/openclaw/install.sh install

更新问题

面板内插件更新按钮点击无响应

直接在服务器终端执行升级命令强制更新插件：

openclaw update