Win10系统本地部署OpenClaw全攻略：小龙虾AI零基础图文详解

一、部署前准备：管理员权限与执行策略（必做）

这是整个部署流程的第一步，也是最容易出错的地方。请严格按照以下步骤操作，避免后续权限不足导致的各种问题。

1.1 以管理员身份打开 PowerShell

按住 Win + X 组合键，在弹出的菜单中选择 Windows PowerShell（管理员）。如果习惯使用搜索，也可以直接在开始菜单搜索 “PowerShell”，然后右键选择 “以管理员身份运行”。这一步非常关键，普通权限无法完成后续的配置操作。

1.2 解除脚本执行限制

Windows 10 默认禁止运行未经签名的脚本，这是为了保护系统安全。但 OpenClaw 的运行需要这一权限才能正常工作。复制以下命令，粘贴到 PowerShell 窗口，回车执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

当系统提示确认时，输入 Y 并回车即可。

为什么要解除这个限制？ Windows 系统出于安全考虑，默认只允许运行由受信任发布者签名的脚本。OpenClaw 的核心组件属于未签名脚本，如果不解除这个限制，程序将无法正常启动和运行。

---

二、安装 Node.js 环境（必须版本：22.x LTS）

Node.js 是 OpenClaw 运行的基础环境，如同人体的心血管系统一样重要。版本必须选择 22.x LTS（长期支持版），切勿使用其他版本，否则可能出现兼容性问题。

2.1 官方下载途径

Node.js 官方下载地址：https://nodejs.org/zh-cn/download/

Windows 64 位 LTS 直接下载：https://nodejs.org/dist/v22.14.0/node-v22.14.0-x64.msi

2.2 安装步骤详解

1. 双击下载的 .msi 安装包文件，进入安装向导。
2. 点击 “下一步”，勾选 “我接受许可协议条款”。
3. 继续点击 “下一步”，找到 “Add to PATH” 选项并务必勾选。这一步关系到环境变量是否自动配置，关系到全局命令是否能正常使用。
4. 再次点击 “下一步” → “安装” → “完成”，等待安装完成。

2.3 安装验证

重要提示：安装完成后，请重新打开一个 PowerShell 窗口（不是之前那个），然后执行以下命令进行验证：

node --version    # 显示 v22.x.x 表示正常
npm --version     # 显示版本号表示正常

如果两个命令都能返回正常的版本号，说明 Node.js 安装成功，可以继续下一步。

---

三、安装 Git 版本控制工具（必须）

Git 是开源软件包管理的重要工具，也是后续命令行操作的基础依赖。虽然看似与 OpenClaw 无直接关联，但在实际使用中许多场景都离不开它。

3.1 下载地址

Git 官方下载地址：https://git-scm.com/

Windows 版本直接下载：https://git-scm.com/download/win

3.2 安装说明

安装过程非常简单，双击安装包启动安装向导，全程选择默认选项即可。安装程序会自动配置好 PATH 环境变量，无需手动操作。点击 “下一步” 直至安装完成。

3.3 安装验证

git --version    # 显示版本号正常

---

四、配置 npm 国内镜像源（加速必做）

官方 npm 源在国内访问速度较慢，经常出现超时、卡顿等问题。配置国内镜像源可以大幅提升下载速度，避免因网络问题导致的安装失败。

4.1 配置命令

npm config set registry https://registry.npmmirror.com
npm cache clean --force

4.2 验证配置是否生效

npm config get registry    # 输出 https://registry.npmmirror.com 即为成功

---

五、手动安装 OpenClaw（官方 npm 包）

准备工作全部完成后，终于可以安装 OpenClaw 本体了。这一步将通过 npm 全局安装的方式完成。

5.1 安装命令

重要：请确保 PowerShell 为管理员身份运行，然后执行：

npm install -g openclaw --registry=https://registry.npmmirror.com

参数说明：

• -g：表示全局安装，让 OpenClaw 命令在系统任意位置均可调用
• --registry：强制使用国内镜像加速，显著减少等待时间

5.2 安装验证

openclaw --version    # 显示版本号（如 2026.x.x）即表示安装成功

---

六、Windows 系统权限配置（专属步骤）

Windows 系统对文件访问权限的管理比 Linux 更为严格，这一步是为 OpenClaw 授予完全控制权限，避免因权限问题导致配置文件读取或写入失败。

6.1 查询 OpenClaw 安装路径

npm config get prefix

默认全局路径通常为：C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw

6.2 授予 OpenClaw 目录完全控制权限

icacls "C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw" /grant Everyone:F /T

参数说明：

• /grant Everyone:F：授予所有用户完全控制权限
• /T：递归处理所有子文件和子目录

6.3 授予用户目录权限

icacls "C:\Users\$env:USERNAME\.openclaw" /grant Everyone:F /T

这一步是为了确保 OpenClaw 在运行过程中能够正常读写用户配置文件。

---

七、初始化与配置 OpenClaw

环境安装完毕，接下来需要对 OpenClaw 进行初始化配置，这是整个部署过程中最关键的一步。

7.1 执行初始化命令

在 PowerShell 中执行：

openclaw onboard --mode local

执行后，按照引导提示操作：

• 第一个问题选择 yes（同意初始化）
• 其他选项除大模型配置外全部选择默认
• 大模型配置请根据自己的实际配置进行选择，这一步关系到 OpenClaw 是否能正常连接 AI 服务

7.2 获取访问令牌

初始化完成后，执行：

openclaw dashboard

浏览器会自动弹出一个界面。在地址栏中，找到 #token= 后面的那串字符，那便是你的访问令牌，请妥善保存。

7.3 如需重新配置

如果后续需要修改配置，执行以下命令重置：

openclaw onboard --mode local --reset

修改完成后，记得执行 openclaw gateway 重启网关使配置生效。

---

八、启动 OpenClaw 网关服务

终于到了最激动人心的时刻——启动 OpenClaw！

8.1 启动网关

以管理员身份打开 PowerShell，执行：

openclaw gateway

8.2 判断是否启动成功

启动成功时，终端会输出类似以下内容：

OpenClaw 2026.4.29 — ... Gateway running on http://localhost:18789

只要看到 running on http://localhost:18789，说明服务已经正常运行。 此时网关已在本地计算机的 18789 端口上监听，等待你的访问。

---

九、访问 OpenClaw 管理后台

服务启动后，就可以通过浏览器访问 OpenClaw 的 Web 管理界面了。

9.1 访问地址

打开任意浏览器（Chrome、Edge、360 等均可），在地址栏输入：

http://localhost:18789

回车后即可进入 OpenClaw 的 Web 管理界面。

9.2 首次登录

首次登录时，需要输入前面步骤获取的令牌（Token）进行身份验证。验证通过后，你就可以开始使用 OpenClaw 的全部功能了。