OpenClaw小龙虾Windows一键部署教程:2026实测10分钟跑起AI智能体

OpenClaw(小龙虾)Windows 一键部署保姆级教程(2026.5实测)
最近AI圈有个叫OpenClaw(大家爱叫它"小龙虾")的开源项目火得一塌糊涂,GitHub上已经冲到28万星。它最大的卖点就是:在你自己的电脑上跑AI智能体,不用写代码,还能自动帮你干活。
听起来很香对吧?但很多人卡在了"部署"这一步。网上教程要么太老,要么步骤复杂,新手很容易劝退。
这篇文章是我2026年5月在Windows 11上反复测试后写的,用我打包好的一键部署包,10分钟内就能跑起来。中间踩的坑我也都记下来了,照着做基本不会翻车。
为什么要用一键部署包?
正常装OpenClaw,你需要自己搞Node.js、配环境变量、处理各种依赖。光是Node.js版本不对就能卡住一堆人。
我这个部署包把这些全打包好了,解压就能用。核心思路就是:把别人踩过的坑,提前帮你填平。
准备工作
开始之前,确认一下你的电脑:
- 操作系统:Windows 10 或 Windows 11(64位)
- 内存:建议8GB以上(跑本地模型的话16GB更稳)
- 磁盘空间:至少留10GB空闲
- 网络:能正常上网(下载部署包和模型需要)
部署步骤
第一步:下载并解压部署包
从龙虾官网(yitb.com)的教程专区找到OpenClaw一键部署包,下载下来。
下载完成后,右键解压到一个英文路径下,比如 D:\OpenClaw。
为什么要英文路径? 很多开发工具对中文路径支持不好,可能会报莫名其妙的错。这是个老生常谈的问题,但每年还是有人中招。
解压后的文件夹结构大概长这样:
D:\OpenClaw\
├── node\ # 内置的Node.js运行环境
├── openclaw\ # OpenClaw主程序
├── start.bat # 一键启动脚本
├── fix-permission.bat # 权限修复脚本
└── README.txt第二步:解决Node.js版本冲突
这是最常见的坑。如果你电脑上之前装过Node.js,版本不对的话会跟部署包里的冲突。
先检查一下你系统里的Node.js版本:
node -v如果输出的版本号是 v16.x 或更低,需要先卸载系统的Node.js。
打开"设置 → 应用 → 安装的应用",搜"Node.js",卸载掉。
卸载完之后,重启一下电脑。这步别跳过,不然环境变量可能没清干净。
为什么要卸载系统的? 部署包里自带了适配OpenClaw的Node.js版本(v20.x),系统里如果存在旧版本,两个会打架,导致各种奇怪的报错。
如果你不想卸载系统的Node.js(比如你做其他开发要用),也可以临时指定用部署包里的:
# 在部署包目录下打开终端,设置临时PATH
set PATH=D:\OpenClaw\node;%PATH%
node -v看到版本号是 v20.x 就对了。
第三步:启动OpenClaw
双击 start.bat,会弹出一个黑色命令行窗口。
第一次启动会自动安装依赖,大概需要2-3分钟。看到类似这样的输出就说明成功了:
[OpenClaw] Starting...
[OpenClaw] Dependencies installed.
[OpenClaw] Server running at http://localhost:3000
为什么用bat脚本? 它帮你封装了启动命令,包括设置环境变量、切换到正确目录、调用内置Node.js。你不用记任何命令,双击就行。
第四步:处理WSL权限报错
如果你看到这样的错误:
Error: EACCES: permission denied, open '/mnt/c/...'这是WSL(Windows子系统Linux)的权限问题。运行一下部署包里的修复脚本:
# 双击运行 fix-permission.bat
# 或者在命令行里执行:
wsl --exec chmod -R 755 /mnt/d/OpenClaw为什么会报权限错? WSL访问Windows磁盘时,文件权限映射有时候会出问题。这个脚本就是把权限重新设对,让OpenClaw能正常读写文件。
修复完之后,重新双击 start.bat,应该就正常了。
第五步:验证本地大模型调用
OpenClaw跑起来之后,打开浏览器访问 http://localhost:3000。
你会看到一个简洁的操作界面。来验证一下AI能不能正常干活:
- 在界面左侧找到 "模型设置"
- 选择一个本地模型(比如
qwen2.5-7b),点"加载" - 等模型加载完成(状态显示"就绪")
- 在对话框里输入:"帮我写一个Python脚本,计算斐波那契数列前20项"
- 点发送
如果AI返回了一段Python代码,恭喜你,部署成功了!
# AI返回的示例代码
def fibonacci(n):
a, b = 0, 1
result = []
for _ in range(n):
result.append(a)
a, b = b, a + b
return result
print(fibonacci(20))常见问题
Q:启动时报"端口被占用"怎么办?
# 查看谁占了3000端口
netstat -ano | findstr :3000
# 记下最后一列的PID,然后:
taskkill /PID 12345 /FQ:模型加载很慢?
第一次加载模型需要下载,7B的模型大概4-5GB,取决于你的网速。加载完成后会缓存到本地,下次就快了。
Q:我的电脑配置低,能跑吗?
如果内存低于8GB,建议用 qwen2.5-1.5b 这种小模型,虽然能力弱一点,但至少能跑起来体验一下。
下一步学什么
部署成功只是开始。OpenClaw真正好玩的是它的工作流功能——你可以让AI自动执行多步任务,比如"帮我搜集某个话题的资料,整理成表格,再生成一份报告"。
推荐阅读:
有部署问题欢迎在评论区留言,我看到会回复。