宝塔免费安装OpenClaw 插件后常见问题解决
OpenClaw是一个自托管的人工智能助手，建议系统：debian12/13，ubuntu22/24，仅支持2核4G以上配置安装
建议在全新服务器使用，如有重要数据请做好备份
本文汇总宝塔 OpenClaw 插件安装失败、更新异常的核心问题，提供排查步骤和解决方案，帮助快速定位并解决插件使用故障。
宝塔服务器面板，一键全能部署及管理 https://www.bt.cn/u/cleNCv
安装问题
通用排查方法
插件安装失败时，优先通过终端手动执行安装脚本，查看具体报错信息定位问题根源：
登录服务器终端。
执行安装脚本命令：
bash /www/server/panel/plugin/openclaw/install.sh install查看命令执行后的报错提示，对照下方方案解决。
未安装 Node.js 导致安装失败
报错特征：执行脚本后提示 Node.js is not installed（无 Node.js 环境）。
解决步骤：
进入宝塔面板，点击左侧菜单栏【网站】→【Node 项目】→【Node 版本管理器】。
安装 v22.x.x 及以上版本的 Node.js。
安装完成后，将该版本设置为全局命令行版本。
重新执行手动安装命令：
bash /www/server/panel/plugin/openclaw/install.sh install
未安装 Git 导致安装失败
报错特征：执行脚本后提示 Git is not installed（无 Git 环境）。
解决步骤：
根据服务器操作系统，执行对应命令安装 Git：
# Debian / Ubuntu 系统
apt update && apt install -y git
# CentOS / RHEL 系统
yum install -y git验证 Git 安装成功（输出版本号即为正常）：
git --version重新执行 OpenClaw 安装命令：
bash /www/server/panel/plugin/openclaw/install.sh install
更新问题
面板内插件更新按钮点击无响应
直接在服务器终端执行升级命令强制更新插件：
openclaw update
