Windows本地部署OpenClaw指南：正确方法与避坑全攻略

安装运行环境

打开 OpenClaw 官网，你会看到官方提供了一行命令来安装。但如果你是 Windows 用户，千万别直接执行那行命令——失败率极高。新手小白建议按下面的步骤来，稳扎稳打，凑个热闹也顺利。

准备好的环境：

Node 22+
git

安装 Node.js

先安装 Node.js，版本号至少选 22 以上，低了就会逮虾失败。强烈推荐使用 nvm 来管理 Node 版本，尤其是本地多个前端项目齐头并进的时候，切换起来非常丝滑。

OpenClaw 是用 Ja vaScript 语言写的，而 Node.js 就是让 Ja vaScript 在你电脑上跑起来的运行环境。没有它，OpenClaw 就启动不了。

PS C:Users15117Desktop> nvm ls

  * 22.12.0 (Currently using 64-bit executable)
    20.19.2
    20.14.0
    18.20.3

安装 Git

打开 Git 官网，直接下载 Windows 版本的安装包，下一步安装即可。输入 git -v，Git 就成功安装了。

PS C:Users15117Desktop> git -v
git version 2.37.0.windows.1

安装 OpenClaw

遇到一个问题：按下 Win + X，选择 Windows PowerShell (管理员) 或 终端 (管理员)，确保是 PowerShell 模式。

C:WindowsSystem32>iwr -useb https://openclaw.ai/install.ps1 | iex
'iwr' is not recognized as an internal or external command,
operable program or batch file.

或者用 Cmd 执行下面的命令：

powershell -Command "iwr -useb https://openclaw.ai/install.ps1 | iex"

快速启动与配置向导

1、I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?

选 Yes，问你是不是要同意电脑授权，后面的步骤先跳过。

2、选择模式 ◇ Onboarding mode │ QuickStart 模式

选择 QuickStart，它会自动帮你配置好大部分默认设置，对新手最友好。

3、配置 AI 大模型

这是最重要的一步——告诉 OpenClaw 用哪个 AI 大模型来思考，也就是给龙虾选脑子。引导程序会列出一些 AI 平台供你选择，比如 Anthropic（Claude）、OpenAI（GPT）、Qwen（通义千问）等。

推荐新手选择 Qwen，因为它支持 OAuth 授权登录，会自动弹出网页让你扫码验证，不用手动申请和填写 API Key，而且可以直接免费使用。缺点是调用太频繁可能会被限流，所以只适合快速上手体验。

4、配置聊天渠道

引导程序会问你要不要连接 Telegram、WhatsApp、Discord、飞书等聊天平台，更方便跟龙虾对话。建议直接跳过（skip for now），先用网页界面聊天就好，保证安装成功。

5、配置 Skills 技能包

Skills 是给 AI 装的能力扩展包。OpenClaw 本身只是一个框架，装了 Skills 之后 AI 才能解锁各种具体的能力，比如搜索网页、操作浏览器、制作 PPT 等。

配置钩子（Hooks）：这是高级功能，用于在启动时加载文档、记录日志等。直接选择 “Skip for now”，先按空格选中，再回车。

安装到这里的时候不是错误，时间有点长，等待一会，他会让你选择是不是要 web-ui 打开，选择是就可以。

6、安装成功

来源：互联网