Windows 部署 OpenClaw 完整教程（2026 最新版）

一、部署环境说明

• ✅ 无需科学上网
• ✅ 本地部署，无需 WSL

---

二、安装步骤

1. 安装 Node.js、Git 和 Visual Studio

（1）下载安装包

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

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

Visual Studio 下载地址： https://visualstudio.microsoft.com/

（2）安装 Git

安装过程中请全部勾选选项，持续点击"下一步"直至完成。

在相关步骤选择 "Use Windows' default console window"，继续下一步。

安装结束时，无需勾选任何选项，点击"Finish"完成。

（3）安装 Node.js

按照提示，持续点击"下一步"即可完成安装。

（4）安装 Visual Studio

在安装界面勾选"使用 C++ 的桌面开发"选项。

（5）验证安装结果

以管理员身份打开 PowerShell：

右键点击 Windows 图标，选择"Windows PowerShell（管理员）"。

依次运行以下命令，检查安装结果：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
node -v
npm -v
git -v

---

2. 下载 OpenClaw

在刚刚打开的 PowerShell 窗口，执行如下命令：

npm install -g openclaw@latest

若出现安装回显，说明已成功安装。

---

3. 初始化配置 OpenClaw

（1）在命令行窗口执行：

openclaw onboard

（2）进行交互式配置

• 部署存在风险提示时，选择 "yes" 并回车
• 选择 "QuickStart" 并回车
• 选择模型供应商（如火山引擎），回车确认
• 输入火山引擎的 API Key，粘贴后回车即可
• 选择模型（如 volcengine-plan/ark-code-latest），可根据实际需求更改
• 对话工具配置暂时跳过，选择 "skip for now"
• Skills 配置暂时跳过，选择 "no"
• 日志和会话记录建议全部选上，通过方向键加空格选中，回车确认
• 等待 OpenClaw 的 Gateway 程序自动安装并打开浏览器网页

---

三、测试与设置开机自启动

安装完成后，可发送消息测试部署效果。

示例： 在桌面创建"hi.txt"文件，并返回存放路径

⚠️ 注意： 命令行窗口不可关闭，关闭后 OpenClaw 会停止运行。

AI 执行完毕后，可检查成果。

文件已成功创建，部署完成。

部署缺点： 每次重启需手动打开 PowerShell 并输入 openclaw gateway run 命令，否则无法访问控制台网页。

为解决此问题，已编写脚本实现开机自启动。

---

开机自启动操作步骤

设置前需要先关闭 OpenClaw 运行窗口

创建一个 txt 文件，将以下代码复制到 txt 文件中：

# 1. 自动提权
if (!([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
 Start-Process powershell.exe "-NoProfile -ExecutionPolicy Bypass -File `$PSCommandPath" -Verb RunAs
 exit
}

Write-Host "🔧 正在将 OpenClaw 注册为 Windows 服务..." -ForegroundColor Cyan

# ================= 配置区域 =================
$serviceName = "OpenClawGateway"
$nssmUrl = "https://nssm.cc/release/nssm-2.24.zip"
$nssmExe = "$env:TEMP\nssm\nssm-2.24\win64\nssm.exe"
$scriptPath = "C:\Users\$env:USERNAME\AppData\Roaming\npm\node_modules\openclaw\dist\index.js"
$logDir = "C:\OpenClaw\Logs"

# 下载 NSSM
Invoke-WebRequest -Uri $nssmUrl -OutFile "$env:TEMP\nssm.zip" -UseBasicParsing
Expand-Archive -Path "$env:TEMP\nssm.zip" -DestinationPath "$env:TEMP\nssm" -Force

# 安装服务
& $nssmExe install $serviceName node.exe "`"$scriptPath`" gateway --port 18789"
& $nssmExe set $serviceName AppDirectory "$userProfilePath"
& $nssmExe set $serviceName AppExit Default Restart

Start-Service -Name $serviceName
Write-Host "✅ 服务已启动！"

保存 txt 文件后，将后缀名由 .txt 修改为 .ps1。

右键文件，选择"使用 PowerShell 运行"，执行完成后即可实现开机自启动。

---

四、服务管理命令

# 停止服务
Stop-Service -Name 'OpenClawGateway'

# 启动服务
Start-Service -Name 'OpenClawGateway'

# 卸载服务
& 'nssm.exe' remove 'OpenClawGateway' confirm

---

部署完成！🎉

最后更新：2026-03-13