以下是详细的重新安装步骤指南

openclaw 中文openclaw 2026-04-09 1

彻底卸载旧版本（关键步骤）

卸载主程序：
- 进入 Windows “设置 > 应用 > 应用和功能”。
- 在列表中找到 “AI小龙虾” 或 “OpenClaw”，点击卸载。
- 如果使用安装包安装,通常会有其自带的卸载程序，也可以在开始菜单中找到。
清理残留文件和文件夹（非常重要）：
- C:\Users\[你的用户名]\AppData\Local\ 和 C:\Users\[你的用户名]\AppData\Roaming\ 目录下，查找并删除与 “OpenClaw”、“小龙虾” 或开发团队名称相关的文件夹。
- 检查软件原始的安装目录（如果你自定义过路径），删除整个文件夹。
- 提示：AppData 文件夹默认隐藏，需要在文件资源管理器的“查看”选项中勾选“隐藏的项目”才能看到。
清理 Python 虚拟环境（如果使用）：
- 如果你之前为它创建了独立的Python虚拟环境（例如在项目文件夹下的 venv 文件夹），直接删除该 venv 文件夹即可。

获取最新安装包：
- 强烈建议前往其官方发布的渠道获取最新版本，GitHub Releases 页面，这是最安全、最可靠的来源。
- 搜索 “OpenClaw AI 小龙虾 GitHub” 来找到官方仓库。
- 避免使用来路不明的第三方下载站,以防捆绑恶意软件。
确保系统环境就绪：
- 更新显卡驱动：前往 NVIDIA 或 AMD 官网下载安装最新的显卡驱动，这对 AI 应用性能至关重要。
- 安装 Python：如果软件不提供一体包，需要 Python 环境，建议安装 Python 3.10 或 3.11 版本（避开最新版，以确保库兼容性），安装时务必勾选 “Add Python to PATH”。
- 安装 CUDA 和 cuDNN：如果你是 NVIDIA 显卡且需要本地运行大模型，可能需要手动安装与你的显卡驱动匹配的 CUDA 工具包，但许多AI工具包会自带精简版CUDA，可以先尝试安装，如有问题再单独安装。

运行安装程序：
- 如果下载的是 .exe 安装包，右键以 “管理员身份” 运行，按照提示选择安装路径。
- 如果下载的是源码 .zip，将其解压到一个没有中文和特殊字符的路径下（D:\Projects\OpenClaw）。
安装依赖（针对源码版）：
- 打开解压后的文件夹,在地址栏输入 cmd 并回车，在此打开命令提示符。
- 项目会提供一个 requirements.txt 文件，使用以下命令安装依赖：
```
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```
  （使用国内镜像源 -i ... 可以极大加速下载）
处理常见安装问题：
- PyTorch 安装失败/版本不对：可能需要去 PyTorch 官网根据你的CUDA版本，获取专用的安装命令。
- 依赖冲突：这是最棘手的问题，可以尝试创建一个全新的 Python 虚拟环境来隔离。
```
# 在项目目录下
python -m venv openclaw_venv
# 激活虚拟环境
openclaw_venv\Scripts\activate
# 然后在激活的环境下再次安装依赖
pip install -r requirements.txt
```

启动软件：
- 如果是安装包版,从开始菜单或桌面快捷方式启动。
- 如果是源码版,在激活的虚拟环境中，运行主Python文件（通常是 main.py 或 webui.py），命令如：
```
python webui.py
```
配置模型路径：
- 首次运行,软件可能会提示你下载或配置AI模型（如语言模型、绘画模型等）。
- 按照软件内的指引,将模型文件放入正确的 models 文件夹，模型文件通常需要从 Hugging Face 或国内镜像站额外下载。
进行基础测试：

尝试一个简单的对话或绘图任务,确认核心功能正常。

查看官方文档：GitHub 仓库的 README.md 文件是最权威的安装和配置指南，务必仔细阅读。
寻求社区帮助：如果遇到特定错误，可以将完整的错误信息截图或复制下来，在项目的 GitHub Issues 或相关的 QQ群/微信群/Discord 中提问。
备选方案：如果重新安装过程过于复杂，可以考虑使用配置更傻瓜式的同类AI桌面应用，Ollama+Open WebUI、LM Studio、Fooocus（绘图）等。