windows 10安装openclaw小龙虾
系统信息
本安装指南记录了在特定测试环境下的安装流程。请注意,您的实际安装结果可能因个人操作系统版本、所选软件发行版以及OpenClaw项目的实时更新而有所不同。
下载安装Node.js与准备Ubuntu环境
成功部署OpenClaw依赖两个核心工具:Node.js运行时和一个稳定的Linux环境。我们将在Windows上通过WSL2来配置后者。
1. 获取Node.js安装包
访问Node.js官网,下载适用于Windows的安装程序。建议为系统稳定性选择LTS(长期支持)版本。
2. 安装并验证Node.js
运行下载的安装程序,按照向导完成安装。安装结束后,打开命令提示符或PowerShell,执行 node -v 和 npm -v 来验证安装是否成功,并确认其已加入系统PATH。
3. 安装pnpm包管理器
现代前端项目普遍使用pnpm以提升依赖管理效率。通过npm全局安装它:
npm install -g pnpm
4. 验证pnpm安装
运行 pnpm 命令。如果终端返回pnpm的命令行帮助信息,则表明安装正确。
pnpm
5. 安装WSL2
WSL2(Windows Subsystem for Linux 2)是运行Linux环境的关键。首先,检查当前WSL状态:
wsl -l -v
若未安装,请先确认Windows 10版本不低于2004(内部版本≥19041)。使用 winver 命令核查。尽管官方提供了 wsl --install 命令,但偶尔会遇到功能已启用却无法安装发行版的情况:
此时需要手动启用相关Windows功能。以管理员身份启动PowerShell,执行:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
6. 手动安装WSL2内核更新包
功能启用后,必须安装WSL2 Linux内核更新包。从微软官方页面下载并运行安装程序,完成后重启计算机。
下载地址:https://aka.ms/wsl2kernel
7. 设置WSL2为默认版本并安装Ubuntu
重启后,以管理员身份打开PowerShell,将WSL默认版本设置为2:
wsl --set-default-version 2
随后安装Ubuntu发行版。若此前 wsl --install 失效,请使用指定发行版的命令:
wsl --install -d Ubuntu
8. 完成Ubuntu初始化
执行上述命令后,再次重启计算机以确保所有组件加载完成。之后从开始菜单启动“Ubuntu”应用。首次运行会进行解包与初始化,随后系统会提示你创建UNIX用户名和密码,此密码在执行sudo权限命令时使用。
提示:若安装过程中系统提示需要启用虚拟化技术,请进入计算机BIOS设置,启用Intel VT-x或AMD-V等相关选项。
9. 最终验证
环境配置完成后,进行最终验证。在PowerShell中运行:
wsl -l -v
确认输出列表中包含“Ubuntu”且版本为“2”,即表示WSL2与Ubuntu子系统安装成功。
安装OpenClaw
基础环境就绪后,即可开始安装OpenClaw。建议先浏览其官方网站以获取最新信息。
安装命令本身简洁,但关键点在于:必须在WSL的Ubuntu终端会话中执行,并建议先切换至用户家目录。
启动Ubuntu终端,确认当前路径为家目录(~),然后执行官方一键安装脚本:
curl -fsSL https://openclaw.ai/install.sh | bash
脚本将自动拉取所需组件并进行环境配置。
此过程可能需要几分钟,请保持网络连接并耐心等待。
安装完成后,脚本将自动进入交互式初始配置流程。
配置模型与授权
首先,根据你的需求与API可用性,从列表中选择一个AI大语言模型,例如千问。
选定模型后,安装程序通常会提供一个OAuth授权链接。复制该链接至Windows默认浏览器中打开,并按照页面指引完成账号授权。
在后续的配置项中,例如网络端口设置,若暂时采用默认值,可选择“keep current”或直接跳过。
其他高级配置选项也可在初次安装时略过,待后续在管理界面中按需调整。
安装成功与访问
当终端显示“Installation successful”并输出一个本地访问URL时,核心安装即告完成。请保存此URL。
启动网关服务
为使Web管理界面可访问,需在Ubuntu后台启动网关服务。执行:
nohup openclaw gateway > openclaw-gateway.log 2>&1 &
获取访问令牌
最后,获取登录仪表板所需的身份验证令牌:
openclaw dashboard --no-open
命令输出将包含一个嵌入了有效token的本地HTTP链接。
将此完整链接复制到Windows浏览器地址栏中打开,即可访问OpenClaw的Web管理控制台,标志着整个部署流程成功结束。
重要提示:本指南基于特定时间节点的测试环境生成。实际安装时,请务必根据您当前的系统状态、软件版本和OpenClaw官方文档进行适应性操作。























