安装 OpenClaw 全网最详细流程与步骤,新手必备(一键脚本安装)

在Windows上安装OpenClaw主要有两种主流且可靠的方式：一键脚本安装（适合大多数用户）和结合WSL的安装（官方推荐，环境更兼容）。同时，也有一个较新的原生安装方式可供选择。

下面为你梳理了这三种方式的详细流程和步骤。

⚠️ 重要提示：安全第一

OpenClaw是一个具有系统操作权限的AI代理工具。在开始前，有两点非常重要的提醒：

风险意识：该工具可能会被授权访问你的账号、信息甚至系统，使用时请自行承担风险。

环境隔离：如果你的电脑存有重要资料，强烈建议在备用设备、虚拟机或云服务器（VPS）上运行，以保护隐私安全。

🚀 方式一：一键脚本安装（最常用，适合新手）

这是目前Windows上最简单、最快捷的安装方法，整个流程主要通过Powerhell命令行完成。

📋 1. 准备工作

操作系统：Windows 10 或 11（64位）。

网络：能够访问GitHub以下载安装脚本。

权限：需要使用管理员身份运行PowerShell。

⚙️ 2. 详细安装步骤

以管理员身份打开PowerShell：右键点击开始菜单或按Win + X，选择 “Windows PowerShell (管理员)” 或 “终端(管理员)”。

（可选）解锁执行策略：为了防止首次运行脚本时报错，可以先执行以下命令：

Set-ExecutionPolicy Bypass -Scope Process-Force

运行一键安装命令：在PowerShell中复制粘贴以下命令并回车：

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

如果下载缓慢，可以尝试使用国内镜像源：

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

跟随安装向导：脚本运行后，会进入交互式配置流程，你需要根据提示做出选择：

完成与验证：

🐧 方式二：WSL 2 安装（官方推荐，环境更纯净）

OpenClaw主要为类Unix环境设计，在Windows上通过WSL 2运行是官方推荐的方案，能获得更好的兼容性和稳定性。

📋 1. 准备工作

操作系统：Windows 10 2004+ 或 Windows 11。

开启虚拟化：需要在BIOS中启用VT-x/AMD-V。

⚙️ 2. 详细安装步骤

以管理员身份打开PowerShell，安装WSL 2和Ubuntu系统：

wsl --install -d Ubuntu-22.04wsl --set-default-version 2

安装完成后，按提示重启电脑。

进入WSL环境：重启后，打开PowerShell或CMD，输入wsl命令，即可进入Ubuntu命令行界面。

在WSL中安装OpenClaw：在Ubuntu的终端中，执行Linux安装命令：

curl-fsSL https：//openclaw.ai/install.sh |bash

完成初始化配置：安装脚本会自动启动向导，其后续的配置选项（选择模型、输入API Key等）与方式一中的步骤4完全相同。

访问控制台：配置完成后，OpenClaw服务会在WSL内启动。你可以在Windows的浏览器中直接访问http：//127.0.0.1：18789来使用控制面板。

🖥️ 方式三：原生安装（2026年新方式，无需WSL）

根据最新的教程，目前OpenClaw对Windows原生的支持已有改善，无需WSL也能较流畅地运行。

📋 1. 准备工作

操作系统：Windows 11 （build 26200+） 或 Windows 10。

内存：建议≥8GB。

权限：需要管理员身份运行PowerShell。

⚙️ 2. 详细安装步骤

以管理员身份打开PowerShell。

解锁执行策略（同上文方式一）：

Set-ExecutionPolicy Bypass -Scope Process-Force

安装OpenClaw Beta版（推荐使用最新稳定版）：

& （[scriptblock]：：Create（（iwr-useb https：//openclaw.ai/install.ps1））） -Tag beta

配置Gateway模式：安装完成后，需要手动将Gateway设置为本地模式：

openclaw config set gateway.mode local

安装并启动Gateway服务：

openclaw gateway installopenclaw gateway start

验证与访问：

🔧 常用命令与排错

无论哪种方式安装，以下命令都非常实用：

健康检查：openclaw doctor全面检查环境与配置。

查看状态：openclaw gateway status查看核心服务是否运行。

打开面板：openclaw dashboard在浏览器中打开控制台。

实时日志：openclaw logs follow查看日志，定位错误时非常有用。

重启服务：openclaw gateway restart刷新机器人状态。

如果遇到问题怎么办？

“openclaw”命令找不到：关闭当前PowerShell，重新用管理员权限打开一个，让环境变量刷新。

Node.js版本问题：一键安装脚本通常会自动处理，如果手动安装失败，可以去官网下载Node.js 22+ LTS版本。

端口被占用：使用netstat -ano | findstr ：18789找到占用端口的进程并结束它。

💡 下一步：接入飞书

安装成功后，你可以通过以下步骤将OpenClaw接入飞书，在聊天软件中使用它：

在OpenClaw控制台或命令行中安装飞书插件：openclaw plugins install @m1heng-clawd/feishu。

前往飞书开放平台，创建一个企业自建应用，获取App ID和App Secret。

在飞书应用的“权限管理”中，使用官方提供的JSON配置批量导入所需权限。

在“事件与订阅”中，配置订阅方式为“使用长连接接收事件”，并添加im.message.receive_v1事件。

发布应用版本，然后在飞书中找到机器人，发送消息获取配对码，最后在OpenClaw Web UI中绑定即可。

希望这份指南能帮你顺利在Windows上安装OpenClaw！如果在某个步骤遇到问题，随时可以再来问我。