OpenClaw Windows 部署手册：PowerShell 安装与验证

标签： OpenClaw、Windows、AI Agent、Gateway、部署

OpenClaw 是一个 AI Agent Gateway，支持 CLI 管理、Gateway 常驻服务、Control UI 和多种消息渠道接入。Windows 用户可通过 PowerShell 一键安装脚本、npm 全局安装 或 Windows Hub 桌面应用 完成部署。

本文整理 Windows 环境下的系统要求、安装步骤、服务配置与常见问题排查。

一、系统要求

项目	要求
操作系统	Windows 10/11（原生 Windows 或 WSL2）
Node.js	24（推荐）或 22.19+
包管理器	npm / pnpm / bun（手动安装时）
权限	PowerShell 执行策略允许运行安装脚本

说明： 官方也支持 WSL2 部署，隔离性更好。若追求稳定生产环境，可参考 Linux 部署文档在 WSL2 内安装。

二、方式一：PowerShell 一键安装（推荐）

以 管理员或普通用户 PowerShell 执行：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装脚本会自动：

检测操作系统
安装 Node（如缺失）
安装 OpenClaw CLI
启动交互式 onboarding

跳过 onboarding（CI/自动化场景）

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

三、方式二：npm 全局安装

若已自行管理 Node 环境：

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm 安装

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun 安装

bun add -g openclaw@latest
openclaw onboard --install-daemon

四、方式三：Windows Hub 桌面应用

Windows 桌面用户可安装 OpenClaw Hub 原生应用，包含：

图形化 setup 向导
系统托盘状态
本地 Chat
Node 模式
本地 MCP 模式

适合不想使用命令行的个人用户。

五、安装后配置（onboarding）

运行 onboarding 向导：

openclaw onboard --install-daemon

向导会引导你：

配置 AI Provider API Key（OpenAI、Anthropic 等）
设置 Gateway 模式
安装后台守护进程

Windows 守护进程

优先创建 Scheduled Task（计划任务）
若任务创建失败，回退到 启动文件夹登录项

六、验证安装

openclaw --version
openclaw doctor
openclaw gateway status

打开 Control UI

Gateway 默认端口 18789，浏览器访问：

http://127.0.0.1:18789/

首次进入需在 Settings 中粘贴 Gateway Token（onboarding 时生成）。

七、常用命令

# 查看 Gateway 状态
openclaw gateway status

# 启动 Gateway
openclaw gateway start

# 停止 Gateway
openclaw gateway stop

# 健康检查
openclaw doctor

# 更新到最新版
openclaw update --channel stable

八、从源码安装（开发者）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

九、常见问题

1）安装后找不到 openclaw 命令

检查 Node 全局 bin 是否在 PATH：

node -v
npm prefix -g

将 $(npm prefix -g) 下的路径加入系统环境变量 PATH，重启终端。

2）Gateway 无法启动

openclaw doctor
openclaw gateway status

检查端口 18789 是否被占用，API Key 是否配置正确。

3）Control UI 提示 Unauthorized

重新获取 dashboard 链接：

openclaw dashboard --no-open

在 Settings 中粘贴正确的 Gateway Token。

4）Windows 原生 vs WSL2 怎么选？

原生 Windows：适合个人本地快速体验、Hub 桌面应用
WSL2：更接近 Linux 生产环境，适合开发者和长期运行

十、卸载

npm uninstall -g openclaw

并删除配置目录（默认在用户目录下 .openclaw），以及计划任务/启动项。

十一、结语

Windows 部署 OpenClaw 最快的方式是 PowerShell 一键脚本。生产或 VPS 场景建议参考 Linux 部署手册，使用 Docker / Docker Compose 获得更好隔离性。

官方文档：https://docs.openclaw.ai/install

如果这篇文章对你有帮助，欢迎点赞、收藏、关注，有问题可以在评论区交流。

posted @ 2026-06-24 10:59 鹿聚GEO 阅读(2) 评论(0) 收藏举报

刷新页面返回顶部

鹿聚GEO

OpenClaw Windows 部署手册：PowerShell 安装与验证