# 主机板 OpenClaw 常见问题解决

> 宝塔主机板 OpenClaw 插件常见故障排查与解决方案，覆盖安装失败、版本更新异常、Node.js 与 Git 依赖缺失、网络拉取超时等典型场景，并附离线包替代安装方法。

原文：[主机板 OpenClaw 常见问题解决](https://docs.bt.cn/practical-tutorials/host-openclaw)

文档范围：宝塔面板及相关产品（当前文档）。生成时间：2026-09-22。

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

## 安装问题

![OpenClaw 插件安装失败示例](https://docs.bt.cn/img/practical-tutorials/host-openclaw/image-20260327094543936.png)

![OpenClaw 安装失败报错信息](https://docs.bt.cn/img/practical-tutorials/host-openclaw/image-20260327094605246.png)

### 通用排查方法

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

1. 登录服务器终端。

2. 执行安装脚本命令：

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

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

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

![Node.js 未安装报错提示](https://docs.bt.cn/img/practical-tutorials/host-openclaw/image-20260327095109304.png)

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

**解决步骤：**

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

   ![打开 Node 版本管理器](https://docs.bt.cn/img/practical-tutorials/host-openclaw/image-20260327095538101.png)

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

   ![安装指定版本 Node.js](https://docs.bt.cn/img/practical-tutorials/host-openclaw/image-20260327095648360.png)

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

   ![设置全局命令行版本](https://docs.bt.cn/img/practical-tutorials/host-openclaw/image-20260327095731350.png)

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

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

### 未安装 Git 导致安装失败

![Git 未安装报错提示](https://docs.bt.cn/img/practical-tutorials/host-openclaw/image-20260327100104328.png)

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

**解决步骤：**

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

   ```bash
   # Debian / Ubuntu 系统
   apt update && apt install -y git

   # CentOS / RHEL 系统
   yum install -y git
   ```

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

   ```bash
   git --version
   ```

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

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

## 更新问题

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

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

```bash
openclaw update
```