# Windows 11系统OpenClaw（龙虾）安装教程｜保姆级一步到位



OpenClaw是一款能**真正落地执行任务**的开源 AI 智能体，可帮你处理邮件、管理日程、自动签到、对接聊天软件，全程在本地运行，隐私更安全。

本文基于 Windows 11 环境，把安装、配置、启动全流程拆到最简，新手照着做就能成功。

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/a7cfa6ac64af4d87fa38e66288e2be1c.png)

## 一、安装前准备（必做）

OpenClaw 依赖**Git**与**Node.js**运行，先装好这两个基础环境。

1. **安装 Git**

   下载地址：https://github.com/git-for-windows/git/releases/download/v2.52.0.windows.1/Git-2.52.0-64-bit.exe

   安装要点：全程**默认下一步**，无需修改配置。

   

2. **安装 Node.js**

   下载地址：https://nodejs.org/

   安装要点：选择**LTS 稳定版**，默认安装，自动配置环境变量。

   **OpenClaw 要求 Node.js 版本必须 ≥ 22**

   

3. **验证环境**

   以管理员身份打开 CMD，输入：

```
git --version
node -v
npm -v
```

出现版本号即环境正常。



## 二、安装 OpenClaw 核心程序

这一步是关键，**必须用管理员权限 CMD**，且确保能正常访问 GitHub。

1. 打开管理员 CMD

   路径：控制面板 → 系统和安全 → Windows 工具 → 找到**命令提示符** → 右键**以管理员身份运行**。

   

2. 执行安装命令

参考https://docs.openclaw.ai/zh-CN/install

```
iwr -useb https://openclaw.ai/install.ps1 | iex
或者
npm i -g openclaw --ignore-scripts --registry=https://registry.npmmirror.com
```



```
npm i -g openclaw --ignore-scripts --registry=https://registry.npmmirror.com
```

- 安装成功：提示更新若干包，无报错。
- 安装失败（code 128）：多执行几次命令，多为网络波动导致。

```
openclaw --version
```



### 安装报错：

```
PS C:\Users\Administrator> iwr -useb https://openclaw.ai/install.ps1 | iex
OpenClaw Installer
[OK] Windows detected
[OK] Node.js v24.14.0 found
[*] Installing OpenClaw (openclaw@latest)...
iex : 无法加载文件 D:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本。有关详细信息，请参阅 https:/go.microsof
t.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。
所在位置 行:1 字符: 45
iwr -useb https://openclaw.ai/install.ps1 | iex
                                        ~~~

CategoryInfo          : SecurityError: (:) [Invoke-Expression]，PSSecurityException
FullyQualifiedErrorId : UnauthorizedAccess,Microsoft.PowerShell.Commands.InvokeExpressionCommand
```

### 解决报错

```
设置执行策略为 RemoteSigned（允许运行本地脚本，远程脚本需签名）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
```

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/b7e080dd2ab19f7bad32995a3aea9884.png)

经过一段时间的安装

安装成功

```
PS C:\Users\Administrator> iwr -useb https://openclaw.ai/install.ps1 | iex

  OpenClaw Installer

[OK] Windows detected
[OK] Node.js v24.14.0 found
[*] Installing OpenClaw (openclaw@latest)...
[OK] OpenClaw installed

OpenClaw installed successfully (2026.3.2)!

Cozy. I've already read your calendar. We need to talk.

Starting setup...


🦞 OpenClaw 2026.3.2 (85377a2) — I autocomplete your thoughts—just slower and with more API calls.

Windows detected — OpenClaw runs great on WSL2!
Native Windows might be trickier.
Quick setup: wsl --install (one command, one reboot)
Guide: https://docs.openclaw.ai/windows
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                  🦞 OPENCLAW 🦞

T  OpenClaw onboarding
|
o  Security ---------------------------------------------------------------------------------+
|                                                                                            |
|  Security warning — please read.                                                           |
|                                                                                            |
|  OpenClaw is a hobby project and still in beta. Expect sharp edges.                        |
|  By default, OpenClaw is a personal agent: one trusted operator boundary.                  |
|  This bot can read files and run actions if tools are enabled.                             |
|  A bad prompt can trick it into doing unsafe things.                                       |
|                                                                                            |
|  OpenClaw is not a hostile multi-tenant boundary by default.                               |
|  If multiple users can message one tool-enabled agent, they share that delegated tool      |
|  authority.                                                                                |
|                                                                                            |
|  If you’re not comfortable with security hardening and access control, don’t run           |
|  OpenClaw.                                                                                 |
|  Ask someone experienced to help before enabling tools or exposing it to the internet.     |
|                                                                                            |
|  Recommended baseline:                                                                     |
|  - Pairing/allowlists + mention gating.                                                    |
|  - Multi-user/shared inbox: split trust boundaries (separate gateway/credentials, ideally  |
|    separate OS users/hosts).                                                               |
|  - Sandbox + least-privilege tools.                                                        |
|  - Shared inboxes: isolate DM sessions (`session.dmScope: per-channel-peer`) and keep      |
|    tool access minimal.                                                                    |
|  - Keep secrets out of the agent’s reachable filesystem.                                   |
|  - Use the strongest available model for any bot with tools or untrusted inboxes.          |
|                                                                                            |
|  Run regularly:                                                                            |
|  openclaw security audit --deep                                                            |
|  openclaw security audit --fix                                                             |
|                                                                                            |
|  Must read: https://docs.openclaw.ai/gateway/security                                      |
|                                                                                            |
+--------------------------------------------------------------------------------------------+
```

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/d423ff23c3ea4af8efd2f8e7d14f84ca.png)

