2026.3.13最新版 OpenClaw Ubuntu/Windows WSL 安装攻略,一篇搞定
2026.3.13最新教程,手把手教你如何在 Ubuntu / Windows WSL 上安装 OpenClaw,国内网络环境优化,收藏=学会!
写在前面
还在为 Linux 安装软件而发愁吗?是不是每次配置环境都踩坑?今天给大家分享一个实测有效的安装方法,2026年3月8日最新亲测,帮你避开所有弯路!
适用系统:Ubuntu 20.04+ 和 Windows WSL(Ubuntu 子系统),命令完全通用!
为什么选择 OpenClaw?
OpenClaw 是一个强大的 AI 助手网关,支持多种大模型接入。安装完成后,你可以通过它轻松调用各种 AI 能力,无论是编程辅助还是问答对话,都能搞定。
更重要的是,它支持飞书、钉钉等国内平台,在国内使用体验更好!
准备工作
在开始之前,你需要准备:
- 一台 Ubuntu 系统电脑(推荐 20.04 或更高版本)或 Windows 10/11 上的 WSL(Ubuntu 子系统)
- 能够访问外网下载 Node.js(如果访问困难,本文也提供了国内镜像源配置方法)
- 基本的终端操作知识(不怕,你肯定能学会!)
步骤一:更新系统
首先更新软件包,这是每次装机后的必备操作:
sudo apt update -y && sudo apt upgrade -y
提示:这一步是为了获取最新的软件版本,-y 参数表示自动确认,不用一次次按回车
步骤二:清理与安装基础工具
清理旧软件包,然后安装 curl 和 git:
sudo apt autoremove -y
sudo apt install curl git -y
提示:curl 是下载工具,git 是版本管理工具,都是后续必备
步骤三:下载并配置 Node.js
这是最关键的一步!手动下载 Node.js 22 版本:
wget https://nodejs.org/dist/v24.14.0/node-v24.14.0-linux-x64.tar.xz
tar -xf node-v24.14.0-linux-x64.tar.xz
sudo mv node-v24.14.0-linux-x64 /usr/local/lib/nodejs
注意:不使用 apt 安装,而是手动下载官方二进制包,版本更可控,apt 安装的古董版本,不支持 openclaw
配置环境变量
将 Node.js 路径添加到系统:
echo 'export NODEJS_HOME=/usr/local/lib/nodejs' >> ~/.bashrc
echo 'export PATH=$NODEJS_HOME/bin:$PATH' >> ~/.bashrc
source .bashrc
提示:用 echo 命令直接追加内容,不用手动编辑文件,更简单!
步骤四:验证 Node.js
检查是否安装成功:
node -v
输出应为:
v24.14.0
npm -v
输出应为:
11.9.0
步骤五:国内网络加速
重点来了!国内用户一定要配置淘宝镜像源,否则 npm 下载会超级慢:
npm config set registry https://registry.npmmirror.com
验证一下:
npm config list
看到 registry = "https://registry.npmmirror.com/" 就成功了!
步骤六:安装 OpenClaw
激动人心的时刻到了!一行命令安装:
npm install -g openclaw@latest
然后启动:
openclaw onboard --install-daemon
提示:--install-daemon 参数让程序在后台运行,关掉终端也不会停止
验证安装
打开浏览器,访问 http://127.0.0.1:18789 就能看到控制面板啦!
安装只是开始,健康运行才是关键
安装好 OpenClaw 只是第一步!想要稳定运行,还需要:
- 配置大模型:接入 Ollama / OpenAI / Claude 等 provider
- 清理警告错误:定期检查日志,保证服务健康
- 优化性能:根据使用场景调整配置
关注我们,后续会推出系列教程,手把手教你配置和调优!
常见问题
| 问题 | 解决方法 |
|---|---|
| node 命令找不到? | 执行 source ~/.bashrc 重新加载环境变量 |
| npm 下载太慢? | 确认已配置淘宝镜像源 |
| 权限报错? | 命令前加 sudo |
总结
整个过程只需要 13 个步骤,按照本文操作,3分钟就能搞定!而且本文是 2026年3月8日最新亲测,所有版本号都是最新的。
安装完成后,你就能体验 OpenClaw 的强大了。支持国内平台、对接各种大模型,都非常简单。