最近 OpenClaw“养虾”突然爆火,到底怎么装?卓伊凡把 Windows 和 Ubuntu 安装步骤一次讲透
最近 OpenClaw“养虾”突然爆火,到底怎么装?卓伊凡把 Windows 和 Ubuntu 安装步骤一次讲透
卓伊凡本文不贴图了,卓伊凡本文对应有视频,可以搜索卓伊凡查看卓伊凡录制的详细视频,因为贴图对发文来说有点浪费时间, 能看懂文的按照文来操作,看不懂可以看视频,视频分win和Linux。
最近 OpenClaw 很火,网上一堆人在讲“养虾”。卓伊凡身边也有一些外行朋友来问我:这东西到底怎么装?Windows 能不能装?Linux 怎么装?Ubuntu 又该怎么配?
先把话说在前面,我个人对这波热度是有点保留态度的。因为它确实火得很快,快到有点离谱。最近几天,媒体连续报道了 OpenClaw 出圈、“赛博养虾”破圈,甚至还有腾讯线下免费安装活动,现场排队人数很多。腾讯云官方口径和多家媒体报道都提到,3 月 6 日深圳腾讯大厦门口有大量用户排队安装 OpenClaw。(澎湃新闻)
但我还是那句话:热度归热度,技术归技术。
一个真正的开发者,不一定什么都会,但至少应该具备基本的环境安装能力(我认为去楼下安装的没有一个是开发者,至少没有是我认可的开发者,开发者怎么可能连这个都不会)。OpenClaw 本质上不是神秘黑科技,它是一个可以在本机或服务器上运行的 AI Agent 工具,核心是本地执行、接入模型、调度技能和网关服务。官方介绍里也写得很明确,它是一个“能真正做事”的 AI 助手,支持在本机运行、调用浏览器、文件系统、聊天渠道和自动化能力。(OpenClaws.io)
另外,这波“养虾”之所以让很多普通人第一次感知到“AI 真的开始替你操作设备了”,并不是因为 OpenClaw 横空出世把世界改写了,而是因为这条路线本身在最近几个月已经被手机 Agent 赛道提前教育过用户了。公开报道显示,豆包手机助手更早把“AI 直接操作设备”这件事带入大众视野,而 OpenClaw 是在电脑端把这件事做成了更开放、更可自部署的形态。(凤凰网)
闲话不多说,下面我直接把 Windows 安装 和 Linux Ubuntu 安装 分开讲,而且尽量按“小白也能照着装”的方式写。
一、安装前先弄明白:OpenClaw 到底需要什么环境
官方安装页给出的最低门槛并不夸张:
- 系统支持 Windows 10+、macOS 12+、Linux(Ubuntu 20.04+ / Debian 11+)
- Node.js 22 或更高版本
- 内存至少 2GB,推荐 4GB
- 约 500MB 磁盘空间
- 某些技能可选 Python 3.10+ 和 Git
- 如果要调用云端大模型,需要联网;如果走本地模型,可配合 Ollama 离线使用。(OpenClaws.io)
这一段其实很关键。很多人安装失败,不是因为 OpenClaw 多难,而是因为连自己的运行环境都没搞清楚:Node 版本不对、权限不够、WSL 没开、systemd 没启、网络没通、模型 Key 没配,这些才是大多数问题的根源。官方文档的推荐路径也非常明确:新手优先走安装脚本 + onboard 向导。(OpenClaw)
二、Windows 安装 OpenClaw:最稳的方式不是原生硬装,而是 WSL2 + Ubuntu
这一点我先直接下结论:
Windows 下最推荐的方案,是 WSL2 里装 Ubuntu,再在 Ubuntu 里装 OpenClaw。
这不是我拍脑袋说的,是官方文档明确写的。OpenClaw 的 Windows 文档直接说明:在 Windows 上推荐通过 WSL2 运行,CLI 和 Gateway 跑在 Linux 环境里,兼容性更好,和 Node、Linux 二进制、skills 的适配也更稳定。(GitHub)
1)Windows 方案A:推荐方案,WSL2 + Ubuntu 安装
第一步:以管理员身份打开 PowerShell
按下开始菜单,搜索 PowerShell,右键选择“以管理员身份运行”。
第二步:安装 WSL2
执行:
wsl --install
官方 Windows 文档也是这样写的,安装后通常会自动拉取 Ubuntu。(GitHub)
如果你想指定版本,也可以这样:
wsl --install -d Ubuntu-24.04
安装完后,重启电脑。
第三步:首次打开 Ubuntu
重启后,在开始菜单里打开 Ubuntu。第一次启动时,系统会让你设置:
- Linux 用户名
- Linux 密码
这个密码你输入时界面不会显示星号,这是 Linux 正常现象。
第四步:在 Ubuntu 里更新系统
进入 Ubuntu 后先执行:
sudo apt update && sudo apt upgrade -y
虽然 OpenClaw 官方安装脚本会处理很多依赖,但先把系统更新一下,出问题的概率更低。对于 Ubuntu 云主机和本地 WSL,这都是标准动作。(OpenClaw)
第五步:安装 OpenClaw
官方 Linux / WSL2 推荐的一键安装命令是:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
在快速开始页,也给出了 Linux 的一键安装脚本。(OpenClaws.io)
如果你已经装好了 Node 22+,也可以用包管理器方式:
npm install -g openclaw@latest
或者:
pnpm add -g openclaw@latest
官方 GitHub 和文档都把 npm install -g openclaw@latest 列为推荐方式之一。(GitHub)
第六步:运行初始化向导
安装完以后,不要急着乱点,先执行:
openclaw onboard --install-daemon
这是官方最推荐的新手入口。这个命令会启动 onboarding wizard,帮你一步一步配置:
- 模型认证
- Gateway 网关
- 工作区
- 渠道
- 技能
- 后台服务自启动
官方 GitHub、Getting Started 和 Linux/Windows 平台文档都把这一步作为首选流程。(GitHub)
第七步:检查网关是否启动成功
执行:
openclaw gateway status
如果服务正常,你就说明安装基本成了。官方 Getting Started 也是这么验证的。(OpenClaw)
第八步:打开控制界面
执行:
openclaw dashboard
如果能打开控制界面,说明网关和基础环境都已经通了。(OpenClaw)
2)Windows 方案B:原生 PowerShell 安装,只适合想先试试的人
如果你只是想先体验一下,不想折腾 WSL,也不是不能装。官方安装页确实给了 Windows PowerShell 的脚本:
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd
主页的另一种 PowerShell 安装写法是:
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta
这说明原生 Windows 确实能装,但官方同时强调:Windows 上最佳体验仍然是 WSL2。(OpenClaws.io)
所以我的建议很明确:
- 你是小白:直接 WSL2
- 你是想试水:可原生 PowerShell 跑一下
- 你是准备长期用、接技能、跑通道、做自动化:还是 WSL2 最稳
3)Windows 常见报错与解决思路
报错一:openclaw 命令找不到
一般是全局 npm 路径没进 PATH,或者安装没完成。官方 FAQ 和讨论区也提到过类似问题。(OpenClaw)
先检查:
node -v
npm -v
再检查是否真的装上了:
npm list -g --depth=0
如果没装上,就重新安装。
报错二:Windows 下装一半被拦截
官方社区讨论里提到,Windows Defender 有时会拦截 npm 安装过程。(GitHub)
报错三:WSL 里服务装不上
通常是 systemd 没启用。官方 Windows (WSL2) 文档把 “Enable systemd” 单独列成步骤,说明这是必要条件之一。(OpenClaw)
如果你需要手动开 systemd,可以在 WSL 里编辑:
sudo nano /etc/wsl.conf
写入:
[boot]
systemd=true
保存退出后,在 Windows PowerShell 执行:
wsl --shutdown
然后重新打开 Ubuntu。
报错四:安装完服务,但开机不自启
官方 Windows 文档给了 WSL 开机链路方案,包括:
sudo loginctl enable-linger "$(whoami)"
以及在 PowerShell 管理员里创建计划任务,让 WSL 开机自动拉起。(GitHub)
这一步更适合准备长期跑 OpenClaw 的用户,不是体验党必做项。
三、Linux Ubuntu 安装 OpenClaw:这是最干净也最像正式部署的方案
如果你本身就用 Linux,或者你打算把 OpenClaw 部署到一台 Ubuntu 云服务器、家里软路由旁边的小主机,甚至是专门的 AI 节点,那 Ubuntu 路线其实是最好理解的。
官方文档明确支持 Linux,推荐 Ubuntu 20.04+;如果是 VPS / 云主机,也建议尽量使用干净的 Ubuntu LTS 基础镜像,然后自己安装,而不是迷信第三方魔改一键镜像。(OpenClaws.io)
1)Ubuntu 安装前准备
先检查系统版本:
lsb_release -a
建议至少 Ubuntu 20.04,最好是 22.04 或 24.04。
然后更新系统:
sudo apt update && sudo apt upgrade -y
安装基础工具:
sudo apt install -y curl git
如果你后面还想接一些附加技能,也建议顺手装 Python:
sudo apt install -y python3 python3-pip
官方安装要求中把 Git 和 Python 3.10+ 标为可选依赖,部分 skills 会用到。(OpenClaws.io)
2)Ubuntu 一键安装法:最适合新手
直接执行:
curl -fsSL https://openclaw.ai/install.sh | bash
或者按安装页的参数写法:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
官方文档明确把 installer script 作为推荐方法,因为它会自动处理 Node 检测、安装 CLI、并进入 onboarding。(OpenClaw)
装完以后执行:
openclaw onboard --install-daemon
然后根据提示:
- 选择你要接的模型
- 填 API Key
- 配置 Gateway
- 选择是否安装后台服务
- 配置渠道或技能
这一步是整套系统真正“活起来”的关键。(GitHub)
3)Ubuntu 手动安装法:适合想自己控版本的人
如果你不想跑一键脚本,自己手动来也行。
第一步:确认 Node 版本
官方当前要求里写的是 Node.js 22 或更高。(OpenClaws.io)
检查版本:
node -v
npm -v
第二步:全局安装 OpenClaw
npm install -g openclaw@latest
第三步:初始化
openclaw onboard --install-daemon
第四步:检查状态
openclaw gateway status
第五步:打开面板
openclaw dashboard
这几步和官方 Quick Start 是对齐的。(GitHub)
4)Ubuntu 上推荐再做的几件事
第一件:跑一次健康检查
openclaw doctor
官方 GitHub 和平台文档都提到,升级、修复、迁移时可以用 openclaw doctor。(GitHub)
第二件:确认服务是否自启
如果你在 onboarding 时选择了安装 daemon,服务一般会常驻运行。官方说明中提到 --install-daemon 会安装 Gateway 守护服务。(GitHub)
第三件:配置模型 Key
如果你不配模型,OpenClaw 只是装好了“身体”,没有“大脑”。官方 FAQ 里也提示,认证错误时要检查 ~/.openclaw/.env 中的 Key 变量名是否正确,比如 OPENAI_API_KEY、ANTHROPIC_API_KEY 等。(OpenClaws.io)
四、给小白讲清楚:为什么很多人“装上了”却还是不会用
这部分我想单独讲,因为这是现在网上最容易误导人的地方。
很多人以为安装 OpenClaw 就像装 QQ、装微信、装浏览器,双击下一步就完了。不是。
OpenClaw 这种东西,本质更像是:
- 一套运行时
- 一个 CLI
- 一个 Gateway 网关
- 一个模型接入层
- 一套技能 / 插件系统
- 一个控制面板
- 可能还有外部聊天渠道的绑定
官方介绍里对它的定位也非常清楚:它不是单纯聊天框,而是有浏览器控制、系统访问、持久记忆、聊天渠道接入和技能扩展的一套个人 AI assistant 体系。(OpenClaws.io)
所以,真正的“会安装”,至少包括下面几层:
- 系统环境装好
- CLI 装好
- Gateway 跑起来
- 模型可用
- Dashboard 能打开
- Skills 或渠道能接通
- 出问题会看日志、会修 PATH、会查端口、会排错
你说一个人只会复制粘贴命令,不会理解这几个层次,能不能算“会安装”?
我个人觉得,那最多叫“照葫芦画瓢装过一次”。
五、我给普通用户的最简建议:到底该选哪一种安装方式
适合普通 Windows 用户
直接走:
Windows 11 / 10 → PowerShell 管理员 → wsl --install → Ubuntu → 在 Ubuntu 里装 OpenClaw
这是官方推荐路径,也是最稳的。(GitHub)
适合 Ubuntu 用户
直接:
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
这是官方最省事的路线。(OpenClaw)
适合只是想试试玩玩的人
Windows 原生 PowerShell 脚本可以先跑,但别把它当最终生产环境。官方都在提醒你:Windows 最佳体验是 WSL2。(OpenClaws.io)
六、最后说句实在话:别把“会复制命令”当成技术,更别把热度当成实力
这两天 OpenClaw 火,是事实。媒体报道多、讨论多、活动多,也是事实。(36氪)
但我还是那个观点:
真正的技术含量,不在于你跟风装没装,而在于你有没有能力理解它为什么这么装、装完以后怎么跑、出问题以后怎么修。
现在很多所谓“开发者”最爱做的一件事,就是蹭热点、发截图、晒界面、讲概念,一到真正落地的时候,Node 版本不会看、WSL 不会开、systemd 不会启、PATH 不会配、服务不会查、日志不会看。你说这也叫开发者?那我只能说,这行业里确实混子太多了。
当然,话也不能说死。普通用户不会装很正常,外行来问我,我愿意讲。
但一个天天把“我是程序员”“我是开发者”挂嘴上的人,连官方安装文档都读不明白,连 Windows 推荐 WSL2 这种基础路径都不知道,那他大概率不是不会装 OpenClaw,他是不具备最基本的工程思维。官方文档其实已经把路径给得很清楚了:**安装脚本、onboard 向导、gateway 状态检查、dashboard 验证、doctor 修复。**只要肯读,根本不玄学。(OpenClaw)
附:最精简命令速查版
Windows 推荐版(WSL2)
wsl --install
进入 Ubuntu 后:
sudo apt update && sudo apt upgrade -y
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
Ubuntu 版
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git python3 python3-pip
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
openclaw doctor
- 点赞
- 收藏
- 关注作者
评论(0)