OpenClaw 实操安装指南-30分钟手把手教程

OpenClaw安装不再头疼！这篇30分钟手把手教程帮你避开所有坑，轻松完成Windows系统下的安装部署。

核心内容：

1. Windows系统安装OpenClaw的必备前置条件与注意事项
2. WSL2+Ubuntu环境配置的详细步骤解析
3. Kimi API密钥获取与OpenClaw初始化实操指南

说实话，第一次在Windows上折腾OpenClaw，我花了足足6个多小时，各种报错排查到怀疑人生。这也是为什么「静水谭AI学习圈」创建了一个月，我一直不太想碰OpenClaw的安装教程。今天总算静下心来，把整个实操流程梳理了一遍，希望能帮你少走些弯路。

安装前说明

Windows下安装OpenClaw，比Mac系统要复杂得多，出错率也更高。根本原因在于OpenClaw的运行机制与Windows的文件管理、安全策略存在冲突。因此，官方推荐的安装方式是WSL方案——在Linux内核的虚拟环境里运行OpenClaw。

简单解释下WSL是什么：安装完OpenClaw后，它的所有相关文件都存放在Linux系统中。下面是我配置好的Linux环境。

安装前准备工作

• 卸载或关闭所有可能干扰的第三方软件，比如防病毒软件、电脑管家、远程控制工具等。
• 准备好Kimi API Key（API Key就像调用模型的钥匙，这里以Kimi模型为例）。

开通Kimi会员，新建API Key并保存

1. 先开通Kimi会员套餐。
2. 订阅成功后，进入控制台新建API Key。

注意：API Key只显示一次，务必复制保存到安全的地方，后面安装OpenClaw时会用到。

下面正式进入安装实操环节。

1.1 安装WSL2 + Ubuntu 24.04

打开开始菜单，按Windows键+S，搜索PowerShell，右键选择「以管理员身份运行」，然后执行：

wsl --install -d Ubuntu-24.04

解释一下「Ubuntu终端」：这是以后运行OpenClaw指令的地方。比如想打开OpenClaw Dashboard（就是那个符合我们浏览习惯的网页界面），就需要在Ubuntu上执行相应命令。

1.2 Ubuntu初始化：设置用户名和密码

重启后Ubuntu自动打开，显示正在安装。稍等几分钟后会提示：

Enter New Unix Username

输入用户名（全小写字母，例如qfy），按回车。然后设置密码：

1.3 启用systemd（必须步骤）

在Ubuntu终端里执行命令（打开Ubuntu终端的方法：Windows键+S，输入Ubuntu，以管理员身份运行）。粘贴命令时，使用鼠标右键粘贴，不要用Ctrl+V。

输入密码后（屏幕不显示），执行成功没有任何输出。然后重启WSL：再次打开Ubuntu，另外打开一个普通PowerShell（不需要管理员），执行：

wsl --shutdown

重新打开Ubuntu，出现提示符后，验证systemd是否正常：

systemctl --user status

1.4 安装OpenClaw

在Ubuntu终端执行官方一键安装脚本：

脚本会自动处理Node.js 22安装、Git安装、OpenClaw安装，完成后自动进入引导向导。整个过程大约5~10分钟。

如果安装中报错，不要慌张——关闭窗口，重新打开Ubuntu终端，再输入命令。程序会从中断的地方继续运行。

自动安装完毕后，会进入向导界面，提示"I understand this is personal-by-default"。

1.5 引导向导：逐项选择说明

安装完成后自动进入交互向导，以下是每一步的正确选项：

1.6 访问Web UI控制台

安装完成后，在Ubuntu终端执行：

openclaw dashboard

终端会输出一个带Token的完整链接：

1.7 安装后验证

在Ubuntu终端中执行相关命令，确认一切运行正常即可。