微信扫码
添加专属顾问
我要投稿
OpenClaw安装不再头疼!这篇30分钟手把手教程帮你避开所有坑,轻松完成Windows系统下的安装部署。 核心内容: 1. Windows系统安装OpenClaw的必备前置条件与注意事项 2. WSL2+Ubuntu环境配置的详细步骤解析 3. Kimi API密钥获取与OpenClaw初始化实操指南
Windows下安装openclaw,会比在Mac下安装复杂、出错率高些。因为openclaw的运营机制与windows的文件管理、安全管理冲突。所以选择的安装方式,是官方首推的WSL方式,在一个linux内核的虚拟环境里安装openclaw。
术语解释:什么是WSL?
卸载或关闭防病毒软件、电脑管家、远程控制等可能干扰的第三方软件
准备好 Kimi API Key (API Key就像调用某个模型的钥匙,我用的是kimi 模型,所以用它举例)
首先开个 Kimi 会员套餐。
https://www.kimi.com/membership/pricing
订阅后点控制台新建API key
https://www.kimi.com/code/console
注意:API key只显示一次,复制保存到安全的地方,后面安装Openclaw时要用。
下面是具体安装实操:
打开开始菜单,windows键+S,搜索 PowerShell,右键选择「以管理员身份运行」,执行:
PowerShell(管理员)
打开后,输入并执行 wsl --install -d Ubuntu-24.04
⚠️ 必须重启 |
命令执行完成后,Windows 会提示需要重启,必须重启才能继续。 |
重启后 Ubuntu 会自动弹出初始化窗口,请不要关闭它。 |
术语解释:Ubuntu 终端
它是以后要运行Openclaw 指令的地方。例如如我们想打开Openclaw Dashboard,也就是网页端,符合我们看网页习惯的界面,需要在Ubuntu上运行 Openclaw Dashboard
重启后 Ubuntu 自动打开,显示正在安装,稍等几分钟后会提示:
Ubuntu 提示
Enter New Unix Username 输入用户名(全小写字母,例如 qfy),按回车。然后设置密码, Ubuntu 提示 (输入密码)
密码输入说明 |
输入密码时屏幕不显示任何字符,这是正常的 Linux 安全机制,盲打输入后按回车即可。 |
密码设置成功后会显示提示符:你的用户名@电脑名 |
在 Ubuntu 终端里执行,打开Ubuntu 终端 (Windows键+S,然后输入Ubuntu,用管理员身份)粘贴下面命令,使用鼠标右键粘贴,不要用Ctrl+V。
输入密码后(屏幕不显示),执行成功无任何输出。然后重启 WSL(再次打开Ubuntu),另外打开一个普通 PowerShell(不需要管理员),执行:
wsl --shutdown
重新打开 Ubuntu,出现提示符后,验证 systemd 是否正常:
systemctl --user status
✅ 验证成功标志 |
显示 State: running 即表示 systemd 正常启用。 |
在 Ubuntu 终端执行官方一键安装脚本:
脚本自动处理 Node.js 22 安装、Git 安装、OpenClaw 安装,完成后自动进入引导向导。过程约 5~10 分钟。
如果安装中报错,不要紧张,关闭窗口,然后重新打开Ubuntu终端,再输入
重新运行后,程序会从中断的地方继续运行
当自动安装完毕,会到 I understand this is personal-by-default
安装完成后自动进入交互向导,以下是每一步的正确选项:
向导提示 | 选择 | 说明 |
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 |
(Web UI 就是把127开头连接放到浏览器,看到的用户习惯界面)
安装完成后,在 Ubuntu 终端执行:
openclaw dashboard
终端会输出一个带 Token 的完整链接:
不要直接在浏览器URL中输入地址http://127.0.0.1:18789/ 必须在终端执行命令 OpenClaw Dashboard, 得到带Token的完整连接 |
在Ubuntu 终端中执行
----------------------------------
1. AI学习系列课程,目前更新9节,计划总共十节(若有新发展,随时再更新)
2. AI实战经验分享,包括提示词库,Skill,Agent创建等。我会把我正在用的、验证过的AI工作流,毫无保留地分享给你,目前的AI应用集中在以下几个领域。
你不需要从零摸索,直接拿我调好的提示词、搭好的工作流,改改就能用。
3. 回答大家在AI学习与应用上的问题
除了AI,还包括个人发展,自媒体创业咨询等。
53AI,企业落地大模型首选服务商
产品:场景落地咨询+大模型应用平台+行业解决方案
承诺:免费POC验证,效果达标后再合作。零风险落地应用大模型,已交付160+中大型企业
2026-05-10
家用Linux系统OpenClaw部署保姆级教程
2026-05-07
OpenAI 联动OpenClaw 大升级,养虾党这次真要起飞了!
2026-05-03
OpenClaw发布 v2026.5.2 版本🦞
2026-04-29
OpenClaw的记忆系统,用在企业场景还是太粗糙了
2026-04-28
微信开始支持 Markdown 显示
2026-04-28
OpenClaw Node:让OpenClaw控制更多设备
2026-04-27
OpenClaw创始人发布Summarize 0.14.0新版本
2026-04-26
OpenClaw最新版本(4.24)发布:支持语音通话了
2026-03-03
2026-02-17
2026-03-05
2026-03-09
2026-02-10
2026-02-16
2026-03-09
2026-03-08
2026-02-28
2026-02-27
2026-04-09
2026-04-07
2026-04-02
2026-03-30
2026-03-30
2026-03-26
2026-03-24
2026-03-24