【Bug已解决】openclaw: command not found / openclaw not installed — OpenClaw CLI 安装失败解决方案1. 问题描述安装 OpenClaw 后无法找到命令或运行失败# 命令未找到 $ openclaw zsh: command not found: openclaw # 或 pip 安装失败 $ pip install openclaw Error: Could not find a version that satisfies the requirement openclaw # 或安装后无法运行 $ openclaw --version Error: ModuleNotFoundError: No module named openclaw # 或路径问题 $ which openclaw # 无输出这个问题在以下场景中特别常见pip 安装路径不在 PATHPython 版本不兼容虚拟环境未激活权限不足包名拼写错误依赖缺失2. 原因分析原因分类表原因分类具体表现占比PATH 问题找不到命令约 35%Python 版本 3.8约 20%虚拟环境未激活约 15%包名错误openclaw vs open-claw约 15%依赖缺失import 失败约 10%权限不足EACCES约 5%3. 解决方案方案一修复 PATH最推荐# 步骤 1找到 pip 安装路径 pip show openclaw | grep Location # 或 python3 -c import openclaw; print(openclaw.__file__) # 步骤 2添加到 PATH export PATH$(python3 -m site --user-base)/bin:$PATH # 步骤 3永久设置 echo export PATH$(python3 -m site --user-base)/bin:$PATH ~/.bashrc source ~/.bashrc # 步骤 4验证 which openclaw openclaw --version方案二使用虚拟环境# 步骤 1创建虚拟环境 python3 -m venv ~/.openclaw-env # 步骤 2激活虚拟环境 source ~/.openclaw-env/bin/activate # 步骤 3安装 pip install openclaw # 步骤 4验证 which openclaw openclaw --version方案三检查 Python 版本# 步骤 1检查版本 python3 --version # 需要 3.8 # 步骤 2如果版本低更新 # 使用 pyenv curl https://pyenv.run | bash pyenv install 3.12 pyenv global 3.12 # 步骤 3或使用 HomebrewmacOS brew install python3.12 # 步骤 4重新安装 pip install openclaw openclaw --version方案四检查包名# 步骤 1搜索正确包名 pip search openclaw # 或 pip install openclaw # 如果失败尝试: pip install open-claw pip install OpenClaw # 步骤 2从 GitHub 安装 pip install githttps://github.com/anthropics/openclaw.git # 步骤 3或从源码安装 git clone https://github.com/anthropics/openclaw.git cd openclaw pip install -e . # 步骤 4验证 openclaw --version方案五安装依赖# 步骤 1检查缺失的依赖 python3 -c import openclaw 21 # 步骤 2安装依赖 pip install -r requirements.txt # 步骤 3或安装特定依赖 pip install anthropic httpx pydantic # 步骤 4验证 python3 -c import openclaw; print(OK) openclaw --version方案六使用 pipx# 步骤 1安装 pipx python3 -m pip install --user pipx python3 -m pipx ensurepath # 步骤 2使用 pipx 安装 pipx install openclaw # 步骤 3验证 which openclaw openclaw --version # 步骤 4如果需要全局 pipx ensurepath source ~/.bashrc4. 各方案对比总结方案适用场景推荐指数难度方案一PATH找不到⭐⭐⭐⭐⭐低方案二虚拟环境隔离⭐⭐⭐⭐⭐低方案三Python 版本版本低⭐⭐⭐⭐⭐低方案四包名名称⭐⭐⭐⭐低方案五依赖import 失败⭐⭐⭐⭐⭐低方案六pipx全局⭐⭐⭐⭐⭐低5. 常见问题 FAQ5.1 如何检查 OpenClaw 是否安装which openclaw openclaw --version5.2 pip 安装路径在哪pip show openclaw | grep Location5.3 如何修复 PATHexport PATH$(python3 -m site --user-base)/bin:$PATH5.4 Python 需要什么版本Python 3.8 或更高。5.5 如何使用虚拟环境python3 -m venv myenv source myenv/bin/activate pip install openclaw5.6 ModuleNotFoundError检查包名安装依赖使用虚拟环境。5.7 如何从 GitHub 安装pip install githttps://github.com/anthropics/openclaw.git5.8 pipx 是什么Python CLI 工具安装器自动创建隔离环境。5.9 权限不足怎么办使用pip install --user openclaw或虚拟环境。5.10 排查清单速查表□ 1. which openclaw 检查 □ 2. pip show openclaw | grep Location □ 3. export PATH 添加到 ~/.bashrc □ 4. python3 --version 检查 3.8 □ 5. python3 -m venv 虚拟环境 □ 6. source venv/bin/activate □ 7. pip install openclaw □ 8. pip install gitgithub 源码安装 □ 9. pipx install openclaw □ 10. pip install --user openclaw6. 总结根本原因安装失败最常见原因是 PATH 问题35%和 Python 版本不兼容20%最佳实践使用虚拟环境安装pip install openclawPATH 修复export PATH$(python3 -m site --user-base)/bin:$PATH虚拟环境python3 -m venvsource activatepip install最佳实践建议使用 pipx 全局安装 CLI 工具使用虚拟环境管理依赖故障排查流程图flowchart TD A[command not found] -- B[which openclaw 检查] B -- C{找到?} C --|否| D[pip show openclaw | grep Location] D -- E[export PATH 添加] E -- F[openclaw --version 验证] C --|是| F F -- G{成功?} G --|是| H[✅ 问题解决] G --|否| I[python3 --version] I -- j{Python 3.8?} j --|否| K[pyenv install 3.12] j --|是| L[检查包名] K -- M[pip install openclaw] L -- N{包名正确?} N --|否| O[pip install open-claw 或 GitHub] N --|是| P[检查依赖] O -- M P -- Q[python3 -c import openclaw] Q -- R{导入成功?} R --|否| S[pip install 依赖] R --|是| T[使用虚拟环境] S -- M T -- U[python3 -m venv activate] U -- M M -- V{成功?} V --|是| H V --|否| W[使用 pipx] W -- X[pipx install openclaw] X -- H H -- Y[长期: venv pip PATH] Y -- Z[✅ 长期方案]