🦞 OpenClaw 终极排坑：clawhub: command not found 全网最稳解决方案

（Windows / Mac / Linux 全平台通用・保姆级）

🔥 前言

最近 OpenClaw（小龙虾）真的火炸了！
但 80% 的人刚装上就卡死在第一步：

clawhub: command not found

明明装了 OpenClaw，技能装不上、命令用不了、AI 只会发呆。
网上教程要么旧、要么不全、要么只讲一半。
今天程序猫A建仔给大家带来这篇全网最完整排坑指南，从原理到修复，从诊断到验证，一次全部搞定！

📌 目录

一、问题现象：clawhub 不存在，OpenClaw 直接半残
二、clawhub 到底是什么？为什么必须要有？
三、6 大根本原因 + 4 行命令快速诊断
四、全平台修复方案（按优先级，99% 一次修好）
五、各平台专属避坑（mac / Windows / Linux）
六、修复后完整验证流程（确保彻底解决）
七、故障速查表（收藏备用）
八、总结 + 最佳实践
九、粉丝福利：部署脚本 + 技能清单

一、问题现象：clawhub 命令找不到

你想给小龙虾装技能：

clawhub install github

结果终端直接报错：

zsh: command not found: clawhub
bash: clawhub: command not found
'clawhub' 不是内部或外部命令

直接导致：
❌ 无法安装、卸载、管理技能
❌ 无法访问 ClawHub 技能市场
❌ OpenClaw 只会思考，不会干活
❌ 技能装了也加载不出来

二、clawhub 到底是什么？

一句话讲清楚：
clawhub = OpenClaw 的技能应用商店（CLI 工具）
它负责：
下载技能
更新技能
卸载技能
连接官方技能库
没有 clawhub，OpenClaw 就没有四肢，只剩大脑。

三、6 大根本原因 + 快速诊断

先诊断，再修复，不盲目操作！

# 1. 检查是否安装 clawhub
npm list -g clawhub

# 2. 查看 npm 全局路径
npm config get prefix

# 3. 查看系统 PATH
echo $PATH      # Mac/Linux
$env:PATH       # Windows

# 4. 检查 OpenClaw 本体
openclaw --version

错误原因统计

四、全平台解决方案（按优先级）
🥇 方案 1：安装 / 重装 clawhub（80% 一次解决）

# 官方安装
npm install -g clawhub

# 国内镜像（推荐，不超时）
npm install -g clawhub --registry=https://registry.npmmirror.com

# 验证
clawhub --version

🥈 方案 2：修复 PATH 环境变量（最核心）
Mac / Linux

npm config get prefix

echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

which clawhub

Windows（PowerShell 管理员）

npm config get prefix

[Environment]::SetEnvironmentVariable(
    "Path", 
    [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Users\你的用户名\AppData\Roaming\npm",
    "User"
)

必须重启终端！

🥉 方案 3：备用方案（不用 clawhub 也能装技能）

openclaw skills list
openclaw skills install github
openclaw skills uninstall github
openclaw skills reload

🔧 方案 4：高级修复：创建软链接（Mac/Linux）

sudo ln -s $(npm config get prefix)/bin/clawhub /usr/local/bin/clawhub
clawhub --version

🔧 方案 5：修复权限（EACCES 专用）

sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

🔧 方案 6：Docker 部署专属

docker exec -it openclaw_container bash
npm install -g clawhub

五、各平台专属避坑

🍎 1、macOS

• Homebrew 安装 Node 需要手动加 PATH
• M 系列芯片建议：

arch -arm64 npm install -g clawhub

🪟 2、Windows

• 执行策略被阻止：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

🐧 3、Linux / 服务器

npm config set registry https://registry.npmmirror.com
clawhub config set registry https://clawhub-mirror.aliyuncs.com

六、修复后完整验证流程（必做）

which clawhub
clawhub --version
clawhub search github
clawhub install github
openclaw gateway restart

全部跑通 = 完美修复 ✅

七、故障速查表（收藏备用）

八、总结

clawhub: command not found 只有三个根源：
1、没装上
2、PATH 没配
3、终端没刷新

按本文步骤，全平台 100% 可修复。

九、🎁 粉丝福利（评论区领取）

关注 + 点赞 + 收藏 本文，评论区扣 “小龙虾” 可领取：
1、OpenClaw 一键部署脚本
2、官方推荐技能清单（三批次）
3、ClawHub 安全安装规范
4、全平台环境自动配置脚本

🔔 作者介绍
专注 AI Agent / OpenClaw / 大模型工程化，持续输出部署、排坑、实战干货。
欢迎 关注、点赞、收藏，下期更新《OpenClaw应用场景与自动化工作流》。