OpenClaw 安装教程:新手从零开始的上手说明

OpenClaw 怎么安装?本文整理官方推荐的安装思路、前置准备、首次启动方式、常见报错与新手注意事项,适合第一次接触 OpenClaw 的用户。

这篇文章适合谁?

如果你第一次接触 OpenClaw,想先把它跑起来,而不是一上来就看一堆零散论坛帖子,这篇更适合你。官方目前已经给出 Getting Started 和 Install 文档,整体思路并不复杂:先确认环境,再用官方推荐方式安装,然后通过本地 Control UI 完成第一次可用聊天。

安装前先准备什么?

第一,确认你要装在什么环境里:本机、WSL2、还是云服务器。第二,检查 Node 版本。官方当前写得很清楚:推荐 Node 24,Node 22 LTS 仍兼容。第三,尽量用干净环境,尤其是 VPS 或云主机,官方安装页明确提醒:尽量避免来路不明的第三方“一键镜像”,更稳妥的做法是用干净的基础系统镜像后自行安装。

官方推荐怎么装?

官方安装文档目前把installer script放在推荐位置,意思很明确:如果你不是为了研究源码,先按官方安装脚本来最省事。这个脚本会处理 CLI 下载、全局安装和 onboarding 流程。对于新手来说,优先走官方安装路径,比东拼西凑社区教程更不容易踩坑。

第一次启动怎么看有没有成功?

官方 Getting Started 给出的最快路径,是启动 openclaw dashboard,然后通过浏览器里的 Control UI 进入,默认入口说明里提到可在网关主机上打开本地地址 127.0.0.1:18789。这意味着你安装完成后的第一目标,不是立刻接各种复杂渠道,而是先看到 Dashboard / Control UI 正常打开。能进入控制界面,通常就说明基础安装已经迈过第一步。

新手最稳的安装顺序

比较推荐的顺序是:
先在本机或干净的测试环境安装;
再确认 Dashboard 能打开;
再做最小化配置;
最后才去接更多聊天入口、模型或长期运行环境。
原因也很现实:你一开始接入太多组件,只要有一个环节出问题,就很难知道到底是哪里坏了。官方文档把“从 zero 到 first working chat”当成首要目标,也是这个思路。

常见安装问题有哪些?

最常见的第一类问题,是Node 版本不对。第二类,是环境不干净或脚本权限问题。第三类,是你照着旧教程安装,但版本已经变了。因为 OpenClaw 还处在快速变化阶段,外部教程很容易过时,优先看官方 docs 和 GitHub 是更稳的做法。GitHub 仓库页面当前也提到,它支持 npm、pnpm、bun,源码方式构建与直接使用 CLI 是两条不同路线。

装好后先别急着“开大”

刚装好的第一天,建议你不要马上给它高权限、不要立刻连主账号、也不要在主力工作机上直接处理敏感文件。微软安全团队最近专门提醒:最安全的姿势,是不要在含有敏感数据的主设备上运行,也不要直接绑定主要工作或个人主账号。这不是唱衰,而是这类 agent 天生会接触更多运行环境和上下文。

一句话总结

对新手来说,OpenClaw 安装最关键的不是“找最快教程”,而是遵循官方文档、用干净环境、先跑通最小闭环。先能打开 Dashboard,再谈复杂玩法;先在测试环境验证,再考虑长期部署。这样你后面碰到报错时,排查也会简单得多。

FAQ

1. OpenClaw 安装一定要会编程吗?
不一定,但愿意看文档、排查基础环境问题会轻松很多。

2. 官方推荐什么 Node 版本?
目前推荐 Node 24,Node 22 LTS 仍兼容。

3. 可以直接用第三方一键镜像吗?
官方更建议使用干净基础系统后自己安装。

4. 安装成功后先看什么?
先确认 Dashboard / Control UI 能打开。

5. 新手适合直接上生产环境吗?
不建议。先在测试环境跑通再说。