如何在 Windows 上安装 OpenClaw

OpenClaw 是构建 AI 工作流的强大工具，但在 Windows 上进行设置对初学者来说可能会有些困惑。本指南将带你了解主要的安装方式，帮助你快速上手。

在开始介绍具体步骤之前，先来快速了解一下在 Windows 上安装 OpenClaw 的三种方式。每种方法在设置耗时、功能覆盖范围和技术要求上各有不同的取舍。

Kimi Claw 是一个在线工具，可让你在浏览器中运行 OpenClaw。它会自动完成设置和配置，因此你不需要安装 Node.js、配置 WSL 或设置 API 密钥。几分钟内即可开始使用一个可直接上手的智能体。

如果想在本地进行 PowerShell 或 WSL2 设置，请向下滚动查看方法一或方法二。如果想完全跳过本地安装，可直接跳转至方法三：Kimi Claw。如果想更快上手，也可以直接开始使用。

如果打算在本地安装 OpenClaw，请确保系统满足以下要求。如果选择像 Kimi Claw 这样的云端方案，可以完全跳过本节。

• Windows 10 或 Windows 11（64 位）

• 至少 4 GB 内存（推荐 8 GB，以保证 npm 构建稳定运行）

• 稳定的网络连接

• 如果选择 WSL2，初次设置需要管理员权限

• 使用 OpenClaw WSL2：必须在 BIOS/UEFI 中启用虚拟化

• Node.js 22.14 或更高版本。 OpenClaw 需要较新版本的 Node.js 运行环境。可从 nodejs.org 下载，或通过引导脚本安装。

• Git for Windows（可选，但建议安装）。部分 npm 包和技能依赖 Git。

与 WSL2 相比，PowerShell 方法所需步骤更少，也不需要 Linux 环境。只需一条命令即可下载 OpenClaw、检查 Node.js 版本并启动引导向导。此方法在 Windows 10 和 Windows 11 上均可使用。

出于系统安全考虑，Windows 默认限制脚本执行。在安装 OpenClaw 之前，你需要先运行以下这条“安全开关”命令，允许 PowerShell 执行本地脚本：

然后运行以下命令：

运行命令后，你应该会看到类似下图的输出。在继续进行引导设置之前，请关闭并重新打开 PowerShell，以刷新系统 PATH。

选择 Yes 以确认风险并继续。

接下来，选择 QuickStart 以快速开始引导设置。你之后可以再调整设置，或者选择 Manual 进行完整配置。

1. 选择 Moonshot AI 作为模型/身份验证提供方

1. 验证并配置你的 AI 模型

要连接 OpenClaw，请通过 Kimi 开放平台 激活你的 Kimi API Key。充值 5 美元可获得 5 美元的赠送额度，但我们建议充值 20 美元以上以解锁 Tier 2 权限。这样可以降低延迟，并确保你的 OpenClaw 智能体能够处理复杂的多步骤任务。

1. 创建 Kimi API key

进入 API Keys 页面，点击 Create API Key。请注意，你需要将 API Key 保存在安全且易于访问的地方，因为它只会在创建时显示一次。

1. 输入你的 API key 并选择默认模型

当引导向导提示你时，将你的专属 API key 粘贴到 PowerShell/终端窗口中。

当系统要求选择默认模型时，选择 moonshot/kimi-k2.5（如果它已经被高亮选中，也可以选择“Keep current”）。该模型在速度和推理能力之间提供了最佳平衡，非常适合处理智能体任务。

选择你想要连接到 OpenClaw 的应用。如果不确定，直接跳过即可。

点击 Yes 进行配置，或点击 No 跳过。

选择一种方式与你的机器人聊天，然后等待它启动运行。

完成以上所有步骤后，即可开始使用你的 OpenClaw。

OpenClaw WSL2 配置方式可在 Windows 内部提供一个完整的 Linux 环境，这是官方推荐的 OpenClaw 运行方式。这种方式让你能够使用完整的功能集，包括 systemd 守护进程管理、原生 shell 脚本支持，以及更流畅的 npm 构建过程。如果你打算在 Windows 上将 OpenClaw 用于日常工作流或开发，OpenClaw WSL 是最佳选择。

以管理员身份打开 PowerShell，并运行：

该命令会启用 WSL、下载 Ubuntu 并完成安装。完成后请重启计算机。Windows 重启后，Ubuntu 会自动启动，并要求你创建用户名和密码。

如果你已经安装了 WSL，可以按以下方式验证：

OpenClaw 使用 systemd 作为后台服务运行。请在 WSL 配置中启用它：

然后在 PowerShell 中重启 WSL：

重新打开 Ubuntu 终端，验证 systemd 是否正在运行：

输出应显示 systemd。如果显示的是 init，请检查你的 /etc/wsl.conf 文件。

OpenClaw 需要 Node.js 22.14 或更高版本。从 NodeSource 仓库安装：

验证安装：

Node.js 准备好后，全局安装 OpenClaw：

或者，使用官方安装脚本：

