Install guide

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

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

开始安装查看官方来源

快速提示

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

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

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

你将获得

内容风格

少废话，先给结果

先告诉你该做什么、会遇到什么，再给出最短可用路径。

阅读体验

能看懂，也能照着做

重点信息会被拆成清单、步骤和提示，减少第一次上手的理解成本。

页面重点

先把关键问题讲清楚

实用优先

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