Install guide

Linux 安装 OpenClaw：从 Node 到 daemon 的完整部署

这篇教程面向 Linux 用户，按官方 CLI 路径写成一篇可直接复制命令的部署文档：先准备 Node，再安装 OpenClaw CLI，接着运行 onboard 安装 daemon，最后用 gateway status 和 doctor 验证环境。

开始安装查看官方来源

Implementation notes

Linux 上最常见的问题不是命令不能跑，而是服务状态、依赖版本和 PATH 混乱。

官方推荐 Node.js 24；22.16+ 仍受支持。

首轮只验证 CLI、daemon、Dashboard 和 doctor；先不要把机器变成高权限自动化中心。

Signal board

Runtime

Static export

Optimized for predictable Cloudflare Pages deploys.

Content model

Shared data layer

One set of structures will power homepage, lists, and showcase proof.

Editorial tone

Safer, quieter, sharper

Trust-led

Article brief

这篇文章适合谁，以及今天先解决什么

熟悉 shell，但希望用一条稳路径完成 OpenClaw 首次部署的 Linux 用户。

预计耗时

15 到 35 分钟

验证日期

2026-03-13

Image plan

图文并茂版本建议至少补这 4 张图

图 1：终端中的 Node 与 npm 版本输出。

图 2：CLI 全局安装完成。

图 3：`openclaw onboard --install-daemon` 过程。

图 4：`openclaw gateway status` 与 `openclaw doctor` 正常输出。

Before you start

安装前准备

先把环境、网络和运行时准备好，再敲第一条安装命令。

准备 1

有 sudo 权限，或至少有能力安装 Node 与全局 npm 包。

准备 2

系统能正常联网到 OpenClaw 官方资源与 npm registry。

准备 3

明确你当前使用的是 apt 系、dnf 系还是其他发行版管理器。

Hard stops

这篇教程里的停手点

以下情况先停下来排错，不要继续堆命令。

停手点 1

不要在 daemon 未运行时继续接外部服务。

停手点 2

不要混用系统包管理器安装的旧 Node 与手工安装的新 Node。

停手点 3

如果你需要 Telegram / WA 相关能力，先按 Node 路径安装，不要切 Bun。

Step by step

按官方顺序安装，别把第一天的目标搞成“大而全”。

每一步都带目的说明和可直接复制的命令。先让安装成功率稳定，再谈配置、Skills 和复杂工作流。

Step 1

步骤 1：先把 Node.js 环境装到官方建议版本

Linux 安装 OpenClaw 的第一步不是下 CLI，而是把 Node.js 装对。官方建议当前基线是 Node 24，22.16+ 也受支持。

Debian / Ubuntu 可直接用 NodeSource。

安装完后先看 `node -v` 与 `npm -v`。

如果你机器里已经有旧版 Node，先确认当前 shell 到底指向哪一套。

Copy-ready command

复制下面这组命令

建议整段复制；如果你要分步执行，先看每一步预期输出。

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash
sudo apt-get install -y nodejs
node -v
npm -v

Step 2

步骤 2：安装 CLI，先确认命令入口稳定可用

Linux 上最怕的是命令“装上了但 shell 找不到”。先让 CLI 入口稳定，再继续。

用 npm 全局安装 CLI。

安装后立刻测试 `openclaw --help`。

如果命令不可用，先检查 npm prefix 和 PATH。

Copy-ready command

复制下面这组命令

建议整段复制；如果你要分步执行，先看每一步预期输出。

npm install -g openclaw@latest
openclaw --help

Step 3

步骤 3：执行 onboard，安装 daemon 并进入起步链路

onboard 是官方第一轮安装与引导的主入口。它比零散地手装 daemon、手跑 Dashboard 更稳。

执行后优先完成引导，不要并行改太多配置。

如果系统里用了用户级 systemd，注意留意服务安装反馈。

成功后打开 Dashboard，确认起步链路已经通了。

Copy-ready command

复制下面这组命令

建议整段复制；如果你要分步执行，先看每一步预期输出。

openclaw onboard --install-daemon
openclaw dashboard

Step 4

步骤 4：把健康检查前置，避免“装好了其实不能用”

Linux 用户最容易出现“命令都能跑，但环境并不健康”的假成功。用状态与 doctor 先验收，再继续进阶。

先检查 gateway 状态。

再跑 doctor；若后续要接外部服务，再验证外部能力。

若 doctor 有阻断项，先修它，不要靠重装蒙混过去。

Copy-ready command

复制下面这组命令

建议整段复制；如果你要分步执行，先看每一步预期输出。

openclaw gateway status
openclaw doctor
openclaw doctor --verify-external-services

Verification

完成安装后，至少核对这 5 项

只有这些检查都通过，才算真的完成了第一次系统安装。

检查 1

Node 版本达到官方建议范围。

检查 2

CLI 安装完成且 `openclaw --help` 正常。

检查 3

`openclaw onboard --install-daemon` 执行成功。

检查 4

`openclaw gateway status` 返回运行中。

检查 5

`openclaw doctor` 没有阻断项。

Copy-ready command

安装完成后的统一验收命令

这组命令适合放在文末，方便用户复制做最终确认。

openclaw dashboard
openclaw gateway status
openclaw doctor

Official sources

本文只优先采信 OpenClaw 官方文档可交叉验证的信息。

涉及脚本安装、Node 版本、onboard、Dashboard、gateway 状态与健康检查的内容，都以官方文档为第一来源。

官方文档 · Installer Scripts

用于核对 `install.sh`、`install-cli.sh`、`install.ps1` 的官方安装方式与推荐场景。

https://docs.openclaw.ai/zh-CN/install/installer

官方文档 · Node.js 安装与排错

用于核对 Node.js 22.16+ / 24、PATH 与全局安装排错建议。

https://docs.openclaw.ai/zh-CN/install/node

官方文档 · Getting Started

用于核对 `openclaw onboard --install-daemon`、Dashboard、gateway 状态与最短验证链路。

https://docs.openclaw.ai/zh-CN/start/getting-started

官方文档 · Doctor & Health Check

用于核对 `openclaw doctor` 与外部服务检查方式。

https://docs.openclaw.ai/zh-CN/config/doctor-and-health-check