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

该脚本将:

  1. 下载最新的 OpenClaw 二进制文件
  2. 将其添加到系统 PATH
  3. ~/.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 dashboard

Windows 服务管理

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

下一步