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

⚠️ 必须重启

命令执行完成后，Windows会提示需要重启，这一步不能跳过。

重启后Ubuntu会自动弹出初始化窗口，请不要关闭它。

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

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

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

Enter New Unix Username

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

密码输入说明

输入密码时屏幕不显示任何字符，这是Linux的正常安全机制，盲打输入后按回车即可。

密码设置成功后，会显示提示符：你的用户名@电脑名。

1.3 启用systemd（必须步骤）

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

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

wsl --shutdown

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

systemctl --user status

✅ 验证成功标志

显示State: running即表示systemd正常启用。

1.4 安装OpenClaw

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

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

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

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

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

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

向导提示	选择	说明
I understand this is personal-by-default...	Yes	安全声明确认，个人使用选Yes
QuickStart or Manual	Manual	需要手动配置API Key时选Manual
local gateway / remote gateway	local gateway	本机运行选local
workspace directory	直接回车	使用默认路径~/.openclaw/workspace
选择大模型	moonshot 或其他	根据你的API Key选择对应服务商
kimi code api key?	Yes	有Kimi Coding Key选Yes，之后选Paste API Key Now，紧接着输入API Key
default model	直接回车	使用默认模型
gateway bind	loopback	本机使用选loopback，最安全
gateway auth	Token	官方推荐，系统自动生成Token
TailScale exposure	off	不使用Tailscale选off
gateway token	直接回车并保存Token	系统生成
configure chat channels now?	No	后期随时可配置，到这步选择No
enable hooks?	No Skip for Now	先完成基础安装
install gateway service?	Yes	安装为后台服务，开机自动运行
gateway service runtime	node	选node，不选bun
how do you want to hatch your bot	open the web ui	用浏览器界面操作
enable bash shell completion?	Yes

1.6 访问Web UI控制台

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

openclaw dashboard

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

不要直接在浏览器URL中输入地址http://127.0.0.1:18789/，必须在终端执行命令OpenClaw Dashboard，得到带Token的完整链接。

1.7 安装后验证

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