openclaw 本地安装

本机安装

方式1：一键安装（推荐新手）

只需在终端里粘贴这一条命令，它会自动帮你安装 Node.js 并完成 OpenClaw 的安装，省去手动配置：

macOS / Linux / WSL2：

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

这条命令做了什么？

检测你的操作系统
如果没有安装 Node.js 22+，自动帮你安装
用 npm 全局安装 OpenClaw
启动设置向导（就是下面说的 9 步）

全程自动，不需要你手动处理 Node.js 版本问题。

方式2：手动安装（已有 Node.js 22+）

如果你已经安装了 Node.js 22 或更高版本，可以直接用 npm 安装：

验证 Node.js 版本（在终端里输入）：

node --version

如果显示 v24.x.x 最佳；v22.16.x 以上也可使用。如果版本低于 22.16，请先升级 Node.js 或使用上面的方式 A（会自动处理）。

在终端里运行以下命令安装 OpenClaw：

npm install -g openclaw@latest

安装完成后，验证一下：

openclaw --version

看到版本号说明安装成功。

运行设置向导

安装好之后，运行这条命令启动设置向导：

openclaw onboard --install-daemon

--install-daemon是什么意思？ 加上这个参数，网关会自动注册为系统后台服务，电脑重启后也会自动启动，不需要每次手动开。强烈推荐加上。

根据向导设置模型apiKey, skill等，很多不确定的都可以先跳过，后续再操作

验证安装结果

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running

web使用

运行openclaw dashboard，复制 Dashboard URL 在浏览器中打开

云服务器安装

云服务器有两种方式，以腾讯云为例（其他云厂商类似，只是名字叫法不一样）

CVM 裸机
：不推荐，安装门槛很高。这类服务器属于无头环境（headless)，systemd 用户服务不可用,不做特殊设置，openclaw gateway 无法正常运行。

-轻量级服务器：强烈推荐，几乎没有门槛，直接使用龙虾应用模版

答疑

systemd user services作用

Systemd 用户服务（User Services）是 systemd 的一个重要特性，它允许普通用户（非 root）管理自己的后台服务，而不需要系统管理员权限。

为什么 OpenClaw 需要它？

OpenClaw 默认尝试使用 用户级 systemd 服务 来管理 Gateway 进程，这样：

非侵入式
— 不需要 root 权限安装系统服务
多用户友好
— 每个用户可以有自己的 OpenClaw 实例
易于管理
— 用户自己控制生命周期

在使用wsl 安装过程中，会出现如下提示：

WSL2 needs systemd enabled: edit /etc/wsl.conf with [boot]\nsystemd=true  │
│  Then run: wsl --shutdown (from PowerShell) and reopen your distro.        │
│  Verify: systemctl --user status

解决：

运行sudo nano /etc/wsl.conf，然后输入内容：

[boot]
systemd=true

按 Ctrl+O 保存，Ctrl+X 退出。
或者

运行sudo vim /etc/wsl.conf，按 i 进入插入模式，粘贴：

[boot]
systemd=true

按 Esc，输入 :wq 保存退出。