ARTICLE · 1089494
Openclaw小龙虾Win10安装教程:环境配置+常见报错解决
Openclaw小龙虾Win10安装教程:环境配置+常见报错解决前几天有个朋友问我，说想在自家那台用了五六年的 Win10 老电脑上，把这套开源小工具跑起来，结果卡在安装环节，一会儿报错一会儿没反应，折腾到半夜也没弄好。其实我自己第一次装的时候也踩了不少坑，前后花了大半天才理顺。今天就把整个流程整理一遍，顺便把几个高频报错一并说清楚，照着做基本能一次过。 一、先把环境配好，能省掉一半的麻烦 很多新手一上来就直奔安装命令，结果各种红字报错糊一脸。我的经验是，先把底层环境搭稳，后面会顺很多。这东西本质上是跑在 Node 环境里的，所以准备工作主要是两件事：装好运行环境，备好下载工具。 运行环境：去官网下载 LTS 长期支持版，建议选 20.x 或 22.x 这一类。别贪新鲜装最新的大版本，有些依赖还没跟上，容易出现兼容问题。 版本管理工具：如果你电脑上本来就有别的项目，建议装一个版本切换工具，以后要换版本一条命令就行，不用卸载重装。 下载工具：很多依赖要从远端仓库拉取，提前装好会省事不少，避免中途卡住。 终端：系统自带的 PowerShell 完全够用，但如果你习惯多标签操作，可以换一个更顺手的终端工具。 第一步：打开龙虾安装地址：https://top.wokk.cn 第二步：选择Windows10/11或macOS apple、intel芯片下载。 第三步：双击安装包（exe或者dmg文件）等待3分钟。 第四步：打开桌面TopClaw龙虾软件注册登录即可使用 小提醒：安装运行环境的时候，安装界面里那个「添加到系统路径」的选项一定要勾上。很多人装完之后在命令行里敲 node -v，提示「不是内部或外部命令」，九成就是这里没勾。 装完之后别急着往下走，先验证一下。在终端里分别输入版本查询命令，能正常输出版本号，说明这一关过了。如果提示找不到命令，先关掉终端重新开一个，再不行就检查环境变量里有没有对应的路径。 二、安装主体，跟着命令走就行 环境没问题之后，安装本身其实挺快的。打开终端，先切换到你想存放项目的目录，然后执行安装命令。 
全局安装：适合只想拿来直接用的朋友，装完在任何目录都能调起来。 本地安装：适合打算改代码或者长期跟着更新的人，依赖都锁在项目目录里，互不干扰。 安装完成后，用版本查询命令确认一下，能出来版本号就说明成功了一半。 接下来是配置环节，这一步最容易被忽略。程序需要一个配置文件，里面主要填三样东西：工作目录、监听端口、以及你要接入的模型服务信息。工作目录建议单独建一个空文件夹，别放在桌面或者系统盘根目录，路径里有中文和空格有时候会出幺蛾子。 配置里的模型服务那一栏，填你自己准备好的接口地址和密钥就行。这部分各家方案不一样，按照你手头服务商给的文档对应填写，注意别把密钥直接贴到公开的地方去。 三、几个常见报错，对症下药 下面这几个是我和朋友都遇到过的，基本覆盖了新手阶段的大部分情况。 提示权限不足：用管理员身份重新打开终端再执行一次。如果还是不行，就把全局安装目录改到用户目录下，别去动系统盘里的文件夹。 提示版本不匹配：明确的版本要求一般会写在项目说明里，按它说的换就行。这种情况用版本切换工具最方便，装一个能少掉很多眼泪。 下载卡住不动：多半是网络问题。可以换成国内的镜像源，速度会快很多。换完之后记得清一下缓存再重试，不然可能还是走老路。 端口被占用：报错里会写明是哪个端口。要么在配置里换一个不常用的端口，要么把占用它的进程找出来关掉。我一般直接把端口从默认值改成 3000 以上，冲突概率小很多。 启动后没反应：先别急着重装，去看日志文件。日志里通常会写清楚是配置项写错了，还是某个依赖没装上。学会看日志，能省下大量瞎猜的时间。 说句实在话，这类开源工具最劝退新手的从来不是功能复杂，而是环境问题太琐碎。我见过太多人卡在第一步就放弃了，其实只要把报错信息完整地复制出来搜一下，八成都能找到答案。搜的时候记得带上系统版本和错误码，命中率会高不少。 最后再唠叨一句：装好之后别急着一次性把所有功能都开起来，先跑通最基础的流程，确认能正常启动、正常响应，再一点点加配置。这样出问题的时候，你至少知道是哪一步引入的。工具是拿来用的，不是拿来跟它较劲的，能跑起来就是胜利。 OpenClaw中文版龙虾安装地址：https://top.wokk.cn