Windows 安装
使用 PowerShell 或 npm 在 Windows 上安装 OpenClaw 的分步指南。
前置条件
- Windows 10/11(64 位)
- Node.js 22+ — 从 nodejs.org 下载
- PowerShell 5.1+(Windows 10/11 自带)
验证 Node.js 已安装:
node --version
# 期望输出:v22.x.x 或更高方法 1:PowerShell 安装脚本(推荐)
以管理员身份打开 PowerShell 并运行:
iwr -useb https://openclaw.ai/install.ps1 | iex该脚本将:
- 下载最新的 OpenClaw 二进制文件
- 将其添加到系统 PATH
- 在
~/.openclaw/创建配置目录
方法 2:npm 全局安装
npm install -g openclaw@latest验证安装:
openclaw --version初始设置
运行引导向导:
openclaw onboard --install-daemon向导将引导你完成:
- 选择 AI 提供商(OpenAI、Claude、Ollama 等)
- 输入 API 密钥
- 选择渠道(WhatsApp、Telegram 等)
- 安装 Windows 服务
验证
# 检查 Gateway 状态
openclaw gateway status
# 打开控制面板
openclaw dashboardWindows 服务管理
OpenClaw 作为 Windows 服务安装。你可以通过以下方式管理:
# 启动服务
openclaw service start
# 停止服务
openclaw service stop
# 检查服务状态
openclaw service status配置
配置文件位于:
%USERPROFILE%\.openclaw\openclaw.json可以使用任何文本编辑器编辑,或通过控制面板 http://127.0.0.1:18789/ 修改。
故障排除
Node.js 未找到
确保 Node.js 在你的 PATH 中。安装后重启 PowerShell。
权限被拒绝
以管理员身份运行 PowerShell 进行安装。
端口被占用
更改 Gateway 端口:
openclaw gateway --port 18790