### 查看版本

```
openclaw --version

PS C:\Users\Administrator> openclaw --version
2026.3.2
```

出现类似`2026.3.2`的版本号，说明安装成功。

## 三、初始化配置与启动

安装完成后，进行初始化配置，绑定 AI 模型并启动服务。

### 1.执行初始化命令

```
openclaw onboard --install-daemon
```

### 2.配置向导

协议确认：选**Yes**

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/266172a80982fcb72ff267cf3dd229f5.png)

### 3.安装模式：**QuickStart**



### 4.配置处理：**Use existing values**

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/f9030d90d6da00c9c678bfe4e62d3acf.png)

### 5.模型选择：新手推荐**Qwen**或**Moonshot AI (Kimi K2.5)**

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/1a9f4c562f831c12be51356ee6e856eb.png)

### 6.API 方式

选对应平台的 API Key，直接粘贴

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/b24b64612eb80304ac6bbed72934568b.png)

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/8eb320581fc6be344846d4bb68d78076.png)

### 7.通讯渠道

选**Skip for now**（后续可再加）

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/439f616b722ff39505fa83028fce29cf.png)

### 8.技能依赖

全部**Skip for now**



### 9.各类 API Key

统一选**No**



![img](https://developer.qcloudimg.com/http-save/yehe-8492898/e44b8ac15c3cb4d659c400ce9f7cc467.png)



### 10.网关服务

**Skip**



![img](https://developer.qcloudimg.com/http-save/yehe-8492898/eef68f14075e8ab351be44316620462b.png)



启动服务

### 11.配置完成后，选择

Open the Web UI

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/f42fb4f40578efde77a15b03bdac1972.png)

，浏览器自动打开本地面板：



```
http://127.0.0.1:18789/chat
```

如果需要验证去配置文件中查找

```
C:\Users\Administrator\.openclaw\config.json
查找

"port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "你的配置的token"
```



```
http://127.0.0.1:18789/?token=你的配置的token
```

看到面板显示**版本号 + 健康状况正常**，即为**完全启动成功**。

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/5862434a32182fb02dc20386e10322d7.png)



## 四、常见问题与注意事项

1. 安装报错 code 128：重试命令、检查网络、确认 Git 已装好。
2. 启动后无面板：重新执行初始化命令，确保端口 18789 未被占用。
3. 模型不生效：检查 API Key 是否正确，选择国内节点更稳定。
4. 运行更稳定：官方建议搭配**WSL2**使用，原生 Windows 偶有兼容问题。



## 五、总结

OpenClaw 是轻量化、强执行的本地 AI 助手，Windows 11 按 “装环境→装主程序→初始化→启 WebUI” 四步走，5–10 分钟就能完成部署。配置时尽量默认，减少出错概率，先用基础功能，熟悉后再扩展渠道与技能。

OpenClaw是一款能真正落地执行任务的开源 AI 智能体，可帮你处理邮件、管理日程、自动签到、对接聊天软件，全程在本地运行，隐私更安全。

Windows 11系统OpenClaw（龙虾）安装教程｜保姆级一步到位

运维经理

Windows11系统安装OpenClaw本地AI助手教程，详细讲解Git和Node.js环境配置、管理员权限安装步骤、初始化配置流程及常见问题解决方法。提供保姆级指导，帮助用户5-10分钟完成部署，实现邮件处理、日程管理等自动化任务。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

Windows 11系统OpenClaw（龙虾）安装教程｜保姆级一步到位-腾讯云开发者社区-腾讯云

Windows 11系统OpenClaw（龙虾）安装教程｜保姆级一步到位

Windows 11系统OpenClaw（龙虾）安装教程｜保姆级一步到位

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