Windows部署OpenClaw指南（推荐使用国内镜像脚本）

在Windows上本地部署OpenClaw，主要有一键安装、手动安装和使用桌面管理器三种方式。其中，一键安装是最简单快捷的，非常适合新手。整理了不同安装方式的对比，可以根据自己的情况选择：

部署方式	推荐指数	优点	缺点	适合人群
一键安装 (推荐)	⭐⭐⭐	自动化程度高，只需复制粘贴一条命令，无需手动配置复杂环境。	需要网络能访问GitHub，且必须以管理员身份运行PowerShell。	所有用户，特别是零基础新手。
手动安装 (npm)	⭐⭐	安装过程更可控，可以精确指定版本。	需要预先手动安装Node.js环境，步骤稍多。	对命令行有一定了解，希望控制安装过程的用户。
OpenClaw Manager	⭐⭐	有图形界面，全程鼠标点击操作，最直观。	需要多一步下载安装器的步骤。	不习惯使用命令行的用户。

🚀 方法一：一键安装（最推荐）

这是官方为Windows用户准备的"傻瓜式"安装方法，整个过程几乎是自动化的。

1. 准备工作

系统要求 ：确保你的电脑是 Windows 10 (2004版本以上) 或 Windows 11，并已连接到互联网。
开启管理员权限 ：在任务栏搜索 PowerShell，右键点击并选择 "以管理员身份运行"。

2. 执行安装命令

在打开的管理员PowerShell窗口中，复制粘贴以下命令，然后按回车键：
powershell

复制代码

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

如果遇到网络问题，可以尝试使用国内镜像脚本：
powershell

复制代码

iwr -useb https://clawd.org.cn/install.ps1 | iex

3. 跟随向导配置

安装脚本运行后，会出现一个交互式的配置向导。你只需要根据提示，用键盘的方向键 和回车键进行选择和确认：

安全警告 ：选择 Yes，确认你了解风险。
安装模式 ：选择 QuickStart（快速开始）。
选择AI模型 ：这里最关键。如果你追求数据绝对隐私，想运行本地模型，可以选择 Ollama；如果图省事，推荐先选 OpenAI 或 DeepSeek 并输入你的API Key。
配置API Key：如果上一步选择了云端模型，程序会提示你输入API Key。你需要提前在对应官网（如OpenAI或Google AI Studio）注册并获取。
后续选项 ：关于配置通讯渠道（如飞书）和安装技能包（Skills），新手建议先选择 "Skip for now" 或 "No"，等熟悉基本操作后再慢慢探索。

4. 完成安装

当看到 Installation complete! 的提示，并显示一个类似 http://localhost:3000 或 http://127.0.0.1:18789 的地址时，就说明安装成功了。

用浏览器打开这个地址，就能看到OpenClaw的Web控制面板。在这里，你就可以开始和你的AI助手对话了！

🛠️ 方法二：手动安装 (使用npm)

如果你想对安装过程有更多控制，或者自动安装脚本运行失败，可以试试这个方法。

1. 安装Node.js

访问 Node.js官网，下载并安装 LTS（长期支持版） ，建议版本 18.0.0 或更高 。安装时请务必勾选"Add to PATH"选项。

2. 安装OpenClaw

同样，用管理员身份打开PowerShell。
执行以下命令，全局安装OpenClaw：

powershell
复制代码
```
npm install -g openclaw
```

3. 验证安装

安装完成后，输入以下命令查看版本号，如果正常显示，则说明安装成功。

powershell
复制代码
```
openclaw --version
```

4. 运行配置向导

继续在PowerShell中输入以下命令，启动配置向导，然后按照方法一中的步骤3进行配置即可。

powershell
复制代码
```
openclaw onboard
```

🖥️ 方法三：使用桌面管理器

如果你对命令行实在感到陌生，可以试试官方提供的图形化工具。

访问OpenClaw桌面管理器的GitHub发布页面：https://github.com/miaoxworld/openclaw-manager/releases。
下载最新的 OpenClaw-Manager-Windows-setup.exe 文件。
双击安装，然后打开软件，点击界面上的 "安装 OpenClaw" 按钮，剩下的步骤就可以用鼠标点点点来完成了。

📝 安装后常用命令

无论用哪种方式安装，掌握几个简单的命令都能让你更好地管理OpenClaw。在PowerShell中直接输入即可：

检查状态 ：openclaw doctor (检查环境是否有问题)
启动服务 ：openclaw gateway start (让AI助手在后台运行)
查看服务状态 ：openclaw gateway status
打开控制面板 ：openclaw dashboard (会自动在浏览器中打开管理界面)
查看实时日志 ：openclaw logs follow (出问题时，看日志是定位问题最有效的方法)
重新配置 ：openclaw onboard (如果想更换AI模型或添加新功能，可以重新运行配置向导)

❗ 常见问题与解决

安装失败，提示"无法加载文件..."或"执行策略"错误 ：

这通常是PowerShell的执行策略限制导致的。在管理员PowerShell中先运行以下命令即可解决：

powershell
复制代码
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
运行命令后提示"openclaw: command not found" ：

这表示Node.js的全局模块安装路径没有添加到系统的环境变量（PATH）中。可以重启PowerShell试试，如果还不行，可能需要手动将 C:\Users\你的用户名\AppData\Roaming\npm 这个路径添加到系统环境变量中。

安装成功了！ 🎉

有一些警告信息，但核心是 "OpenClaw installed successfully"。现在需要修复配置文件的问题。

🔧 立即修复配置文件

方案一：使用自动修复命令

powershell

复制代码

# 运行医生命令自动修复
openclaw-cn doctor --fix

# 或者试试
openclaw doctor --fix

方案二：手动初始化配置

powershell

复制代码

# 重新运行配置向导
openclaw-cn onboard

# 或者
openclaw onboard

按照提示：

选择 QuickStart
选择AI模型（推荐先选 OpenAI 或 DeepSeek）
输入对应的 API Key
其他选项可以先跳过

方案三：手动修复配置文件

如果自动修复不行，直接删除配置文件重新生成：
powershell

复制代码

# 备份并删除旧配置
Move-Item C:\Users\HP\.openclaw\openclaw.json C:\Users\HP\.openclaw\openclaw.json.bak -ErrorAction SilentlyContinue

# 重新运行配置向导
openclaw-cn onboard

🚀 验证安装

修复后，验证是否正常工作：
powershell

复制代码

# 查看版本
openclaw-cn --version

# 查看状态
openclaw-cn status

# 启动Web面板
openclaw-cn dashboard

💡 如果命令找不到

试试这些别名：
powershell

复制代码

# 可能安装的是 openclaw 而不是 openclaw-cn
openclaw --version

# 或者用完整路径
C:\Users\用户\AppData\Roaming\npm\openclaw-cn.cmd --version
C:\Users\用户\AppData\Roaming\npm\openclaw.cmd --version

🎯 启动Web面板

一旦命令可用，启动面板：
powershell

复制代码

# 启动Web UI
openclaw-cn dashboard

# 或者
openclaw dashboard

浏览器会自动打开 http://localhost:18789

如果需要登录令牌：
powershell

复制代码

openclaw-cn token generate

📊 后续使用命令

powershell

复制代码

# 查看网关状态
openclaw-cn gateway status

# 启动网关（如果没自动启动）
openclaw-cn gateway start

# 查看日志
openclaw-cn logs follow

# 安装技能（后续）
openclaw-cn skills install skill-vetter
openclaw-cn skills install search-web