openclaw 安装

0 阅读2分钟

image.png

本机安装

方式1:一键安装(推荐新手)

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

macOS / Linux / WSL2:

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

这条命令做了什么?

  1. 检测你的操作系统
  2. 如果没有安装 Node.js 22+,自动帮你安装
  3. 用 npm 全局安装 OpenClaw
  4. 启动设置向导(就是下面说的 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 无法正常运行。

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

image.png

答疑

systemd user services作用

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

为什么 OpenClaw 需要它?

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

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

在使用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 保存退出。