OpenClaw 龙虾部署记录
1. 安装 nvm-windows
首先,下载并运行 nvm-windows 的安装程序 nvm-setup.exe,版本 1.2.2。按照向导完成安装即可。
验证 nvm 是否安装成功(以管理员身份打开PowerShell)
安装完成后,得确认一下工具是否就位。在管理员权限的 PowerShell 中键入以下命令:
nvm version
如果终端显示出类似 1.1.12 的版本号,那就恭喜你,意味着 nvm 已经成功安装到你的系统里了。
2. 安装 Node.js
接下来,用 nvm 来安装特定版本的 Node.js。这里我们以安装 22.13.1 版本为例:
nvm install 22.13.1
这个命令会帮你下载并安装指定版本的 Node.js 及其对应的 npm。
3. 激活 Node.js
安装好之后,需要告诉系统现在要使用这个版本:
nvm use 22.13.1
验证当前版本
激活后,最好做个快速验证,确保一切如你所愿:
node -v # 应显示 v22.13.1
npm -v # 应显示对应的 npm 版本,例如 10.9.2
不过,在这个过程中,你可能会遇到一个常见的小插曲。如果 PowerShell 提示类似“无法加载文件 C:\nvm4w\nodejs\npm.ps1,因为在此系统上禁止运行脚本”的错误,别担心,这不是安装问题,而是系统的执行策略在“保护”你。
先查看一下当前的策略设置:
get-ExecutionPolicy
如果返回的是 Restricted(受限制的),那就对了,这正是问题的根源。
为了允许本地脚本运行,我们需要放宽一点策略。执行以下命令:
set-ExecutionPolicy RemoteSigned
系统会给出提示,输入“y”并确认。这个策略RemoteSigned 的含义是:允许运行本地创建的脚本,但对于从互联网下载的脚本,则需要有可信的签名才行,算是在安全和便利之间取得了一个平衡。
4. 安装 WSL2
OpenClaw 的部分功能依赖于 Linux 环境,因此我们需要准备 WSL2。打开“控制面板” -> “程序” -> “启用或关闭 Windows 功能”。
在弹出的窗口中找到并勾选“Hyper-V”和“适用于 Linux 的 Windows 子系统”这两项,然后按照提示重启电脑。
设置默认 WSL 版本为 WSL2
重启后,以管理员身份打开 PowerShell,设置 WSL 的默认版本:
wsl --set-default-version 2
安装Ubuntu
接下来,去 Microsoft Store 搜索并安装“Ubuntu 22.04.5 LTS”。安装完成后,直接从开始菜单启动它,或者使用命令来初始化:
wsl --install
首次运行会进行初始化,过程中会提示你设置一个用于该 Linux 子系统的用户名和密码,请务必记住它。
5. 安装 OpenClaw
万事俱备,现在可以安装主角 OpenClaw 了。首先,为了确保安装脚本能顺利运行,我们可能需要调整一下当前用户的 PowerShell 执行策略:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
运行安装脚本
对于 Windows (PowerShell) 用户,运行以下一条命令即可开始安装:
iwr -useb https://openclaw.ai/install.ps1 | iex
安装脚本会自动执行。如果后续你想安装守护进程或跳过了新手引导,可以运行:
openclaw onboard --install-daemon
之后,安装程序会引导你进行一系列配置,这里是一个典型的快速配置流程:
- 当提示 “I understand this is personal-by-default...” 时,选择 Yes。
- Onboarding mode:选择 QuickStart。
- Model/auth provider (模型选择):选择 Qwen。
- Default model:选择 Keep current。
- Select channel:选择 Skip for now。
- Search provider:选择 Skip for now。
- Configure skills now? (recommended):选择 No。
- Enable hooks?:选择 Skip for now。
- Gateway service already installed:选择 Skip for now。
- How do you want to hatch your bot?:选择 Open the Web UI。
当配置完成,看到“安装成功”的提示,并且自动弹出 Web 聊天界面时,就大功告成了。现在,你可以开始体验 OpenClaw 的功能了。