OpenClaw全平台安装指南:Windows、macOS、Linux、安卓一篇搞定

我日常在macOS上写代码,Windows上打游戏顺便跑服务,Linux服务器上部署生产环境,安卓手机上偶尔也要远程看一眼。所以当我决定装OpenClaw的时候,我需要的是一篇覆盖所有平台的指南,而不是单一平台的教程。网上找了一圈没找到满意的,那就自己写一篇。

通用前置条件(所有平台都一样)

不管你用什么操作系统,这两个条件必须满足:

  • Node.js 22+:注意是22,不是18、不是20。一键脚本会自动安装,手动安装去 https://nodejs.org
  • Git:用于代码拉取和更新。macOS和Linux一般自带,Windows需要单独装

可选但推荐:

  • 配置国内npm镜像:显著加速依赖下载
    npm config set registry https://registry.npmmirror.com/
    

macOS篇

macOS是我觉得装OpenClaw体验最好的平台,原因很简单:Unix底层、Homebrew生态、M芯片性能。

# 打开 Terminal.app
curl -fsSL https://openclaw.ai/install.sh | bash

等待安装完成后:

openclaw onboard --install-daemon

跨平台注意点:macOS的默认shell从Catalina开始已经换成了zsh。如果你之前在bash下配过环境变量(比如.bashrc),可能需要在.zshrc里也加一遍。OpenClaw的一键脚本会自动处理这个问题,但如果你是手动安装的,记得检查PATH。

M芯片 vs Intel:两种架构都支持。M系列芯片跑OpenClaw体验更好,因为Node.js对ARM的优化已经很成熟。Intel的老Mac也完全没问题,就是初次安装编译依赖时会慢一点。

Windows篇

Windows是最多人用但也最容易出问题的平台。核心原因:Windows的终端环境比Unix系复杂,权限管理也不一样。

推荐方式:PowerShell安装

# 以管理员身份打开 PowerShell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后:

openclaw onboard --install-daemon

跨平台注意点:OpenClaw官方其实更推荐Windows用户通过WSL2来安装。WSL2里跑的是原生Linux环境,兼容性和性能都比直接在Windows上跑要好。如果你本来就在用WSL2,直接参考Linux篇即可。

WSL2安装方式

# 如果还没装WSL2
wsl --install

# 进入WSL2之后,参照Linux的命令
curl -fsSL https://openclaw.ai/install.sh | bash

原生Windows vs WSL2对比

原生Windows WSL2
安装难度 简单 需要先装WSL2
兼容性 偶尔有坑 接近完美
性能 够用 更好
文件系统交互 原生 跨系统访问略慢
适合谁 不想折腾的用户 有开发经验的用户

Linux篇

Linux是最省心的平台,毕竟OpenClaw本身就是在Linux环境下开发的。

curl -fsSL https://openclaw.ai/install.sh | bash

主流发行版(Ubuntu、Debian、Fedora、CentOS、Arch)都支持。一键脚本会自动检测你的包管理器。

如果需要sudo权限,脚本会提示你输入密码。

openclaw onboard --install-daemon

跨平台注意点:如果你的Linux是无头服务器(没有GUI),Dashboard页面需要通过SSH隧道或者反向代理来访问:

# 在本机执行SSH隧道
ssh -L 18789:localhost:18789 user@your-server
# 然后本地浏览器访问 http://localhost:18789

安卓篇

是的,手机也能跑OpenClaw。有两种方式:

方式一:APK直装(新手首选)

去OpenClaw的GitHub Releases页面下载最新的Android APK,安装即可。需要在手机设置里允许"安装未知来源应用"。

安装后只开启必要权限(存储和网络),其他权限(通讯录、短信、相机)全部拒绝。

方式二:Termux脚本版(功能更完整)

# 先从 F-Droid 下载安装 Termux(不要用 Google Play 版)
pkg update && pkg install nodejs git -y
git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm start

跨平台注意点:安卓上跑OpenClaw的性能取决于你的手机芯片。骁龙8系列或天玑9000以上体验较好,中端芯片也能跑但会偏慢。而且手机上跑后台进程容易被系统杀掉,建议在电池设置里给Termux或OpenClaw APP加白名单。

Docker篇(跨平台通用方案)

如果你不想在本机装任何东西(我理解这种洁癖),Docker是最干净的方案。macOS、Windows、Linux都能用。

mkdir -p ~/.openclaw
docker pull openclaw/openclaw:latest
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

浏览器访问 http://localhost:18789 即可。

跨平台注意点:Docker Desktop在macOS和Windows上都是虚拟化方案,性能会比原生安装略差。Linux上Docker是原生容器,性能基本无损。

统一的安装后操作

不管你在哪个平台,装完之后都是一样的命令:

openclaw status     # 查看状态
openclaw doctor     # 诊断检查
openclaw dashboard  # 打开控制面板

多平台同步小技巧

如果你跟我一样在多个设备上装了OpenClaw,有几个实用建议:

  1. 配置文件放在Git仓库里同步,每台设备都能保持一致
  2. API Key不要硬编码在配置文件里,用环境变量管理
  3. Skills技能在每台设备上需要单独安装,不会自动同步
  4. 数据和日志是本地的,不会跨设备共享

常见问题速查

问题 Windows macOS Linux 安卓
权限不足 管理员运行 sudo sudo ROOT/Termux
命令未找到 重开终端 重开终端 source ~/.bashrc 重开Termux
下载慢 配镜像源 配镜像源 配镜像源 换WiFi
端口占用 任务管理器 lsof -i lsof -i 重启APP

这张表我建议收藏,不管在哪个平台出问题,先查这里。

跟着做成功了 感谢

原来如此

看完了 确实如此

来早了

四个平台都写了 但安卓那段明显水了 Termux跑Node问题很多的

npm镜像那行应该放在最前面 很多人卡在下载超时就是因为没配

跨平台指南该有的都有了 但每个平台其实值得单独写一篇

@srcread 每个平台单独写一篇确实更好 但全平台指南的价值在于对比 用户可以快速了解各平台的优缺点再决定在哪装

@opsdog 安卓部分确实水了 Termux跑Node的坑太多 内存限制、后台进程被杀、存储路径问题 建议安卓部分标注’仅供体验’