龙虾安装前置条件与准备步骤

在正式开始安装龙虾之前，需要先将运行环境准备妥当。以下条件缺一不可，并且建议按照指定顺序依次完成。

首先，确保已安装 Node.js。请前往官方网站（nodejs.org）下载与操作系统匹配的版本，使用默认选项一路完成安装即可，过程简单无陷阱。

其次，Git 也是必不可少的工具。从 git-scm.com 下载安装包后，打开终端（或 PowerShell），输入 git --version 查看是否有版本号返回——有则说明安装成功。随后建议将 npm 源切换至国内镜像，以大幅提升下载速度：执行 npm config set registry https://registry.npmmirror.com，再运行 npm config get registry 确认切换是否生效（显示 https://registry.npmmirror.com/ 即表示正确）。

此外，提前安装以下两个工具能有效避免大部分报错问题：

Windows Build Tools：从 visualstudio.microsoft.com/zh-hans/download 页面下载 Visual Studio 安装程序，运行时务必选择 "Desktop development with C++" 工作负载，并确保勾选 "Windows 10/11 SDK"。这一步用于编译本地模块，许多用户在此处遇到问题。

CMake：从 cmake.org/download 下载 "Windows x64 Installer" 版本。安装过程中务必勾选 "Add CMake to system PATH"，这样系统才能正确识别该工具。

正式安装龙虾步骤

环境准备就绪后，开始执行安装操作。

1. 以管理员身份打开 PowerShell，首先设置执行策略：Set-ExecutionPolicy RemoteSigned。按提示输入 Y 确认。

2. 执行安装命令：iwr -useb https://openclaw.ai/install.ps1 | iex。该命令会下载并运行安装脚本，请耐心等待脚本运行完毕。

3. 安装完成后，运行初始化设置命令：OpenClaw onboarding

安装模式选择 "QuickStart"（输入 yes 确认）。模型方面，新手推荐使用 Qwen 或 Kimi K2.5，任选其一即可。随后按要求输入您的 API Key，其余如技能配置、通信设置等均可暂时跳过——后续需要时再添加，避免在此处耽误时间。

配置完成后，选择 "Open the Web UI"。浏览器将自动打开，您也可以手动访问 https://127.0.0.1:18789/，此时即可看到操作界面。