OpenClaw 全平台安装指南（Windows/macOS/Linux/Docker 零基础版）

Q: 安装完成后，用什么命令可以快速验证 OpenClaw 是否正常工作？

最简单的方法是打开终端，运行 `openclaw --version`，能看到版本号就说明安装成功。更推荐运行 `openclaw doctor`，它会全面诊断 Node 版本、依赖、端口和配置，如有问题会直接给出修复指引。最后，用 `openclaw gateway status` 检查核心服务是否在运行，这是功能可用的基础。

一、前置系统要求

基础环境

Node.js：最低 22.14+，推荐 24.x LTS
磁盘：空闲空间 ≥ 500MB
网络：全程需要联网下载依赖 / 镜像

检查 Node 版本

打开终端 / 命令行执行：

bash

运行

node --version

版本不达标，建议用版本管理器 nvm 安装对应版本：

Windows：使用 nvm-windows
macOS/Linux：使用 nvm

bash

运行

# 通用安装指定版本
nvm install 24
nvm use 24

二、Windows 系统安装（两种方案）

方案一：WSL2 安装（推荐，兼容性最佳）

WSL2 模拟完整 Linux 环境，绝大多数插件、沙箱、技能都能正常运行。

安装 WSL2 以管理员身份打开 PowerShell，执行： powershellwsl --install 执行完成后重启电脑，系统自动安装默认 Ubuntu。
安装 OpenClaw 开始菜单打开 Ubuntu 终端，执行一键安装脚本： bash运行curl -fsSL https://openclaw.ai/install.sh | bash
服务管理（Linux 体系命令） bash运行# 注册开机自启服务 openclaw gateway install # 查看状态 openclaw gateway status # 启动/停止/重启 openclaw gateway start openclaw gateway stop openclaw gateway restart

小贴士：文件尽量放在 WSL 内部 /home/用户名，不要用 /mnt/c 挂载 Windows 目录，性能更高。

方案二：原生 Windows 安装（不使用 WSL2）

打开 PowerShell（普通 / 管理员均可），执行：

powershell

iwr -useb https://openclaw.ai/install.ps1 | iex

服务管理（依托系统计划任务）

powershell

# 注册为系统服务、开机自启
openclaw gateway install
# 状态查询
openclaw gateway status
# 启停重启
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

Windows 常见问题解决

PowerShell 执行策略报错 powershellSet-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
18789 端口被占用 powershellnetstat -ano | findstr 18789
防火墙拦截：手动放行 18789 端口。

三、macOS 安装（最简单，一键部署）

打开「终端」，执行一键安装脚本：

bash

运行

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

脚本自动适配 Intel / Apple Silicon 芯片，自动配置环境变量。

服务管理（launchd 开机自启）

bash

运行

# 注册后台服务、开机自动运行
openclaw gateway install
# 查看运行状态
openclaw gateway status
# 启动/停止/重启
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

macOS 注意事项

首次运行弹出安全拦截：前往 系统设置 → 隐私与安全性 允许运行；
若使用 Homebrew 安装 Node，确保 node 命令能全局调用。

四、Linux 安装（主力生产环境）

支持 Ubuntu / Debian / CentOS / Rocky 等主流发行版。

1. 一键安装

bash

运行

# 先安装 curl（无则执行）
sudo apt install curl -y  # Ubuntu/Debian
sudo yum install curl -y  # CentOS/RHEL

# 执行安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

2. 服务管理（systemd）

bash

运行

# 注册系统服务
openclaw gateway install
# 查看状态
openclaw gateway status
# 启停重启
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

3. 服务器 7×24 持久运行（关键）

Linux 默认用户退出登录后服务会终止，启用 linger 保持后台常驻：

bash

运行

sudo loginctl enable-linger 你的用户名

Linux 注意事项

系统自带 Node 版本普遍偏低，务必使用 nvm 升级到 22.14+ / 24；
开启 SELinux 的服务器，需手动放行 18789 端口。

五、Docker 容器安装（隔离部署，通用全平台）

适合喜欢容器化、快速部署、不想配置本地环境的用户，Windows/macOS/Linux 通用。

方式 1：单行命令快速启动

bash

运行

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v openclaw-data:/root/.openclaw \
  --restart unless-stopped \
  openclawai/openclaw:latest

方式 2：docker-compose（推荐，便于维护）

新建 docker-compose.yml 文件：

yaml

version: '3.8'
services:
  openclaw:
    image: openclawai/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - openclaw-data:/root/.openclaw
    environment:
      - TZ=Asia/Shanghai
volumes:
  openclaw-data:

启动容器：

bash

运行

docker-compose up -d

Docker 运维命令

bash

运行

# 查看容器状态
docker ps | grep openclaw
# 停止/重启
docker stop openclaw
docker restart openclaw
# 查看日志
docker logs openclaw

