OpenClaw 实操部署指南-30分钟手把手教程

静水谭 | 外企13年采购数字化 | AI布道师 | 多维度收入探索实践人
欢迎点赞、收藏与转发，但请备注出处

第一次在Window 安装OpenClaw时，用了6个多小时，各种排查问题到晕，所以静水谭AI学习圈虽创建一个月了，我一直不想再碰Openclaw的安装，今天总算能静心把安装实操缕了一遍，供大家一步步实操。

视频版会在知识星球静水谭AI学习圈中提供。

安装前说明：

Windows下安装openclaw，会比在Mac下安装复杂、出错率高些。因为openclaw的运营机制与windows的文件管理、安全管理冲突。所以选择的安装方式，是官方首推的WSL方式，在一个linux内核的虚拟环境里安装openclaw。

术语解释：什么是WSL？

安装Openclaw后，Openclaw相关文件都存在Linux中。下面是我的Lunux环境。

安装前准备工作：

卸载或关闭防病毒软件、电脑管家、远程控制等可能干扰的第三方软件
准备好 Kimi API Key （API Key就像调用某个模型的钥匙，我用的是kimi 模型，所以用它举例）

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

首先开个 Kimi 会员套餐。

https://www.kimi.com/membership/pricing

订阅后点控制台新建API key

https://www.kimi.com/code/console

注意：API key只显示一次，复制保存到安全的地方，后面安装Openclaw时要用。

下面是具体安装实操：

1.1 安装 WSL2 + Ubuntu 24.04

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

PowerShell（管理员）

打开后，输入并执行 wsl --install -d Ubuntu-24.04

⚠️ 必须重启

命令执行完成后，Windows 会提示需要重启，必须重启才能继续。

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

术语解释：Ubuntu 终端

它是以后要运行Openclaw 指令的地方。例如如我们想打开Openclaw Dashboard，也就是网页端，符合我们看网页习惯的界面，需要在Ubuntu上运行 Openclaw Dashboard

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

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

Ubuntu 提示

Enter New Unix Username 输入用户名（全小写字母，例如 qfy），按回车。然后设置密码, Ubuntu 提示（输入密码）

密码输入说明

输入密码时屏幕不显示任何字符，这是正常的 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