2026年4月29日 周三晚上19:30,来了解“企业AI训练师:从个人提效到构建企业AI生产力”(限30人)
免费POC, 零成本试错
AI知识库

53AI知识库

学习大模型的前沿技术与行业应用场景


我要投稿

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

发布日期:2026-04-26 11:05:11 浏览次数: 1531
作者:静水谭

微信搜一搜,关注“静水谭”

推荐语

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

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

杨芳贤
53AI创始人/腾讯云(TVP)最具价值专家

静水谭 | 外企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,并保存

  1. 首先开个 Kimi 会员套餐。

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

  1. 订阅后点控制台新建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


1.6  访问 Web UI 控制台

Web UI 就是把127开头连接放到浏览器,看到的用户习惯界面)

安装完成后,在 Ubuntu 终端执行:

openclaw dashboard

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

不要直接在浏览器URL中输入地址http://127.0.0.1:18789/

必须在终端执行命令 OpenClaw Dashboard, 得到带Token的完整连接


1.7  安装后验证

 在Ubuntu 终端中执行



----------------------------------


加入静水谭AI学习圈,可以享有几个权益

1. AI学习系列课程,目前更新9节,计划总共十节(若有新发展,随时再更新)


2. AI实战经验分享,包括提示词库,Skill,Agent创建等。我会把我正在用的、验证过的AI工作流,毫无保留地分享给你,目前的AI应用集中在以下几个领域。

  • ✅ 职场提效流简历优化、面试指导、PPT制作
  • ✅ 投资分析流:财报自动解析、估值计算、行业对比
  • ✅ 内容创作流:选题、写作、配图、排版一站式
  • ✅ 知识管理流:用NotebookLM建立个人知识库

你不需要从零摸索,直接拿我调好的提示词、搭好的工作流,改改就能用。

3. 回答大家在AI学习与应用上的问题

除了AI,还包括个人发展,自媒体创业咨询等。


如何加入:

下载星球,打码进入静水谭AI学习圈。

图片


53AI,企业落地大模型首选服务商

产品:场景落地咨询+大模型应用平台+行业解决方案

承诺:免费POC验证,效果达标后再合作。零风险落地应用大模型,已交付160+中大型企业

联系我们

售前咨询
186 6662 7370
预约演示
185 8882 0121

微信扫码

添加专属顾问

回到顶部

加载中...

扫码咨询