我日常在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,有几个实用建议:
- 配置文件放在Git仓库里同步,每台设备都能保持一致
- API Key不要硬编码在配置文件里,用环境变量管理
- Skills技能在每台设备上需要单独安装,不会自动同步
- 数据和日志是本地的,不会跨设备共享
常见问题速查
| 问题 | Windows | macOS | Linux | 安卓 |
|---|---|---|---|---|
| 权限不足 | 管理员运行 | sudo | sudo | ROOT/Termux |
| 命令未找到 | 重开终端 | 重开终端 | source ~/.bashrc | 重开Termux |
| 下载慢 | 配镜像源 | 配镜像源 | 配镜像源 | 换WiFi |
| 端口占用 | 任务管理器 | lsof -i | lsof -i | 重启APP |
这张表我建议收藏,不管在哪个平台出问题,先查这里。