当前位置：首页 > news >正文

Windows部署OpenClaw指南

news 2026/3/27 6:04:35

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

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

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

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

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

如果遇到网络问题，可以尝试使用国内镜像脚本：
powershell
iwr -useb https://clawd.org.cn/install.ps1 | iex

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

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

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

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

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

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

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

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

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

安装失败，提示“无法加载文件...”或“执行策略”错误：
这通常是PowerShell的执行策略限制导致的。在管理员PowerShell中先运行以下命令即可解决：
powershell
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
运行命令后提示“openclaw: command not found”：
这表示Node.js的全局模块安装路径没有添加到系统的环境变量（PATH）中。可以重启PowerShell试试，如果还不行，可能需要手动将 C:\Users\你的用户名\AppData\Roaming\npm 这个路径添加到系统环境变量中。