ARTICLE · 1087471
Openclaw小龙虾Windows版安装指南,跟着做就行
Openclaw小龙虾Windows版安装指南,跟着做就行前两天后台收到一条留言：“小龙虾（Openclaw）在 Windows 上到底能不能跑？我折腾了两个小时，满屏都是红字。”说实话，我特别理解这种感受。我自己第一次装的时候，也是在一堆报错里摸爬滚打出来的。所以今天不讲原理，不聊架构，就老老实实把一份能跑通的 Windows 安装流程写下来，你跟着一步一步做就行。
一、先把准备工作做完，能省一半的力气
很多人装失败，不是软件的问题，是环境没铺好。Windows 和 Linux 最大的区别在于，它对“环境变量”这件事特别敏感，你少勾一个选项，后面就得多花二十分钟找原因。
开工之前，请确认你手上有这几样东西：
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
Windows 10 64 位以上，或者 Windows 11，系统尽量更新到最近的版本
Python 3.10 及以上版本，建议直接用 3.11 或 3.12
一个顺手的代码编辑器，用系统自带的记事本也行，但别为难自己
至少 4GB 的剩余磁盘空间，装在固态盘上体验会好很多
装完之后，别急着往下走。按下 Win + R，输入 cmd 回车，依次敲这几条命令看看有没有版本号返回：python --version、git --version。都能正常显示版本，说明环境通了。
这里必须强调一句：安装 Python 的时候，安装界面最下面那个“Add Python to PATH”一定要勾上。我敢说，新手遇到的报错里，有三分之一是因为没勾这个。
二、正式开始安装，其实就四步
准备工作到位之后，剩下的事情比你想的简单。
第一步，把源码拿到本地。如果你会用 git，直接在想要存放的目录里打开命令行，把仓库克隆下来；不熟悉 git 也没关系，去项目主页下载压缩包，解压到一个纯英文路径下即可。注意，是纯英文路径，别放在“桌面\新建文件夹\小龙虾”这种位置。
第二步，建立独立的运行环境。这是最容易被跳过、但最值得做的一步。在项目根目录打开命令行，执行 python -m venv .venv 创建一个虚拟环境，然后运行 .venv\Scripts\activate 激活它。激活成功后，命令行前面会出现一个 (.venv) 的前缀，看到它，就说明你已经和系统里其他 Python 项目隔离开了，后面怎么折腾都不会互相打架。
第三步，安装依赖。在激活状态下执行 pip install -r requirements.txt。这一步最耗时，也最容易卡住。如果下载速度慢得让人绝望，可以换成国内的镜像源来装，速度会正常很多。 
第四步，配置并启动。把配置文件的示例复制一份，改成正式的名字，按里面的注释填上你自己的路径和参数，然后执行启动命令。第一次启动通常会慢一点，因为它要初始化一些数据，耐心等上半分钟。看到终端里滚动出一行行日志，最后停在一个监听地址上，恭喜你，成了。
三、几个我踩过的坑，替你先踩了
就算流程写得再细，实际操作时还是会遇到岔路。下面这几个问题，出镜率最高。
提示“不是内部或外部命令”：多半是环境变量没生效，关掉命令行重新开一个窗口试试
PowerShell 里脚本无法执行：这是执行策略的问题，改一下策略或者直接用 cmd 就好
安装依赖时报编译错误：通常是缺少构建工具，装一个对应版本的构建组件再重试
启动后提示端口被占用：换个端口，或者把占用那个端口的程序关掉
我的个人习惯是：遇到报错先别慌，把终端往上翻，看最后五行。真正的错误原因百分之九十都写在那里，前面一大串往往只是它的“连带反应”。
最后说句掏心窝的话。这类工具更新很快，网上能搜到的教程未必和你手上的版本对得上，所以别迷信“一键脚本”，也别一上来就追求最新版。先用稳定版把流程跑通，能正常启动、能完成一次基本操作，再去折腾新特性。装软件这件事，本质上和组装家具差不多，说明书只是参考，真正让你学会的，是拧螺丝的那双手。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn
一、先把准备工作做完，能省一半的力气
很多人装失败，不是软件的问题，是环境没铺好。Windows 和 Linux 最大的区别在于，它对“环境变量”这件事特别敏感，你少勾一个选项，后面就得多花二十分钟找原因。
开工之前，请确认你手上有这几样东西：
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
Windows 10 64 位以上，或者 Windows 11，系统尽量更新到最近的版本
Python 3.10 及以上版本，建议直接用 3.11 或 3.12
一个顺手的代码编辑器，用系统自带的记事本也行，但别为难自己
至少 4GB 的剩余磁盘空间，装在固态盘上体验会好很多
装完之后，别急着往下走。按下 Win + R，输入 cmd 回车，依次敲这几条命令看看有没有版本号返回：python --version、git --version。都能正常显示版本，说明环境通了。
这里必须强调一句：安装 Python 的时候，安装界面最下面那个“Add Python to PATH”一定要勾上。我敢说，新手遇到的报错里，有三分之一是因为没勾这个。
二、正式开始安装，其实就四步
准备工作到位之后，剩下的事情比你想的简单。
第一步，把源码拿到本地。如果你会用 git，直接在想要存放的目录里打开命令行，把仓库克隆下来；不熟悉 git 也没关系，去项目主页下载压缩包，解压到一个纯英文路径下即可。注意，是纯英文路径，别放在“桌面\新建文件夹\小龙虾”这种位置。
第二步，建立独立的运行环境。这是最容易被跳过、但最值得做的一步。在项目根目录打开命令行，执行 python -m venv .venv 创建一个虚拟环境，然后运行 .venv\Scripts\activate 激活它。激活成功后，命令行前面会出现一个 (.venv) 的前缀，看到它，就说明你已经和系统里其他 Python 项目隔离开了，后面怎么折腾都不会互相打架。
第三步，安装依赖。在激活状态下执行 pip install -r requirements.txt。这一步最耗时，也最容易卡住。如果下载速度慢得让人绝望，可以换成国内的镜像源来装，速度会正常很多。
第四步，配置并启动。把配置文件的示例复制一份，改成正式的名字，按里面的注释填上你自己的路径和参数，然后执行启动命令。第一次启动通常会慢一点，因为它要初始化一些数据，耐心等上半分钟。看到终端里滚动出一行行日志，最后停在一个监听地址上，恭喜你，成了。
三、几个我踩过的坑，替你先踩了
就算流程写得再细，实际操作时还是会遇到岔路。下面这几个问题，出镜率最高。
提示“不是内部或外部命令”：多半是环境变量没生效，关掉命令行重新开一个窗口试试
PowerShell 里脚本无法执行：这是执行策略的问题，改一下策略或者直接用 cmd 就好
安装依赖时报编译错误：通常是缺少构建工具，装一个对应版本的构建组件再重试
启动后提示端口被占用：换个端口，或者把占用那个端口的程序关掉
我的个人习惯是：遇到报错先别慌，把终端往上翻，看最后五行。真正的错误原因百分之九十都写在那里，前面一大串往往只是它的“连带反应”。
最后说句掏心窝的话。这类工具更新很快，网上能搜到的教程未必和你手上的版本对得上，所以别迷信“一键脚本”，也别一上来就追求最新版。先用稳定版把流程跑通，能正常启动、能完成一次基本操作，再去折腾新特性。装软件这件事，本质上和组装家具差不多，说明书只是参考，真正让你学会的，是拧螺丝的那双手。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn