Install：先把这条路走顺

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

很多文档看起来长，其实是在防你漏掉前置条件。

真正照做时，先找前置条件，再找必填项，最后看验证方法。

这一串条目别硬背，把它当成“System requirements”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：**Node 24** (recommended) or Node 22.19+…、**macOS, Linux, or Windows** - both nativ…、pnpm is only needed if you build from sou…。

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

很多文档看起来长，其实是在防你漏掉前置条件。

真正照做时，先找前置条件，再找必填项，最后看验证方法。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The fastest way to install. It detects your OS, installs Node if needed, installs OpenClaw, and launches onboarding.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Tabs。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：macOS / Linux / WSL2。

这一小段像旁白，在提醒我们镜头已经切到下一站。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Windows (PowerShell)。

这一小段像旁白，在提醒我们镜头已经切到下一站。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：To install without running onboarding:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Tabs。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：macOS / Linux / WSL2。

这一小段像旁白，在提醒我们镜头已经切到下一站。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Windows (PowerShell)。

这一小段像旁白，在提醒我们镜头已经切到下一站。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：For all flags and CI/自动小闹钟 options, see Installer internals.

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Use this when you want OpenClaw and Node kept under a local prefix such as ~/.openclaw, without depending on a system-w…。

这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。

• 这里在给“curl -fsSL https”挂牌子，告诉系统它该指向“//openclaw.ai/install-cli.sh | bash”。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：It supports npm installs by default, plus git-checkout installs under the same prefix flow. Full reference: Installer i…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Already installed? Switch between package and git installs with openclaw update --消息通道 dev and openclaw update --消息通道 s…。

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If you already manage Node yourself:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Tabs。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：npm。

这一小段像旁白，在提醒我们镜头已经切到下一站。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Note。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The hosted installer clears npm freshness filters such as min-release-age for the OpenClaw package install. If you inst…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：pnpm。

这一小段像旁白，在提醒我们镜头已经切到下一站。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Note。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：pnpm requires explicit approval for packages with build scripts. Run pnpm approve-builds -g after the first install.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：bun。

这一小段像旁白，在提醒我们镜头已经切到下一站。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Note。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Bun is supported for the global CLI install path. For the 门口的小门卫 runtime, Node remains the recommended daemon runtime.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Troubleshooting: sharp build errors (npm)。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If sharp fails due to a globally installed libvips:。

这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。

• 这一行“SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest”是在给电脑递一张小纸条，告诉它眼下该做哪一步。

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

很多文档看起来长，其实是在防你漏掉前置条件。

真正照做时，先找前置条件，再找必填项，最后看验证方法。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：For contributors or anyone who wants to run from a local checkout:。

这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。

• 这里在给“git clone https”挂牌子，告诉系统它该指向“//github.com/openclaw/openclaw.git”。
• 这一行“cd openclaw”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
• 这里在给“pnpm install && pnpm build && pnpm ui”挂牌子，告诉系统它该指向“build”。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Or skip the link and use pnpm openclaw ... from inside the repo. See Setup for full development workflows.

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

很多文档看起来长，其实是在防你漏掉前置条件。

真正照做时，先找前置条件，再找必填项，最后看验证方法。

这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。

• 这里在给“curl -fsSL --proto =https --tlsv1.2 https”挂牌子，告诉系统它该指向“//openclaw.ai/install.sh | bash -s -- --install-method git --version main”。

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

很多文档看起来长，其实是在防你漏掉前置条件。

真正照做时，先找前置条件，再找必填项，最后看验证方法。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Card大家一起的房间。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Docker。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Containerized or headless deployments.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Podman。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Rootless container alternative to Docker.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Nix。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Declarative install via Nix flake.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Ansible。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Automated fleet provisioning.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Bun。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：CLI-only usage via the Bun runtime.

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

很多文档看起来长，其实是在防你漏掉前置条件。

真正照做时，先找前置条件，再找必填项，最后看验证方法。

这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。

• 这一句是在直接叫 OpenClaw 动起来：“openclaw --version # confirm the CLI is available”。你可以把它想成一句说出口就要执行的差事。
• 这一句是在直接叫 OpenClaw 动起来：“openclaw doctor # check for config issues”。你可以把它想成一句说出口就要执行的差事。
• 这一句是在直接叫 OpenClaw 动起来：“openclaw gateway status # verify the Gateway is running”。你可以把它想成一句说出口就要执行的差事。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If you want managed startup after install:。

这一串条目别硬背，把它当成“Verify the install”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：macOS: Launch机器人朋友 via openclaw onboard -…、Linux/WSL2: systemd user service via the…、Native Windows: Scheduled Task first, wit…。

这一节主要在解释“Hosting and deployment”到底是干什么的，以及你什么时候会遇到它。

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Deploy OpenClaw on a cloud 大房子服务器 or VPS:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Card大家一起的房间。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：VPS Any Linux VPS。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Docker VM Shared Docker steps。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Kubernetes K8s。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Fly.io Fly.io。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Hetzner Hetzner。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：GCP Google Cloud。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Azure Azure。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Railway Railway。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Render Render。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Northflank Northflank。

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

很多文档看起来长，其实是在防你漏掉前置条件。

真正照做时，先找前置条件，再找必填项，最后看验证方法。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Card大家一起的房间。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Updating。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Keep OpenClaw up to date.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Migrating。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Move to a new machine.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Uninstall。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Remove OpenClaw completely.

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

很多文档看起来长，其实是在防你漏掉前置条件。

真正照做时，先找前置条件，再找必填项，最后看验证方法。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If the install succeeded but openclaw is not found in your terminal:。

这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。

• 这一行“node -v # Node installed?”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
• 这一句像在终端上按下启动钮：“npm prefix -g # Where are global packages?”。它会让电脑去请求、安装或者把东西搭起来。
• 这一行“echo "$PATH" # Is the global bin dir in PATH?”是在给电脑递一张小纸条，告诉它眼下该做哪一步。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If $(npm prefix -g)/bin is not in your $PATH, add it to your shell startup file (~/.zshrc or ~/.bashrc):。

这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。

• 这里在给“export PATH=$(npm prefix -g)/bin”挂牌子，告诉系统它该指向“$PATH”。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Then open a new terminal. See Node setup for more details.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：---。