# OpenClaw（原 Clawdbot）安装教程：各系统命令与验证

> OpenClaw 要求 Node 24.16+ 或 26.1+，官方脚本会自动补装。按系统选桌面应用、一条命令或 Docker，装完用三条命令确认 Gateway 在运行。

- Source: https://www.aifreeapi.com/zh/posts/openclaw-installation-guide
- Language: zh
- Published: 2026-02-04
- Updated: 2026-09-24
- Publisher: AI Free API (https://www.aifreeapi.com)

OpenClaw 是跑在你自己电脑或服务器上的开源 AI 助手，旧名 Clawdbot、Moltbot，中文社区也常叫它“小龙虾”。截至 2026 年 9 月 24 日，按自己的情况对号入座即可：

- **不想碰命令行**：在 [openclaw.ai/install](https://openclaw.ai/install) 下载桌面应用，macOS、Windows、Linux 都有，Gateway、聊天窗口和设置向导会一起装好。
- **习惯用终端**：macOS、Linux 和 WSL2 运行 `curl -fsSL https://openclaw.ai/install.sh | bash`；Windows 在 PowerShell 里运行 `iwr -useb https://openclaw.ai/install.ps1 | iex`。缺 Node 时脚本会自动安装，装完直接进入新手引导。
- **装完确认**：依次运行 `openclaw --version`、`openclaw doctor`、`openclaw gateway status`，看到 Gateway 在 18789 端口监听就算装好了。
- **手里是旧教程**：`npm i -g clawdbot` 装到的是 2026 年 1 月的旧版，现在的包名是 `openclaw`。
- **已经装过 2026 年 6 月之前的 OpenClaw**：别一步升到最新版，先升到 2026.9.5 并运行 `openclaw doctor --fix`，再升级，步骤见下文“以后怎么更新”。

Gateway 是 OpenClaw 常驻后台的网关服务，网页控制界面和各个聊天软件都连到它上面；Gateway 不在运行，助手就不会回复。

## 安装 OpenClaw 前要准备什么：Node 版本和模型账号

需要提前确认的是 Node 版本和一个能用的模型账号；用安装脚本或桌面应用时，连 Node 都会替你装好。截至 2026 年 9 月 24 日，[官方安装文档](https://docs.openclaw.ai/install)、[安装页](https://openclaw.ai/install)和 npm 上 `openclaw` 包声明的要求如下：

| 项目 | 要求 | 说明 |
| --- | --- | --- |
| Node.js | 24.16 及以上的 24.x，或 26.1 及以上 | 官方推荐 Node 26；Node 22 和 Node 25 都不在支持范围内 |
| 操作系统 | 安装页标注 macOS 15+、Windows 10/11、Linux x64 | Linux 桌面应用只有 x64 版；命令行脚本支持 Debian、Ubuntu、Fedora、Arch 和 Raspberry Pi OS |
| 模型访问 | 已登录的 Claude Code 或 Codex CLI，或任一模型服务商的 API Key | 新手引导会自动检测并复用 |
| pnpm | 只在从源代码构建时需要 | 其他安装方式用不到 |
| 内存 | 安装文档没有给普通安装的最低值 | Docker 文档写明本地构建镜像至少 6 GB，改用预构建镜像可避开 |

脚本发现缺 Node 时，macOS 上会装 Node 26，第一次运行可能要你输入管理员密码来安装 Homebrew；Linux 上会装 Node 24 LTS。如果你已经自己装过 Node，先用 `node --version` 看一眼：Node 22.12 是旧 `clawdbot` 包的要求，现在的 `openclaw` 至少要 24.16。

官方文档的简体中文页更新得比英文页慢。截至 2026 年 9 月 24 日，[中文安装页](https://docs.openclaw.ai/zh-CN/install)写的仍是 Node 22.22.3+、24.15+ 或 25.9+，npm 命令缺少 npm 12 需要的参数，pnpm 命令用的是全局安装不支持的 `approve-builds -g`。两边不一致时，以[英文安装页](https://docs.openclaw.ai/install)为准。

## 先选安装方式：桌面应用、安装脚本、npm 还是 Docker

![OpenClaw 安装方式决策图：依次回答是否要全天在线、是否不想碰命令行、是否已自己管理 Node、是否用 Windows，分别对应 Linux 服务器或 Docker、桌面应用、npm 等全局安装、PowerShell 或 WSL2，四个都答否时用 install.sh 安装脚本](https://www.aifreeapi.com/posts/zh/openclaw-installation-guide/img/install-method-flow.webp)

| 你的情况 | 用这个 | 要注意什么 |
| --- | --- | --- |
| 不想碰命令行 | 桌面应用 | Windows 版叫 Windows Hub，本地设置会用到 WSL |
| macOS 或 Linux，习惯终端 | 安装脚本 `install.sh` | 自动补装 Node，装完进入新手引导 |
| Windows，想用命令行 | PowerShell 脚本，或在 WSL2 里跑 `install.sh` | WSL2 与 Linux 兼容性最好 |
| 已经用 nvm 等工具管理 Node | npm、pnpm 或 bun 全局安装 | npm 12 要多加一个参数 |
| 不想改动系统里的 Node | 本地前缀安装程序 `install-cli.sh` | 只装命令行，不跑新手引导 |
| 只想先试一下 | `npx openclaw@latest` | 需要已装好 Node；Gateway 在当前终端前台运行，按 Ctrl+C 结束 |
| 电脑会关机，但助手要全天在线 | Linux 服务器上跑 `install.sh`，或用 Docker | Gateway 在哪台机器上，那台机器就得常开 |
| 想读或改源代码 | `install.sh` 加 `--install-method git` | 从源代码构建，会用到 pnpm |

用 `npx` 试用时，新手引导保存的配置会留下来，之后正式安装还能接着用。

## macOS 与 Linux：一条命令安装

打开终端运行：

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

脚本会识别系统，按需安装 Node，装好 OpenClaw，然后自动开始新手引导。官方估计安装本身两分钟左右，登录模型服务商和可选设置可能更久。

几个常用变体：

```bash
# 先装好，稍后再运行 openclaw onboard 开始新手引导
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

# 本地前缀安装：Node 和 OpenClaw 都放在 ~/.openclaw 这类目录下，系统其他地方不变
curl -fsSL https://openclaw.ai/install-cli.sh | bash

# 从 GitHub 源代码构建安装
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
```

`install-cli.sh` 只装命令行，不会自动启动新手引导，装完自己运行 `openclaw onboard`。

服务器也用同一条 `install.sh`。脚本认的是发行版，不管服务器在哪家云上，系统是 Debian、Ubuntu、Fedora、Arch 或 Raspberry Pi OS 就在支持范围内；国内服务器遇到的网络问题见后文。

## Windows：Windows Hub、PowerShell 与 WSL2

Windows 上不一定要用 WSL2。[官方 Windows 文档](https://docs.openclaw.ai/platforms/windows)支持三条路：想要图形界面选 Windows Hub，想在原生命令行里用选 PowerShell 脚本，需要和 Linux 一致的运行环境选 WSL2。

### Windows Hub：图形界面

Windows Hub 是官方的 Windows 桌面应用，支持 Windows 10 20H2 及以上和 Windows 11，安装不需要管理员权限。

1. 在 [openclaw.ai/install](https://openclaw.ai/install) 的 Windows 页签下载安装包：x64 电脑用 `OpenClawCompanion-Setup-x64.exe`，ARM 电脑用 `OpenClawCompanion-Setup-arm64.exe`。
2. 从开始菜单或系统托盘打开 OpenClaw Companion，首次启动时选 **Set up locally**。它会建一个应用专用的 WSL 发行版 `OpenClawGateway`，在里面装好 Gateway 并完成配对，不会改动你已有的 Ubuntu。
3. 托盘图标变绿，说明设置完成。从托盘打开 Command Center，可以看到连接、配对和渠道状态。

本地设置失败时，先看日志：

```powershell
notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"
```

官方列出的常见原因有四个：WSL 被禁用、虚拟化被屏蔽、应用自带的 WSL 状态有残留，以及安装 Gateway 包时网络失败。电脑开不了 WSL 或虚拟化时，改用下面的 PowerShell 脚本。

### PowerShell：原生命令行

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

安装页给的等价写法是 `powershell -c "irm https://openclaw.ai/install.ps1 | iex"`。只安装、不进入新手引导：

```powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
```

在原生 Windows 上，`openclaw gateway install` 会把 Gateway 注册成计划任务，后台运行时不弹控制台窗口；不允许创建计划任务时，退回到当前用户“启动”文件夹里的登录项。查看状态可以用 `openclaw gateway status --json`。

### WSL2：Linux 兼容性最好

在 PowerShell 里安装 WSL 和 Ubuntu：

```powershell
wsl --install -d Ubuntu-24.04
```

进入 Ubuntu 后启用 systemd，Gateway 的后台服务要靠它运行：

```bash
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
```

回到 PowerShell 运行 `wsl --shutdown` 重启 WSL，再进入 Ubuntu 按 Linux 的方式安装：

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

想让 WSL 里的 Gateway 在没人登录 Windows 时也自动启动，官方 Windows 文档有单独的开机启动步骤：在 WSL 里启用 linger，再用管理员 PowerShell 创建一个计划任务。

## 已经自己管理 Node：npm、pnpm 或 bun

先确认版本：

```bash
node -v   # 需要 v24.16 以上的 24.x，或 v26.1 以上
npm -v    # 决定 npm 命令要不要加参数
```

npm 的写法取决于 npm 版本：

```bash
# npm 12，或 npm 11.16 及以上
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

# npm 11.15 及更早：同一条命令去掉 --allow-scripts=openclaw
npm install -g openclaw@latest
openclaw onboard --install-daemon
```

npm 12 默认拦截未经批准的安装脚本，`--allow-scripts=openclaw` 用来放行 OpenClaw 自己的 preinstall 和 postinstall。npm 11.16 会建议你运行 `npm approve-scripts openclaw`，这条命令对全局安装无效，会报 `ENOMATCH`，照上面加参数即可。

pnpm 和 bun：

```bash
# pnpm：全局安装不支持 approve-builds -g，要在安装时直接放行
pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemon

# bun：--trust 放行安装脚本；第二行用 Bun 运行新手引导，并把后台 Gateway 也装在 Bun 下（需要 Bun 1.4 或更新）
bun add -g --trust openclaw@latest
bun run --bun openclaw onboard --install-daemon --daemon-runtime bun
```

`openclaw onboard --install-daemon` 会在新手引导结束时把 Gateway 装成后台服务，这条路线不用再单独运行 `openclaw gateway install`。

## 新手引导与后台运行

安装脚本结束后会自动进入新手引导（onboarding），桌面应用则在第一次启动时带你走这一步。命令行里的新手引导先给一行安全指南的提示，然后让你选：

- **Quick start**：检测电脑上已登录的 Claude Code 或 Codex CLI，或者已有的 API Key，用一次真实请求验证能用，保存配置并打开网页控制界面。检测到的方式都用不了时，会转到手动配置模型服务商。
- **Custom setup**：把所有设置逐项走一遍。

以后要改设置，运行 `openclaw configure`；更习惯一步一问的旧式向导，运行 `openclaw onboard --classic`。完整流程见[官方入门文档](https://docs.openclaw.ai/start/getting-started)。

Quick start 结束时，Gateway 还在当前终端的前台运行，按 Ctrl+C 它就停了。要让它在后台常驻，先按 Ctrl+C 停掉，再装成后台服务，配置不会丢：

```bash
openclaw gateway install
```

| 系统 | `openclaw gateway install` 装成什么 |
| --- | --- |
| macOS | LaunchAgent |
| Linux、WSL2 | systemd 用户服务 |
| Windows（原生） | 计划任务；无权创建时退回“启动”文件夹登录项 |

从 Claude Code 或 Claude Desktop 转过来的，新手引导检测到后会提供导入（也可以直接运行 `openclaw onboard --flow import`），CLAUDE.md、MCP 服务器、技能和项目命令都能带过来；装好之后单独导入用 `openclaw migrate`。

## 装完怎么确认：跑三条命令，再发一条消息

用安装脚本、npm 这类命令行方式装好后，先跑三条命令，再打开控制界面发一条消息：

| 命令 | 检查什么 | 正常时 |
| --- | --- | --- |
| `openclaw --version` | 命令行能不能用 | 输出版本号 |
| `openclaw doctor` | 配置有没有问题 | 没有报出需要处理的问题 |
| `openclaw gateway status` | Gateway 是否在运行 | 显示在 18789 端口监听 |
| `openclaw dashboard` | 整条链路通不通 | 浏览器打开控制界面，发一条消息能收到 AI 回复 |

最后一步能收到回复，说明安装、模型账号和 Gateway 都没问题。桌面应用看应用里的状态，Windows Hub 是托盘图标变绿，再从 Command Center 确认连接和渠道；Docker 部署的检查方法见下一节。

没过的话按现象处理：

| 现象 | 先做什么 |
| --- | --- |
| 提示找不到 `openclaw` 命令 | 检查 PATH，命令见下方 |
| 不确定问题出在哪 | 运行 `openclaw triage` |
| Gateway 没在运行，或端口不通 | 看 [OpenClaw 端口无法监听](/zh/posts/openclaw-port-not-listening) |
| 控制界面能打开，但发消息报 401 或 429 | 看 [OpenClaw API Key 错误与速率限制排错指南](/zh/posts/openclaw-api-key-error-troubleshooting-guide) |
| 其他错误代码 | 看 [OpenClaw 错误排查中心](/zh/posts/openclaw-error-troubleshooting-center) |

找不到命令几乎都是 PATH 的问题：npm 的全局可执行目录不在 shell 的 PATH 里。用这三条定位：

```bash
node -v          # Node 装了没有
npm prefix -g    # 全局包装在哪里
echo "$PATH"     # 全局可执行目录在不在 PATH 里
```

`openclaw triage` 会做只读的健康检查，生成一份去掉密钥、令牌、原始聊天内容和原始日志的诊断说明，可以交给本机检测到的 Claude Code、Codex CLI 或 OpenClaw 自带代理继续排查；在你选定代理之前，数据不会离开你的电脑。只想自己看检查结果，就运行 `openclaw doctor`。

## Docker 与服务器：助手需要全天在线时

Gateway 在哪台机器上运行，助手就依赖哪台机器：装在笔记本上，合盖休眠期间就不会回复。要全天在线，把 Gateway 放到常开的 Linux 服务器上（直接用上面的 `install.sh`），或者用 Docker 部署。

在 Linux 服务器上用 `openclaw gateway install` 装成 systemd 用户服务后，还要运行一次 `sudo loginctl enable-linger $(whoami)`，否则 SSH 退出登录后 Gateway 不会继续运行（见[官方 Gateway 文档](https://docs.openclaw.ai/gateway)）。直接安装时 Gateway 默认只监听本机，[官方 VPS 文档](https://docs.openclaw.ai/vps)推荐的安全做法是保持这个默认，再通过 SSH 隧道或 Tailscale Serve 打开控制界面。

[Docker 部署](https://docs.openclaw.ai/install/docker)在官方文档里是可选项，适合想要一个隔离、随时可以丢弃的 Gateway 环境，或者不想在主机上装任何东西的场景；平时就在自己电脑上开发的，官方建议直接走普通安装。前提条件：

- Docker Desktop 或 Docker Engine，加 Docker Compose v2；
- 在本地从源码构建镜像时至少 6 GB 内存，用预构建镜像没有这个要求；
- 足够放镜像和日志的磁盘空间。

克隆仓库后在仓库根目录运行（后面的 `docker compose` 命令也都在这里执行）：

```bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 使用官方预构建镜像；不设这个变量会在本地构建 openclaw:local
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh
```

`setup.sh` 会自动完成新手引导：询问模型服务商的 API Key，生成 Gateway 令牌并写入 `.env`，再用 Docker Compose 启动 Gateway。完成后打开 `http://127.0.0.1:18789/`，在 Settings 里粘贴 `.env` 中的令牌。

```bash
# 忘了控制界面地址时重新打印
docker compose run --rm openclaw-cli dashboard --no-open

# 存活检查，命令不报错即说明 Gateway 活着
curl -fsS http://127.0.0.1:18789/healthz

# 使用预构建镜像时的更新
docker compose pull openclaw-gateway openclaw-cli
docker compose up -d openclaw-gateway
```

预构建镜像首先发布在 GitHub Container Registry（`ghcr.io/openclaw/openclaw`），同一版本也会同步到 Docker Hub 的 `openclaw/openclaw`。官方提醒只用这两个来源，第三方转存的镜像和官方的发布时间、保留策略都不同步。

服务器选择上，[官方安装文档](https://docs.openclaw.ai/install)列出的托管选项有 DigitalOcean、Hetzner、Hostinger、Fly.io、GCP、Azure、Railway、Northflank、Oracle Cloud、树莓派等，也可以在 Render 上声明式部署，Cloudflare Containers 模板仍是实验性的。放到公网主机之前，先读 Docker 文档前提条件里提到的安全加固说明，重点是网络暴露和 Docker 的 `DOCKER-USER` 防火墙链。

## 照旧教程装过 Clawdbot 或 Moltbot

Clawdbot、Moltbot、OpenClaw 是同一个项目先后用过的名字。麻烦在于 npm 上的旧包都还在，也没有标记弃用，照旧名安装看不到任何提醒。截至 2026 年 9 月 24 日：

| npm 包 | `latest` 指向 | 发布时间 | 装上会得到什么 |
| --- | --- | --- | --- |
| [`clawdbot`](https://www.npmjs.com/package/clawdbot) | 2026.1.24-3 | 2026 年 1 月 | 1 月的旧版，要求 Node 22.12 以上 |
| [`moltbot`](https://www.npmjs.com/package/moltbot) | 0.1.0 | 2026 年 1 月 | 这个版本不带命令行程序 |
| [`openclaw`](https://www.npmjs.com/package/openclaw) | 2026.9.6 | 2026 年 9 月 | 当前版本，要求 Node 24.16+（24.x）或 26.1+ |

![旧教程写法与现在写法对照图：clawdbot 和 moltbot 改成 openclaw，Node 22 换成 24.16+ 或 26.1+，npm 12 全局安装要加 --allow-scripts=openclaw；Clawdbot、Moltbot 时期的配置没有官方迁移路径，需重新走新手引导，2026 年 6 月之前装的 OpenClaw 先升到 2026.9.5 再升最新版](https://www.aifreeapi.com/posts/zh/openclaw-installation-guide/img/old-tutorial-fixes.webp)

旧教程要这样改：

1. 安装命令换成前面几节的 `openclaw` 安装方式。旧教程里的子命令和参数可能已经变了，以当前官方文档为准。
2. 旧配置按新安装处理。[官方迁移指南](https://docs.openclaw.ai/install/migrating)只覆盖从 Claude Code、Claude Desktop、Hermes 导入，以及把现有 OpenClaw 搬到新电脑，没有 Clawdbot、Moltbot 时期配置的迁移说明。装好 `openclaw` 后重新走一遍新手引导，模型和聊天渠道重新连接。
3. 用 npm 装过的旧包不再需要时，可以 `npm uninstall -g clawdbot` 卸掉，免得终端里同时有两套命令。
4. 以前把旧版 Gateway 装成过后台服务的，新装后如果 `openclaw gateway status` 显示端口被占用，先确认是不是旧服务还在跑。Linux 上改名前的 `clawdbot-gateway.service` 可能还留着，按[官方卸载文档](https://docs.openclaw.ai/install/uninstall)的说明，`openclaw gateway uninstall` 会识别它，并和当前的 Gateway 服务一起删除；删完运行 `openclaw gateway install` 装回当前服务。其他情况的排查见 [OpenClaw 端口无法监听](/zh/posts/openclaw-port-not-listening)。

照 2026 年 6 月之前的教程装的是 `openclaw` 包、只是版本旧的，不用重装：按下文“以后怎么更新”先过渡到 2026.9.5 再升级，旧配置和数据由 `openclaw doctor --fix` 迁移。

## 国内网络下装不上怎么办

官方文档没有专门针对国内网络的说明。安装脚本来自 openclaw.ai，OpenClaw 包来自 npm，缺 Node 时脚本还要下载 Node；Docker 和源代码方式另外要访问 GitHub（仓库和 ghcr.io 镜像）。卡在哪一步，就换掉那一步：

- **脚本卡在安装 Node 或 Homebrew**：自己先装好 Node 24.16+ 或 26.1+，再按上面的 npm 方式安装。npm 从哪个源下载取决于你的 npm 配置，可以临时加 `--registry` 指向可信的国内镜像源，例如 `npm install -g openclaw@latest --allow-scripts=openclaw --registry=https://registry.npmmirror.com`。镜像同步可能比官方源晚，装完用 `openclaw --version` 对一下版本号。
- **Windows Hub 本地设置失败**：安装 Gateway 包时网络失败是官方列出的常见原因之一，先看 Windows 一节给出的日志。
- **`git clone` 失败**：Docker 和源代码安装都要先克隆 GitHub 仓库。官方 Windows 文档提到，有些网络会屏蔽或限速到 GitHub 的 HTTPS 连接，可以换网络，或者用 VPN、HTTP/HTTPS 代理。
- **拉取 Docker 镜像太慢**：可以在网络通畅的机器上拉取官方镜像并导出，拷到目标机器导入后，用 `--offline` 运行安装脚本。这个参数会先确认镜像已在本地，不再拉取或构建。

```bash
# 在网络通畅的机器上
docker pull ghcr.io/openclaw/openclaw:latest
docker save -o openclaw-image.tar ghcr.io/openclaw/openclaw:latest

# 在目标机器的仓库根目录
docker load -i openclaw-image.tar
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh --offline
```

## 装好以后：接 Telegram、飞书和模型

- **Telegram**：只需要一个机器人令牌，官方称它是最快能接上的渠道，步骤见 [OpenClaw Telegram 设置指南](/zh/posts/openclaw-telegram-setup)。
- **飞书**：通过官方 `@openclaw/feishu` 插件接入，支持机器人私聊和群聊，默认用 WebSocket 接收事件，不需要公网地址，配置步骤见[官方飞书文档](https://docs.openclaw.ai/zh-CN/channels/feishu)。
- **换用 Kimi 模型**：见 [OpenClaw 配置 Kimi](/zh/posts/openclaw-kimi-k2-guide)。
- **让助手操作浏览器**：见 [OpenClaw 浏览器中继指南](/zh/posts/openclaw-browser-relay-guide)。
- **还在 OpenClaw 和 Claude Code 之间犹豫**：见 [OpenClaw vs Claude Code 对比指南](/zh/posts/openclaw-vs-claude-code)。

## 以后怎么更新：运行 openclaw update

日常更新运行 `openclaw update`：它会识别你是用 npm、pnpm、Bun 还是 git 装的，在旧 Gateway 继续服务时检查新版本，再切换并验证。Docker 部署按前面 Docker 一节的 pull 和 up 命令更新。

2026 年 6 月之前装的 OpenClaw，包括按 2 月前后的教程装的，不能一步升到最新版。[官方更新文档](https://docs.openclaw.ai/install/updating)要求先备份状态目录（默认 `~/.openclaw`），升到过渡版本 2026.9.5 并用 `openclaw doctor --fix` 做完迁移，再升到最新版。用 npm 安装、Gateway 装成了后台服务的，分两步执行：

```bash
# 第一步：停掉 Gateway，装过渡版本并迁移
openclaw gateway stop && npm install -g openclaw@2026.9.5 --allow-scripts=openclaw && openclaw --version && openclaw doctor --fix

# 第二步：确认上一步输出的版本是 2026.9.5、Doctor 导入旧数据时没有失败或冲突，再装最新版并启动 Gateway
npm install -g openclaw@latest --allow-scripts=openclaw && openclaw doctor --fix && openclaw gateway start && openclaw gateway status --deep
```

npm 11.15 及更早去掉 `--allow-scripts=openclaw`；pnpm、bun 的对应命令见官方更新文档。如果已经直接装了最新版，`openclaw doctor` 会在改写旧配置之前停下，提示你走同一个过渡流程。

## 常见问题

### OpenClaw 最新版本是多少？

截至 2026 年 9 月 24 日，npm 上 `openclaw` 的最新版是 2026.9.6；安装页上的桌面应用版本是 macOS 和 Linux v2026.9.5、Windows v2026.9.4。本机版本用 `openclaw --version` 查看，更新用 `openclaw update`；2026 年 6 月之前装的要先过渡到 2026.9.5，见上文“以后怎么更新”。

### 装 OpenClaw 的配置要求是什么，电脑配置要多高？

安装文档和安装页只列了 Node（24.16+ 或 26.1+）和系统（macOS 15+、Windows 10/11、Linux x64），没有给普通安装的最低内存或 CPU。Docker 文档写明，在本地从源码构建镜像时至少要 6 GB 内存，改用预构建镜像就没有这个限制。

### Windows 一定要装 WSL2 吗？

不一定。原生 PowerShell 安装和 Windows Hub 都是官方支持的方式，WSL2 只是 Linux 兼容性最好的选择。要注意 Windows Hub 的本地设置会自己建一个 WSL 发行版，电脑上的 WSL 或虚拟化被禁用时会失败，这种情况改用 PowerShell 脚本。

### 手机上能装 OpenClaw 吗？

不能把 Gateway 装在手机上。官方 [Android 应用](https://docs.openclaw.ai/platforms/android)是配套的节点应用，文档写明它不运行 Gateway；iOS 应用也是通过 WebSocket 连接局域网或 Tailscale 网络里的 Gateway。先在电脑或服务器上装好 Gateway，再用手机应用去配对。

### 用 OpenClaw 需要一直开着电脑吗？

需要让 Gateway 所在的那台机器一直开着。装在笔记本上时，合盖休眠期间助手不会回复；要全天在线，就装到常开的 Linux 服务器上，或者用 Docker 部署。