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

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

• 不想碰命令行：在 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 日，官方安装文档、安装页和 npm 上 openclaw 包声明的要求如下：

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

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

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

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

macOS 与 Linux：一条命令安装

打开终端运行：

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

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

几个常用变体：

# 先装好，稍后再运行 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 文档支持三条路：想要图形界面选 Windows Hub，想在原生命令行里用选 PowerShell 脚本，需要和 Linux 一致的运行环境选 WSL2。

Windows Hub：图形界面

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

1. 在 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，可以看到连接、配对和渠道状态。

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

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

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

PowerShell：原生命令行

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

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

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

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

WSL2：Linux 兼容性最好

在 PowerShell 里安装 WSL 和 Ubuntu：

wsl --install -d Ubuntu-24.04

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

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

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

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

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

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

先确认版本：

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

npm 的写法取决于 npm 版本：

# 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：

# 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。完整流程见官方入门文档。

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

openclaw gateway install

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

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

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

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

没过的话按现象处理：

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

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 文档）。直接安装时 Gateway 默认只监听本机，官方 VPS 文档推荐的安全做法是保持这个默认，再通过 SSH 隧道或 Tailscale Serve 打开控制界面。

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

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

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

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 中的令牌。

# 忘了控制界面地址时重新打印
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。官方提醒只用这两个来源，第三方转存的镜像和官方的发布时间、保留策略都不同步。

服务器选择上，官方安装文档列出的托管选项有 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 日：

旧教程要这样改：

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

照 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 运行安装脚本。这个参数会先确认镜像已在本地，不再拉取或构建。

# 在网络通畅的机器上
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 设置指南。
• 飞书：通过官方 @openclaw/feishu 插件接入，支持机器人私聊和群聊，默认用 WebSocket 接收事件，不需要公网地址，配置步骤见官方飞书文档。
• 换用 Kimi 模型：见 OpenClaw 配置 Kimi。
• 让助手操作浏览器：见 OpenClaw 浏览器中继指南。
• 还在 OpenClaw 和 Claude Code 之间犹豫：见 OpenClaw vs Claude Code 对比指南。

以后怎么更新：运行 openclaw update

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

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

# 第一步：停掉 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 应用是配套的节点应用，文档写明它不运行 Gateway；iOS 应用也是通过 WebSocket 连接局域网或 Tailscale 网络里的 Gateway。先在电脑或服务器上装好 Gateway，再用手机应用去配对。

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

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