前言
很多教程会建议 Windows 用 WSL2 跑 OpenClaw（兼容性更好），但如果你的需求是：
– **不使用 WSL2 / Ubuntu**
– **直接在 Win10 原生安装 OpenClaw**
– 并且要求：OpenClaw 的数据（配置/凭证/会话/日志/工作区）全部放到**系统盘外**（例如 D 盘）
那本文就是为你准备的“原生 Windows 版”。步骤会写得很细，小白照做也能跑通。
## 准备工作
你需要：
1. Windows 10（建议 64 位、系统尽量新）
2. 一个非系统盘（例如 D 盘）用于存放 OpenClaw 数据
3. 管理员权限（要装依赖、写系统环境变量）
4. 能正常联网下载（Node、OpenClaw 安装脚本需要）
## 目录规划（先把“数据全放 D 盘”定死）
本文默认：
– 状态目录（配置/凭证/会话/日志/缓存）：`D:OpenClawstate`
– 工作区（你的项目/技能/文件等）：`D:OpenClawworkspace`
## 第一步：安装必备依赖（Node 22+、Git、winget）
### 1）管理员打开 PowerShell
开始菜单搜索 **PowerShell** → 右键 → **以管理员身份运行**。
### 2）确认 winget 可用
winget -v### 3）安装 Node.js（必须，要求 Node >= 22）
winget install -e --id OpenJS.NodeJS.LTS装完后**新开一个 PowerShell 窗口**验证：
node -v
npm -v确保 `node` 显示 **v22.x** 或更高。
### 4）安装 Git（推荐）
winget install -e --id Git.Git验证：
git --version## 第二步：创建目录 + 设置系统环境变量（让所有数据都到 D 盘）
### 1）创建目录
mkdir D:OpenClawstate -Force
mkdir D:OpenClawworkspace -Force### 2）设置 OpenClaw 关键环境变量（系统级，永久生效）
setx OPENCLAW_STATE_DIR "D:OpenClawstate" /M
setx OPENCLAW_CONFIG_PATH "D:OpenClawstateopenclaw.json" /M
setx OPENCLAW_WORKSPACE_DIR "D:OpenClawworkspace" /M### 3）让环境变量生效（重要）
`setx` 写入后，你必须**重新打开 PowerShell**（或重启电脑）才会在当前终端生效。
验证：
echo $env:OPENCLAW_STATE_DIR
echo $env:OPENCLAW_CONFIG_PATH
echo $env:OPENCLAW_WORKSPACE_DIR你应该看到：
– `D:OpenClawstate`
– `D:OpenClawstateopenclaw.json`
– `D:OpenClawworkspace`
## 第三步：安装 OpenClaw（推荐 install.ps1）
### 方式 A（推荐）：官方 install.ps1 一键安装
管理员 PowerShell：
iwr -useb https://openclaw.ai/install.ps1 | iex安装完成后，重新打开一个 PowerShell，验证：
openclaw --version### 方式 B（备用）：npm 手动安装
npm install -g openclaw@latest
openclaw --version## 第四步：运行新手向导（并安装后台常驻服务）
openclaw onboard --install-daemon小白建议选择：
– Gateway：本机（local）
– 运行时：**Node**（不建议 Bun）
– 渠道：可以先跳过，先用 Dashboard 验证跑通
– 模型认证：按你手头可用方式（API Key / OAuth）配置
完成后建议检查：
openclaw gateway status
openclaw status
openclaw health## 第五步：把密钥放进 `D:OpenClawstate.env`（最稳）
OpenClaw 会读取全局 `.env`：`$OPENCLAW_STATE_DIR.env`。
创建/编辑：
notepad D:OpenClawstate.env示例（按需填写）：
OPENAI_API_KEY=sk-xxxxxxxx
ANTHROPIC_API_KEY=sk-ant-xxxxxxxx
OPENROUTER_API_KEY=sk-or-xxxxxxxx保存后重启 Gateway：
openclaw gateway restart验证：
openclaw models status
openclaw health## 第六步：强制工作区固定到 D 盘（双保险）
你已经设置了 `OPENCLAW_WORKSPACE_DIR`，为了更稳，建议在配置文件里也写死（避免极端情况下仍用默认目录）。
编辑：
notepad D:OpenClawstateopenclaw.json加入/修改（示例，JSON5 写法）：
{
routing: {
agents: {
main: {
workspace: "D:\OpenClaw\workspace",
},
},
},
}保存后：
openclaw gateway restart## 第七步：打开 Dashboard（验证是否跑通）
默认地址：
– `http://127.0.0.1:18789/`
如果提示 token，按向导生成的 token 输入即可。
## 第八步：运维命令（最常用的就这些）
状态/重启：
openclaw gateway status
openclaw gateway restart前台调试（出问题时最快）：
openclaw gateway run跟踪日志：
openclaw logs --follow## 第九步：避坑总结（FAQ）
### 1）Q：`openclaw` 不是内部或外部命令？
A：本质是 PATH 没更新。
– 先关闭所有 PowerShell/终端，再新开一个试：
openclaw --version– 仍不行：检查 npm 全局前缀：
npm config get prefix然后把该目录（或常见的 `%AppData%npm`）加入系统 PATH。
### 2）Q：我写了 `.env`，但 `openclaw health` 还是说未配置认证？
A：确认 `.env` 位置必须是：
– `D:OpenClawstate.env`
查看内容：
type D:OpenClawstate.env然后重启：
openclaw gateway restart
openclaw models status
openclaw health### 3）Q：关掉终端后 OpenClaw 就没了？
A：你跑的是前台模式。请用：
openclaw onboard --install-daemon
openclaw gateway status确认后台服务已安装。
### 4）Q：怎么确认后台服务（计划任务）存在？
A：
schtasks /Query /FO LIST | findstr /I "OpenClaw"### 5）Q：端口 18789 被占用怎么办？
A：先重启：
openclaw gateway restart还不行就前台 `run` 看清具体报错：
openclaw gateway run## 结语
按本文走原生 Win10 路线，你可以在不使用 WSL2 的情况下部署 OpenClaw，并且通过 `OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH` 把所有数据固定到系统盘外。