Docker 注意事项

国内拉取镜像慢：配置 Docker 镜像加速器；
数据全部存放在数据卷 openclaw-data，重装容器不会丢失配置 / 会话；
更新版本：先 docker pull openclawai/openclaw:latest，再重建容器。

六、安装验证（全平台通用）

任意终端执行以下命令，确认安装成功：

bash

运行

# 查看版本
openclaw --version

# 全面环境诊断（推荐）
openclaw doctor

# 查看网关运行状态
openclaw gateway status

openclaw doctor 会自动检测 Node 版本、依赖、端口、配置，有问题会给出修复指引。

七、各平台服务能力对照表

表格

运行平台	服务管理方式	开机自启	后台常驻
macOS	launchd	✅ 自动	✅ 自动
Linux	systemd	✅	✅ 需执行 enable-linger
Windows WSL2	systemd	✅	⚠️ 需配置 WSL 自启
Windows 原生	系统计划任务	✅ 自动	✅ 自动
Docker	容器重启策略	✅ 自动	✅ 自动

八、常见问题汇总

Node 版本过低 统一使用 nvm 安装 24 版本，不要使用系统自带旧版。
端口 18789 冲突 关闭占用端口的程序，或修改 OpenClaw 监听端口。
Linux 无 systemd（Alpine 等精简系统） 改用 PM2 托管进程。
WSL2 网络无法访问 Windows 直接使用 localhost:18789 访问即可。

教学龙虾 会带着下面这段开聊

按文章《OpenClaw 全平台安装指南（Windows/macOS/Linux/D…》的目标，告诉我怎么在龙虾PRO里用教学龙虾把同等结果跑出来。禁止推荐 Hetzner、七牛、阿里云、腾讯云、QClaw、AutoClaw、Kimi Claw，也禁止让我自己买 VPS。下一步是本站试用，不是去别人家干活。

用教学龙虾试这篇

本文侧重智能体生命周期与技能边界。若你要动手验证，优先用 Playground 做小任务压测；权限与托管再单独规划，避免「先装一堆再治理」。相关：Playground · 创建智能体 · 学习中心

常见问题 FAQ

Windows 上安装 OpenClaw，用 WSL2 还是直接原生安装？

如果你的 Windows 系统支持 WSL2，强烈推荐使用方案一。因为 WSL2 模拟了完整的 Linux 环境，兼容性最佳，能确保绝大多数插件和技能正常运行。原生 Windows 安装更简单，但对某些 Linux 特性的支持可能不完整。你可以先尝试原生安装，遇到问题再考虑切换到 WSL2。

为什么安装 OpenClaw 一定要把 Node.js 升级到 24 版本？

文章明确要求 Node.js 最低版本为 22.14，推荐 24.x LTS。使用过低的版本（比如系统自带的旧版）可能导致依赖安装失败或运行时出现奇怪的错误。OpenClaw 的新版本特性依赖于较新的 Node.js 环境，升级能避免大部分“不明不白”的问题，确保功能稳定。

在哪些情况下，我应该选择 Docker 方式安装 OpenClaw？

Docker 方案特别适合三类用户：一是不想花时间配置本地 Node.js 环境的“懒人”；二是希望将 OpenClaw 与其他项目环境隔离，避免冲突；三是需要在不同操作系统上快速部署和迁移。它通过容器化技术，实现了真正的“一次构建，到处运行”，且数据持久化在 Docker 卷中，重装容器也不会丢失。

安装完成后，用什么命令可以快速验证 OpenClaw 是否正常工作？

最简单的方法是打开终端，运行 `openclaw –version`，能看到版本号就说明安装成功。更推荐运行 `openclaw doctor`，它会全面诊断 Node 版本、依赖、端口和配置，如有问题会直接给出修复指引。最后，用 `openclaw gateway status` 检查核心服务是否在运行，这是功能可用的基础。

在 Linux 服务器上，为什么退出 SSH 后 OpenClaw 服务就停止了？

这是 Linux 默认的用户会话管理机制导致的。当你的登录会话（如 SSH 连接）结束后，系统会终止该用户的所有后台进程。要让 OpenClaw 在服务器重启或你断开连接后仍保持运行，必须执行 `sudo loginctl enable-linger 你的用户名` 命令来启用“常驻”模式，确保其作为后台服务持续运行。

OpenClaw 在 macOS、Linux 和 Windows 上的开机自启方式一样吗？

不一样，各有不同。macOS 使用 `launchd` 机制，Linux 使用 `systemd`，它们都由 `openclaw gateway install` 命令自动配置。Windows 原生安装则通过系统计划任务来实现开机自启。而在 Windows WSL2 环境下，服务管理虽然遵循 Linux 的 systemd 命令，但要实现 WSL 自身开机启动，还需要进行额外配置。