乐于分享
好东西不私藏

OpenClaw 保姆级安装教程:从 0 到成功启动,零基础也能学会

OpenClaw 保姆级安装教程:从 0 到成功启动,零基础也能学会

很多朋友第一次接触 OpenClaw,最头疼的不是功能,而是安装。

看到 Node.js、npm、命令行、新手引导这些词,第一反应就是:

我不会编程,能装好吗?

这些命令看起来好复杂。

每一步到底该怎么选?

其实不用慌。

这篇文章就是写给新手小白的。你不用懂代码,只要跟着步骤一步一步操作,就能把 OpenClaw 安装好,并成功打开控制界面。

截至 2026 年 3 月 21 日,OpenClaw 官方文档要求 Node.js 22 或更高版本。对新手来说,最稳妥的做法,就是先安装 Node.js 官网提供的 LTS 长期支持版,然后再用 npm 安装 OpenClaw。

一、安装前先知道:OpenClaw 需要什么环境?

安装 OpenClaw 之前,你的电脑里需要先有一个运行环境,名字叫 Node.js。

你可以把它理解成:

OpenClaw 运行所需要的基础环境。

如果没有 Node.js,后面的安装命令就没法正常执行。

二、第一步:下载并安装 Node.js

先打开 Node.js 中文官网下载页:

https://nodejs.org/zh-cn/download

进入页面后,新手记住一句话就够了:

优先下载 LTS 版本。

为什么推荐 LTS?

第一,更稳定。

第二,更适合日常使用。

第三,和大多数教程兼容性更好。

下载完成后,双击安装包,按默认设置一路点击:

下一步 → 同意 → 安装 → 完成

一般不需要改安装路径,保持默认即可。

三、第二步:检查 Node.js 和 npm 是否安装成功

Node.js 安装完成后,打开终端。

如果你是 Windows 用户,可以打开“命令提示符”或“PowerShell”。

如果你是 macOS 或 Linux 用户,打开“终端”即可。

然后输入下面两条命令:

这条命令的意思其实很简单:

node -v
npm -v

如果出现数据,那么表示你node安装成功

五、第四步:安装运行 OpenClaw 新手引导

npm install -g openclaw@latest

npm install:安装软件包

-g:全局安装

openclaw@latest:安装最新版 OpenClaw

也就是说,这一步是在把最新版 OpenClaw 安装到你的电脑里。

安装完成后,再执行下面这条命令确认一下:

openclaw --version

如果这里能正常显示版本号,就说明 OpenClaw 已经安装成功了。

接下来进入最关键的一步。

在终端输入:

openclaw onboard --install-daemon

输入以后进入到这个页面

"I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?"
(我明白这默认是个人使用的,共享/多用户使用需要进行安全加固。是否继续?)

方向键 选择Yes后,回车

QuickStart(快速启动),直接回车进行下一步

这里选择OpenRouter,直接回车进行下一步

直接回车进入下一步

OpenRouter API key怎么免费申请 xiaomi mimo api key,上一篇文章大家可以去看一下呢,输入API key 以后回车

这里一直下滑,直到看到xiaomi的时候 回车下一步

到这里直接方向键按 上 看到Skip for now,然后按回车继续

这一步也是一样,选择Skip for now + 回车

这一步 再问 要不要现在给这个 AI 增加一些“技能” ,先选择NO 输入回车
这一步需要注意,请使用空格 选中Skip for now 然后在按回车

到这一步,选择 Open the Web UI 后回车就行

这个时候浏览器会自动打开你的 OpenClaw,说明已经安装成功了

六、第五步:整套安装命令汇总

如果你想把最核心的命令保存下来,可以直接收藏这一段:

node -v

npm -v

npm install -g openclaw@latest

openclaw --version

openclaw onboard --install-daemon

七、第六步:新手最常见的几个问题

node -v 没有显示版本号怎么办?

先关闭终端,再重新打开一次。

如果还是不行,通常说明 Node.js 没有安装成功,需要重新安装。

openclaw --version 提示找不到命令怎么办?

这通常说明 OpenClaw 没有正确安装完成。

重新执行一次:

npm install -g openclaw@latest

然后再执行:

openclaw --version

或者执行一次:

sudo npm install -g openclaw@latest

新手引导里模型不会选怎么办?

最简单的办法就是:

先选 Skip,把程序先装起来。

Dashboard 打不开怎么办?

按这个顺序排查:

openclaw gateway status

openclaw gateway start

openclaw dashboard

如果还不行,再检查本地端口是否被占用,或者认证配置是否完成。

八、最后总结

如果你是第一次接触 OpenClaw,不需要一上来就把所有功能研究透。

你只要先完成这四件事:

第一,安装 Node.js。

第二,安装 OpenClaw。

第三,跑完新手引导。

第四,打开 Dashboard。

只要这四步走通了,后面像模型配置、渠道接入、远程访问这些功能,都可以慢慢加。

对于小白来说,先装上、先跑起来、先看到界面,比什么都重要。

如果你正在准备第一次安装,建议先把这篇文章收藏起来,按顺序一步一步操作,成功率会高很多。

文末引导语:

如果你还想看 OpenClaw 的模型配置教程、渠道接入教程,留言告诉我,我继续整理。

如果这篇文章对你有帮助,记得点个赞和在看,后面继续更新 OpenClaw 实战教程。