## Windows端本地部署 OpenClaw

### 一、安装运行环境

打开 OpenClaw 官网，你会看到官方提供了一行命令来安装。但如果你是 Windows 用户，千万不要直接执行一行命令安装！失败率极高！！！如果你是新手小白，我手把手带你养龙虾，凑个热闹~

准备好的环境：

```bash
Node 22+
git
```

#### 1、安装 Node.js

先安装node.js，注意版本号 **至少选 22 以上**，低于这个版本就会逮虾失败，我本地使用的是nvm，强烈推荐大家使用nvm来管理Node版本，尤其是你本地多个前端项目齐头并进的时候，非常丝滑。

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

```bash
PS C:\Users\15117\Desktop> nvm ls

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

#### 2、安装 Git

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

```bash
PS C:\Users\15117\Desktop> git -v
git version 2.37.0.windows.1
```

#### 3、安装 OpenClaw

遇到了一个问题，按下 `Win + X`，选择 **Windows PowerShell (管理员)** 或 **终端 (管理员)** （确保是 PowerShell 模式，我选的是终端管理员）。

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

或者是用Cmd ，执行下面的命令， OpenClaw 就开始安装了。

```
powershell -Command "iwr -useb https://openclaw.ai/install.ps1 | iex"
```
![ScreenShot_2026-03-10_210833_473.png](https://developer.qcloudimg.com/http-save/yehe-10334881/1be9b0933ece39fe53110ac6fa12d19c.png)

#### 4、快速启动与配置向导



![1 (2).png](https://developer.qcloudimg.com/http-save/yehe-10334881/063132608a584c1cd88670c21309330b.png)
**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（通义千问）等。

![ScreenShot_2026-03-10_212357_495.png](https://developer.qcloudimg.com/http-save/yehe-10334881/b80df3501a6209464a5ae1ca1086c8e0.png)

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

![ScreenShot_2026-03-10_212414_591.png](https://developer.qcloudimg.com/http-save/yehe-10334881/62d0471920b5c5354d85ad0feffa8590.png)



4、配置聊天渠道，暂时先跳过

![配置聊天机器人.png](https://developer.qcloudimg.com/http-save/yehe-10334881/9d51662e4879aff3fce77fab03aa2f45.png)

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

5、配置 Skills 技能包，暂时先跳过

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

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


> 安装到这里的时候不是错误，时间有点长，等待一会，他会让你选择是不是要web-ui打开，选择是就可以
![ScreenShot_2026-03-10_213658_183.png](https://developer.qcloudimg.com/http-save/yehe-10334881/eaac147d40e83af4f83e44cd33756d04.png)


6、安装成功
![ScreenShot_2026-03-10_214023_057.png](https://developer.qcloudimg.com/http-save/yehe-10334881/42d9b5b5ea3ef6103ace61b6b465da33.png)


#### 5、设置Api key 

在更新一下设置Api key ，在上面的步骤一直在跳过，这里需要设置自己的Api key ，用`openclaw onboard `重新启动openclaw安装的向导。（其实我之前的千问授权操作就是设置Api key 只不过每次都要重新授权 ，偶尔还有`未授权`的错误提示）
我使用的是Deepseek的key，所以需要设置一下，然后在重启访问。

![apikey3.png](https://developer.qcloudimg.com/http-save/yehe-10334881/0ac8fba21e35d0ffff7462e6b269a4be.png)

一直操作下一步，然后重启，然后在问OpenClaw，它会说已经设置好了，并且可以使用下面的命令进行调整
```bash

# 临时切换
/model openai/gpt-5.1-codex

# 或永久修改默认模型
openclaw config set agents.defaults.model.primary "openai/gpt-5.1-codex"
```
![1122.png](https://developer.qcloudimg.com/http-save/yehe-10334881/b89a76e113557810df5e8c784df69b18.png)

打开 OpenClaw 官网，你会看到官方提供了一行命令来安装。但如果你是 Windows 用户，千万不要直接执行一行命令安装！失败率极高！！！如果你是新手小白，我手把手带你养龙虾，凑个热闹~

避坑指南：专为 Windows 用户安装 OpenClaw 的正确姿势，拒绝失败率 100%

想玩 OpenClaw 但怕环境装不好？这份教程专门写给 Windows 新手！用 nvm 管理 Node 版本、Git 安装、甚至教你避开 iwr 命令不认识的坑，最后还能扫码免费使用通义千问，简直是保姆级喂饭！

后端高级工程师

开发工具

操作系统

客户端

Windows本地部署OpenClaw详细教程：从Node.js 22+和Git安装到AI模型配置，手把手教你快速搭建OpenClaw环境。特别提醒Windows用户避免直接执行官网命令，推荐使用nvm管理Node版本，选择Qwen模型实现免APIKey快速体验，适合新手入门AI开发。

Windows

OAuth

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

避坑指南：专为 Windows 用户安装 OpenClaw 的正确姿势，拒绝失败率 100%-腾讯云开发者社区-腾讯云

避坑指南：专为 Windows 用户安装 OpenClaw 的正确姿势，拒绝失败率 100%

避坑指南：专为 Windows 用户安装 OpenClaw 的正确姿势，拒绝失败率 100%

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