验证安装：

使用 daemon 参数运行引导向导，将 OpenClaw 设置为 systemd 服务：

向导将引导你完成以下操作：

• 选择你的 LLM 提供商并输入 API 密钥

• 选择默认模型

• 配置消息渠道（可选）

• 将网关安装为后台服务

引导完成后，启用服务持久化，使 OpenClaw 在 WSL 启动时自动运行：

网关是处理所有 OpenClaw 操作的核心后台服务，包括智能体请求、消息传递和模型执行。确保它正在运行，可以确认你的 OpenClaw 安装已完成并可以使用，同时避免后续步骤出现错误。

在 PowerShell 或 WSL 终端中运行以下命令以检查其状态：

如果管理 Node.js、WSL 和 API 密钥对你来说太麻烦，Kimi Claw 提供了一种更简单的方式来运行 OpenClaw。你可以直接在浏览器中运行 OpenClaw，无需本地设置或手动配置。按照以下步骤开始：

前往 Kimi Claw 页面，点击 创建 开始。

在弹出窗口中确认部署。Kimi Claw 会在大约两分钟内为你搭建好 OpenClaw 环境，包括网关、工作区和工具，无需运行任何命令或进行手动配置。

部署完成后，你的工作区会在仪表盘中打开。你可以直接在浏览器中与 AI 智能体聊天、设置技能、配置定时任务并管理文件。

• 零配置：无需管理 Node.js、WSL 或 API 密钥

• 40 GB 云存储：保存报告、数据集和生成的文件，可在不同会话间保留

• 持久记忆：你的 AI 智能体会记住过去的互动、偏好和上下文

• 5000+ 种 ClawHub 技能：即时使用自动化、研究、编程和分析技能

• 定时任务自动化：设置每日报告、提醒和监控等重复性任务

• 支持任意设备使用：在 Windows、Mac 或手机的任意浏览器中访问你的 OpenClaw 智能体

Kimi Claw 会在云服务器上自动处理安全和网络配置。如果你更倾向于使用 PowerShell 或 WSL2 在本地安装 OpenClaw，安装完成后建议配置以下几项安全设置。

• 配置 Windows 防火墙

OpenClaw 网关首次启动时，Windows 防火墙可能会提示你是否允许网络访问。请仅对专用网络允许访问。如果你使用的是 OpenClaw WSL2，网关运行在 Linux 环境中并通过 localhost 通信，通常无需额外的防火墙规则。

如果 Browser Relay 或其他功能无法连接，请确认第三方安全软件（如防病毒程序、VPN 客户端或企业防火墙）没有阻止 localhost 流量。

• 保护控制界面（Control UI）

OpenClaw 控制界面运行在端口 18789 上，可完全访问你的智能体。切勿将此端口暴露到公共互联网。请让网关始终绑定到 127.0.0.1，并仅从本机访问。

如需安全的远程访问，可使用 Tailscale 创建专用网络隧道：

这样可以让端口保持在 localhost 上，同时通过你的专用 Tailscale 网络进行访问。

即使按照清晰的指南操作，安装过程中仍可能遇到问题。以下是在 Windows 上安装 OpenClaw 时最常见的问题及其解决方法。

• 原因： npm 全局 bin 目录未加入系统 PATH。

• 解决方法： 运行以下命令查找你的 npm 前缀路径

将输出的路径添加到 Windows 环境变量中。不要在末尾追加 \\bin。然后关闭并重新打开 PowerShell。

• 原因： 未安装适用于 Windows 的 Git。

• 解决方法： 从 git-scm.com 下载并安装 Git。安装完成后，重启 PowerShell，然后重新运行 OpenClaw Windows 安装程序。

• 原因： 系统上的 Node.js 版本过旧，不满足最低要求（v22.14 及以上）。

• 解决方法： 从 nodejs.org 下载最新的 LTS 版本并安装。如果你使用的是 OpenClaw WSL2，请通过 NodeSource 仓库重新安装。

• 原因： PowerShell 权限不足，或 npm 全局目录不可写。

• 解决方法： 以管理员身份运行 PowerShell，或将 npm 全局前缀改为用户可写的目录

• 原因：端口 18789 已被占用，或配置文件已损坏。

• 解决方法： 检查是否存在冲突进程并重启

• 原因：/etc/wsl.conf 文件缺少 systemd 配置。

• 解决方法： 确认该文件包含正确的配置项

如果缺少该配置，请添加后在 PowerShell 中运行 wsl --shutdown 重启 WSL。

在 Windows 上安装 OpenClaw，既可以是简单的脚本化安装，也可以是更进阶的 WSL2 环境配置，具体取决于你的需求。如果你想要完全的控制权和灵活性，PowerShell 和 WSL2 都是不错的选择。如果你想跳过安装步骤直接开始使用，Kimi Claw 可以让你在浏览器中运行 OpenClaw，无需任何本地配置。根据自己的使用习惯和技术熟悉程度选择合适的方式，就能充分发挥 OpenClaw 的作用。