🚀 龙虾新手指南

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

发布时间:2026-07-05 分类: 龙虾新手指南
摘要:OpenClaw(小龙虾)Windows 一键部署保姆级教程(2026.5实测)最近AI圈有个叫OpenClaw(大家爱叫它"小龙虾")的开源项目火得一塌糊涂,GitHub上已经冲到28万星。它最大的卖点就是:在你自己的电脑上跑AI智能体,不用写代码,还能自动帮你干活。听起来很香对吧?但很多人卡在了"部署"这一步。网上教程要么太老,要么步骤复杂,新手很容易劝退。这篇文章是我2026年5月在W...

封面

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能不能正常干活:

  1. 在界面左侧找到 "模型设置"
  2. 选择一个本地模型(比如 qwen2.5-7b),点"加载"
  3. 等模型加载完成(状态显示"就绪")
  4. 在对话框里输入:"帮我写一个Python脚本,计算斐波那契数列前20项"
  5. 点发送

如果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 /F

Q:模型加载很慢?

第一次加载模型需要下载,7B的模型大概4-5GB,取决于你的网速。加载完成后会缓存到本地,下次就快了。

Q:我的电脑配置低,能跑吗?

如果内存低于8GB,建议用 qwen2.5-1.5b 这种小模型,虽然能力弱一点,但至少能跑起来体验一下。


下一步学什么

部署成功只是开始。OpenClaw真正好玩的是它的工作流功能——你可以让AI自动执行多步任务,比如"帮我搜集某个话题的资料,整理成表格,再生成一份报告"。

推荐阅读:

有部署问题欢迎在评论区留言,我看到会回复。

返回首页