Windows 和 Ubuntu 安装 OpenClaw 全攻略

文章目录【开场白】【先说结论Windows 用户推荐走 WSL2】【Windows 安装4 步搞定】第 1 步装 WSL2第 2 步更新系统第 3 步一键装 OpenClaw第 4 步初始化配置【WSL2 必做配置让 OpenClaw 开机自启】【Ubuntu 安装3 步搞定】第 1 步更新系统 装依赖第 2 步一键装 OpenClaw第 3 步初始化【装完怎么用】【验证一下你装对了吗】【踩坑急救包】【总结一图流】【开场白】你是不是也刷到了最近 AI 圈最火的事——OpenClaw 养虾。别人还在跟 AI 聊天OpenClaw 已经能让 AI 帮你干活了读文件、跑命令、操作浏览器、处理邮件……它不是聊天机器人它是你的 AI 员工7×24 小时待命。但问题来了——很多人卡在第一步安装。今天我把 Windows 和 Ubuntu 两个系统的安装步骤一次讲透。看完这条视频5 分钟搞定。【先说结论Windows 用户推荐走 WSL2】别直接在 Windows 上装原生版原生版目前还有坑官方自己也说了——WSL2 才是推荐路径。简单说就是在 Windows 里跑一个 Ubuntu 子系统然后在 Ubuntu 里装 OpenClaw。听起来多一步但稳得多。Ubuntu 用户就简单了直接装。【Windows 安装4 步搞定】第 1 步装 WSL2打开 PowerShell记住要用管理员权限运行。输入一行命令wsl --install回车等它装完重启电脑。重启后会自动弹出 Ubuntu 窗口让你设用户名和密码。设好进入 Ubuntu。想指定版本用wsl --install -d Ubuntu-24.04第 2 步更新系统进到 Ubuntu 之后先跑两条命令把系统更新一下sudo apt update sudo apt upgrade -y这一步很重要不然后面装东西可能出兼容问题。第 3 步一键装 OpenClawcurl -fsSL https://openclaw.ai/install.sh | bash就这一行等 1 到 2 分钟。脚本会自动检测 Node.js没有的话帮你装不用你操心。看到openclaw installed successfully就装好了。国内网络慢用镜像curl -fsSL https://open-claw.org.cn/install-cn.sh | bash第 4 步初始化配置openclaw onboard --install-daemon这一步是交互式的会问你几个问题配置目录默认就行回车AI 提供商选 Custom OpenAI Compatible API粘贴你的 API Key填 Base URL比如阿里云https://dashscope.aliyuncs.com/compatible-mode/v1默认模型填qwen-turbo或你喜欢的一路回车完成。【WSL2 必做配置让 OpenClaw 开机自启】很多人装完就不管了结果重启电脑 OpenClaw 就没了。这一步一定要做在 Ubuntu 里编辑 WSL 配置sudo nano /etc/wsl.conf写入[boot] systemdtrue保存退出。然后回到 Windows 的 PowerShell执行wsl --shutdown再重新打开 Ubuntusystemd 就启用了。再执行sudo loginctl enable-linger $(whoami)这样 OpenClaw 的守护进程就能开机自启了。7×24 小时待命名副其实。【Ubuntu 安装3 步搞定】Ubuntu 比 Windows 更简单因为不用折腾 WSL。第 1 步更新系统 装依赖sudo apt update sudo apt upgrade -y sudo apt install -y curl git python3 python3-pip第 2 步一键装 OpenClawcurl -fsSL https://openclaw.ai/install.sh | bash一样的命令等它装完。第 3 步初始化openclaw onboard --install-daemon跟 Windows 里的配置流程一样选模型、填 Key、一路回车。【装完怎么用】两种方式看你习惯方式 1Web 界面推荐新手openclaw ui --no-gateway浏览器自动打开http://localhost:3000可视化操作跟聊天一样指挥 AI 干活。方式 2终端 TUI适合老手openclaw tui直接在终端里对话服务器远程操作也方便。【验证一下你装对了吗】跑三条命令openclaw gateway status openclaw doctor openclaw dashboardgateway status看网关是否在线doctor做一次全面健康检查dashboard打开管理面板看运行状态全绿就说明没问题开始用吧。【踩坑急救包】问题解法openclaw命令找不到重启终端让环境变量生效Windows 安装被拦截用管理员终端先跑Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -ForceWSL 里服务装不上检查 systemd 有没有启用刚才那步你做了吗模型调用失败检查~/.openclaw/.env里的 API Key 有没有填对Web UI 打不开换端口openclaw ui --port 3001或跑openclaw doctor --fix【总结一图流】Windows: wsl --install → 重启 → 进Ubuntu → sudo apt update sudo apt upgrade -y → curl -fsSL https://openclaw.ai/install.sh | bash → openclaw onboard --install-daemon → 配置systemd自启 → openclaw ui Ubuntu: sudo apt update sudo apt upgrade -y → curl -fsSL https://openclaw.ai/install.sh | bash → openclaw onboard --install-daemon → openclaw uiWindows 多一步 WSLUbuntu 直接开干。核心安装命令就一行真的就是 5 分钟的事。装完你就拥有了一个 7×24 小时在线的 AI 员工。