很多朋友第一次接触 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 -vnpm -v
如果出现数据,那么表示你node安装成功
五、第四步:安装运行 OpenClaw 新手引导
npm install -g openclaw@latestnpm install:安装软件包
-g:全局安装
openclaw@latest:安装最新版 OpenClaw
也就是说,这一步是在把最新版 OpenClaw 安装到你的电脑里。

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

如果这里能正常显示版本号,就说明 OpenClaw 已经安装成功了。
接下来进入最关键的一步。
在终端输入:
openclaw onboard --install-daemon
输入以后进入到这个页面

方向键 选择Yes后,回车

QuickStart(快速启动),直接回车进行下一步
这里选择OpenRouter,直接回车进行下一步


直接回车进入下一步

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

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

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


这一步也是一样,选择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 实战教程。
夜雨聆风