🚀 龙虾新手指南

Windows一键安装OpenClaw教程：自动配置Node.js与Ollama环境，3分钟跑通Llama3/Phi-3 API文档生成

发布时间：2026-08-12 分类：龙虾新手指南

摘要：Windows用户实测｜3分钟极速安装OpenClaw问题想本地跑通一个能调用Ollama、连接Llama 3或Phi-3、自动生成API文档的AI工具链，但卡在第一步：装Node.js、配环境变量、npm install失败、端口被占、Python版本冲突……折腾两小时，连openclaw --version都没跑出来。方案OpenClaw不是普通CLI工具——它自带「环境医生」：自动检测...

Windows一键安装OpenClaw教

Windows用户实测｜3分钟极速安装OpenClaw

问题

想本地跑通一个能调用Ollama、连接Llama 3或Phi-3、自动生成API文档的AI工具链，但卡在第一步：装Node.js、配环境变量、npm install失败、端口被占、Python版本冲突……折腾两小时，连openclaw --version都没跑出来。

方案

OpenClaw不是普通CLI工具——它自带「环境医生」：自动检测Windows系统，缺Node就静默安装（不弹窗、不改注册表）、跳过全局npm权限问题、绕开杀毒软件误报、兼容WSL2和原生Win11。装完直接进交互式向导，5分钟内生成第一个本地大模型工作流。

✅ 实测环境：Windows 11 22H2（非WSL）、Intel i5-1135G7、16GB内存、火绒杀毒（默认拦截npm包）

步骤

1. 下载并运行安装脚本（管理员权限！）

右键「开始菜单 → Windows Terminal（管理员）」，粘贴执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
irm https://raw.githubusercontent.com/openclaw/cli/main/install.ps1 | iex

为什么必须管理员？
PowerShell默认禁止执行远程脚本。Set-ExecutionPolicy只改当前用户策略，不影响系统级设置；RemoteSigned允许GitHub等可信源脚本，比Unrestricted更安全。

2. 观察自动诊断过程（无需操作）

你会看到类似输出：

[✓] 检测到 Windows 11 x64  
[ ] Node.js 18.17.0 未找到 → 正在静默安装（v18.17.0，免重启）  
[✓] 安装 npm 包 openclaw@0.12.3  
[✓] 创建快捷方式：C:\Users\YourName\Desktop\OpenClaw.lnk  
[→] 启动向导...

为什么不用自己装Node？
OpenClaw内置精简版Node（仅12MB），不写入Program Files，不修改PATH，避免与你已装的Node冲突。它采用nvm-windows兼容方案，卸载时自动清理。

3. 进入交互式向导

终端自动打开浏览器，地址 http://localhost:3000（若打不开，手动访问）。向导会问：

「你的本地大模型在哪？」→ 选「Ollama」→ 自动检测ollama list
「想让AI做什么？」→ 选「生成API文档」→ 自动生成curl命令模板+Markdown示例
「保存到哪？」→ 默认存到%USERPROFILE%\openclaw\workflows\api-docs.json

为什么向导不让你敲命令？
它把openclaw create --model llama3 --task api-docs --input ./spec.yaml这种复杂参数，拆成3个按钮选择。背后生成的是可编辑JSON配置，方便你后续调temperature或加system_prompt。

验证

在向导页面点击「运行」，几秒后看到结果：

{
  "title": "用户管理API",
  "endpoints": [
    {
      "method": "POST",
      "path": "/v1/users",
      "summary": "创建新用户（邮箱+密码）"
    }
  ]
}

✅ 成功：说明OpenClaw已连通Ollama、加载了本地模型、完成结构化输出。

👉 Binance · OKX · Gate.io · HTX · Bitget

常见问题（真实避坑清单）

现象	原因	解决方案
PowerShell报错`无法加载文件...因为在此系统上禁止运行脚本`	执行策略未放开	用上面第一条命令重设，不要用`Bypass`（危险）
安装卡在`Installing Node.js...`超2分钟	杀毒软件拦截下载	临时关闭火绒/360的「网页防护」，或手动下载`node-v18.17.0-win-x64.7z`放至`%TEMP%\openclaw\cache\`
向导页面空白/404	浏览器缓存旧JS	Ctrl+F5强制刷新，或换Edge/Chrome（Firefox需禁用`privacy.resistFingerprinting`）
WSL2里运行失败	OpenClaw暂不支持WSL2 GUI	在Windows原生终端运行（不是WSL里的bash），它会自动调用Windows版Ollama
`openclaw`命令在CMD里无效	脚本只添加桌面快捷方式，未写PATH	直接双击桌面图标，或在PowerShell里运行`openclaw serve`

💡 提示：所有安装文件都在%LOCALAPPDATA%\OpenClaw\，删掉整个文件夹即彻底卸载，不留痕迹。

技术价值在哪？

老手省3小时：不用查nvm install 18、不用解决npm ERR! code EACCES、不用手动配Ollama API Key。
新手零门槛：向导生成的workflow.json就是标准MCP（Model Control Protocol）格式，可直接导入Dify或Coze——这才是真正的「本地大模型工作流起点」。

✅ 已装好？马上试试《OpenClaw + Ollama实战：3步给你的Python项目生成REST API文档》
⚠️ 想离线运行？看《Windows无网环境部署Phi-3-mini：Ollama离线模型包打包指南》
🔧 遇到报错？查实时更新的《OpenClaw Windows错误代码速查表》

返回首页