openclaw安装skills报错的6大解决方案(适用macOS/Windows/Linux)

# 🔍 诊断 1：检查 npm 全局安装路径
npm config get prefix
# 🔍 诊断 2：检查 clawhub 是否真的安装了
npm list -g clawhub
# 🔍 诊断 3：查看当前 PATH 环境变量
echo $PATH  # Mac/Linux
$env:PATH   # Windows PowerShell
# 🔍 诊断 4：检查 openclaw 本身是否正常
openclaw --version

# 标准安装（官方推荐）
npm install -g clawhub

# 国内用户加速（阿里云镜像）
npm install -g clawhub --registry=https://registry.npmmirror.com

# 或淘宝镜像
npm install -g clawhub --registry=https://registry.npmmirror.com

clawhub --version
# 应输出类似：clawhub/2.1.0 darwin-arm64 node-v20.11.0

# 步骤 1：获取 npm 全局 bin 路径
npm config get prefix
# 输出示例：/usr/local 或 /Users/username/.nvm/versions/node/v20.11.0

# 步骤 2：添加到 shell 配置文件（根据你的 shell 选择）
# 如果是 zsh（macOS 默认）
echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.zshrc

# 如果是 bash
echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.bashrc

# 步骤 3：立即生效
source ~/.zshrc  # 或 source ~/.bashrc

# 步骤 4：验证
which clawhub
# 应输出：/usr/local/bin/clawhub 或类似路径

# nvm 用户需要确保加载 nvm 脚本
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
source ~/.zshrc

# 步骤 1：获取 npm 全局路径
npm config get prefix
# 输出示例：C:\Users\Username\AppData\Roaming\npm

# 步骤 2：添加到系统 PATH（PowerShell 管理员模式）
[Environment]::SetEnvironmentVariable(
    "Path", 
    [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Users\Username\AppData\Roaming\npm",
    "User"
)

# 步骤 3：重启终端（必须！）
# 关闭所有 PowerShell/CMD 窗口，重新打开

# 步骤 4：验证
Get-Command clawhub

# 查看已安装技能（替代 clawhub list）
openclaw skills list

# 安装技能（替代 clawhub install <skill>）
openclaw skills install github

# 卸载技能（替代 clawhub uninstall <skill>）
openclaw skills uninstall github

# 重载技能（无需重启 Gateway）
openclaw skills reload

# macOS/Linux：创建软链接到标准路径
sudo ln -s $(npm config get prefix)/bin/clawhub /usr/local/bin/clawhub

# 验证
ls -la /usr/local/bin/clawhub
clawhub --version

# 修复 npm 全局目录权限（macOS/Linux）
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

# 或使用 npm 官方修复工具
sudo npm install -g clawhub --unsafe-perm=true --allow-root

# 进入容器内部安装
docker exec -it openclaw_container bash
npm install -g clawhub
exit

# 或在 Dockerfile 中添加
RUN npm install -g clawhub

# 重新构建镜像
docker build -t openclaw-custom .

# 如果通过 brew install node 安装，路径可能在 /opt/homebrew/bin
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zprofile
source ~/.zprofile

# 确保安装的是 arm64 版本，而非 Rosetta 转译版
arch -arm64 npm install -g clawhub

# 如果安装脚本被阻止，先修改执行策略（管理员模式）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# WSL 中需要确保 Windows 的 npm 路径不干扰
which npm  # 确认使用的是 /usr/bin/npm 而非 Windows 的 npm

# 使用国内镜像加速（阿里云 ECS 推荐）
npm config set registry https://registry.npmmirror.com
npm install -g clawhub

# 或配置 clawhub 专属镜像
clawhub config set registry https://clawhub-mirror.aliyuncs.com

# 1. 命令识别测试
which clawhub          # Mac/Linux
where.exe clawhub      # Windows

# 2. 版本检查
clawhub --version

# 3. 功能测试：搜索技能
clawhub search github

# 4. 安装测试（安装官方 github skill）
clawhub install github

# 5. 验证安装结果
clawhub list | grep github
ls ~/.openclaw/workspace/skills/github/

# 6. 重启 Gateway 加载技能
openclaw gateway restart

# 7. 查看日志确认加载成功
openclaw gateway logs | grep -i "skill.*loaded"

# 官方一键安装（含环境变量配置）
curl -fsSL https://openclaw.ai/install.sh | bash

# 国内加速版
curl -fsSL https://openclaw-mirror.aliyuncs.com/install.sh | bash

# 使用 nvm 管理 Node 版本（推荐）
nvm install 20
nvm use 20
nvm alias default 20

# 此时 npm 全局安装在用户目录，无需 sudo
npm install -g clawhub

# 配置 npm 国内镜像
npm config set registry https://registry.npmmirror.com

# 配置 clawhub 国内镜像
clawhub config set registry https://clawhub-mirror.aliyuncs.com

# 终极重置方案
npm uninstall -g clawhub openclaw
npm cache clean --force
npm install -g openclaw clawhub
# 重新配置环境变量并重启终端