1. OpenClaw本地部署全流程解析
OpenClaw(小龙虾)作为一款新兴的智能协作工具,其本地化部署能力让企业可以在私有环境中实现安全可控的AI应用。最近在帮某金融团队部署时,发现官方文档对Windows环境的说明较为简略,这里结合实战经验整理一份完整指南。
重要提示:部署前请确保系统满足Node.js版本要求(>=22.22.3 <23, >=24.15.0 <25, 或 >=25.9.0),这是很多安装失败的根源问题。
1.1 基础环境准备
对于Windows用户,推荐使用WSL2+Ubuntu组合方案,实测比纯Windows环境更稳定。以下是具体步骤:
- 启用WSL功能(管理员PowerShell执行):
bash复制dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
- 安装Ubuntu 22.04 LTS后,需特别注意显卡驱动配置:
bash复制# 检查NVIDIA驱动是否正常
nvidia-smi
# 安装CUDA Toolkit(版本需与驱动匹配)
sudo apt install nvidia-cuda-toolkit
- Node.js版本管理建议使用nvm:
bash复制curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 22.22.3
1.2 核心组件安装
OpenClaw的依赖管理比较特殊,需要特别注意:
bash复制# 必须使用Yarn而非npm
corepack enable
yarn set version stable
# 克隆仓库时建议指定深度(国内网络优化)
git clone --depth=1 https://github.com/openclaw/openclaw.git
# 安装依赖时
