Windows 11系统下将OpenClaw安装至D盘：环境C盘、数据D盘的详细配置指南

在 Windows 11 系统上安装 OpenClaw（小龙虾）时，你是否也担心 C 盘空间被迅速挤占？一个常见的需求是：希望 Node.js、pnpm 等基础环境沿用 C 盘默认安装路径以保证兼容性，但将 OpenClaw 的程序文件、配置数据、缓存和工作区全部转移到 D 盘。本文将详细介绍如何通过配置环境变量和安装参数，实现这一目标，从而在不修改核心环境路径的前提下，为 C 盘“减负”。

一、C盘安装基础环境

此部分所有环境组件均安装于C盘默认路径，无需特别修改。

1、系统要求

• Windows 11 64位操作系统，内存建议 8GB 及以上。
• D 盘预留至少 10GB 空间，用于存储 OpenClaw 的各类数据与缓存。
• 稳定的网络连接，建议配置国内镜像以加速下载。

2、开启WSL2
WSL2 环境默认安装在 C 盘，按以下任一方式开启即可。

图形化开启：

1. 按下 Win + R，输入 optionalfeatures 后回车。
2. 在弹出的窗口中，勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”。
3. 点击“确定”并重启计算机。

命令行开启（管理员 PowerShell）：

wsl --install
wsl --set-default-version 2

重启后，以管理员身份打开 PowerShell 或 Windows 终端，执行以下命令验证：

wsl --status

若 Default Version 显示为 2，则表示 WSL2 已设为默认。或者，你可以查看所有发行版的详细状态：

wsl --list --verbose

输出示例中，VERSION 列为 2 即表示运行在 WSL2 模式下。

NAME            STATE           VERSION
Ubuntu-22.04    Running         2

若 VERSION 为 1，可使用 wsl --set-version <发行版名> 2 命令进行升级。

3、安装Node.js
OpenClaw 依赖 Node.js v22 或更高版本。请从官网下载 22.x LTS 版本的 64 位安装包。安装过程中，路径保持默认的 C:\Program Files\nodejs\，并务必勾选 Add to PATH 选项以自动配置环境变量。安装完成后，在新终端中验证：

node -v  # 输出 v22.x.x 即为成功
npm -v   # 输出 10.x+ 即为成功

4、安装pnpm（C盘默认路径）
通过 npm 全局安装 pnpm，其自身会安装在 C 盘用户目录下。

# 可先切换至国内镜像以提升下载速度
npm config set registry https://registry.npmmirror.com

# 全局安装 pnpm
npm install -g pnpm

# 验证安装
pnpm -v  # 输出版本号即为成功

5、安装Git（C盘默认路径）
从 Git for Windows 官网 下载安装程序。安装时，路径保持默认的 C:\Program Files\Git\。在“调整您的PATH环境”步骤中，请选择第二项“Git from the command line and also from 3rd-party software”，以确保 Git 命令在所有终端中可用。安装完成后验证：

git --version

二、配置D盘目录与环境变量

接下来，我们在 D 盘创建专属目录，并通过系统环境变量引导 OpenClaw 将数据存储于此。

1、手动创建D盘目录结构
在 D 盘根目录下创建 OpenClaw 文件夹，并在其内部建立如下子目录（请确保路径为全英文且无空格）：

D:\OpenClaw
├── data      # 用于存放配置、日志、数据库文件
├── workspace # 用于存放AI生成的项目与文件
└── cache     # （可选）用于存放模型缓存

2、设置系统环境变量
以管理员身份打开 PowerShell，执行以下命令来设置系统级环境变量，强制 OpenClaw 读写 D 盘对应目录。

# 指定OpenClaw的数据根目录
[Environment]::SetEnvironmentVariable("OPENCLAW_HOME", "D:\OpenClaw\data", "Machine")

# 指定工作区目录
[Environment]::SetEnvironmentVariable("OPENCLAW_WORKSPACE", "D:\OpenClaw\workspace", "Machine")

# （可选）指定缓存目录
[Environment]::SetEnvironmentVariable("OPENCLAW_CACHE", "D:\OpenClaw\cache", "Machine")

3、重启终端使环境变量生效
执行完上述命令后，关闭所有已打开的终端窗口，重新以管理员身份打开一个新的 PowerShell，以使新的环境变量生效。

三、在D盘安装与部署OpenClaw

环境变量配置好后，可以通过以下几种方式将 OpenClaw 部署到 D 盘。

1、官方一键脚本安装（推荐）
这是最快捷的安装方式，脚本会自动识别已设置的环境变量。

# 首次运行可能需要更改执行策略
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

# 切换到我们在D盘创建的目录
cd D:\OpenClaw

# 执行官方安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex

运行过程中如有安全提示，输入 Yes 继续。等待约 3-5 分钟，看到 installed successfully 提示即表示安装完成。

2、通过pnpm全局安装
这种方式提供了更多的可控性。

# 全局安装OpenClaw（包管理文件仍在C盘，但数据指向D盘）
pnpm add -g openclaw@latest

# 批准构建脚本（首次安装通常需要）
pnpm approve-builds -g

# 初始化，并显式指定数据目录到D盘
openclaw onboard --data-dir D:\OpenClaw\data --install-daemon

3、源码部署（适合开发者）
如果你需要进行二次开发，可以选择从源码部署。

# 进入D盘目录
cd D:\OpenClaw

# 克隆源码仓库到D盘
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装项目依赖（依赖包仍存储在C盘的全局目录）
pnpm install

# 运行初始化配置（会自动读取指向D盘的环境变量）
pnpm run setup

# 启动开发服务器
pnpm run dev
# 启动后，可通过浏览器访问 http://localhost:3000

四、验证安装与基本操作

安装完成后，可以通过一系列命令验证 OpenClaw 是否正常运行且数据目录已正确指向 D 盘。

# 查看版本信息
openclaw -v

# 检查系统健康状态
openclaw doctor
openclaw status

# 运行初始化配置向导
openclaw onboard

# 启动后台网关服务
openclaw gateway start

# 打开Web管理面板（需先启动网关服务）
openclaw dashboard

按照以上步骤操作，你就能成功在 Windows 11 上实现“环境在C盘，数据在D盘”的 OpenClaw 部署方案。这种方法有效平衡了系统兼容性与磁盘空间管理，非常适合运维日常使用或开发测试。如果在配置过程中遇到关于环境变量或网络权限的问题，可以参考相关文档或在技术社区如云栈社区交流探讨。