ubuntu22.04怎么安装openclaw

在 Ubuntu 22.04 上，官方推荐的安装方式是直接跑 OpenClaw 的安装脚本；它会自动处理 Node 检测、安装 CLI，并启动 onboarding 向导。OpenClaw 运行时要求 Node 22 或更高版本，Linux 上推荐用 Node，不推荐 Bun 跑 Gateway。

最简单安装方式

先在 Ubuntu 22.04 里执行：

bash 复制代码

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

安装完成后，运行初始化向导：

bash 复制代码

openclaw onboard --install-daemon

这个向导会帮你配置认证、Gateway 设置，以及可选的渠道接入；加上 --install-daemon 后，还会安装 Gateway 后台服务。

⸻

安装完成后怎么检查

查看 Gateway 是否正常：

bash 复制代码

openclaw gateway status

打开控制台：

bash 复制代码

openclaw dashboard

如果本机是图形界面环境，通常可以直接打开控制 UI；如果是远程服务器，官方 Linux VPS 路径建议你把远端 18789 端口通过 SSH 隧道映射回本机，再在本机浏览器打开：

bash 复制代码

ssh -N -L 18789:127.0.0.1:18789 <user>@<host>

然后访问：

bash 复制代码

http://127.0.0.1:18789/

⸻

如果你想手动安装，而不是跑官方脚本

先确认 Node 版本：

bash 复制代码

node -v

如果不是 v22.x 或更高，先装 Node 22：

bash 复制代码

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

然后安装 OpenClaw CLI：

bash 复制代码

sudo npm install -g openclaw@latest

再执行初始化：

bash 复制代码

openclaw onboard --install-daemon

这些步骤和官方 Linux 路径一致。

⸻

如果你是在纯命令行服务器上安装，容易遇到的坑

有些 headless 服务器里，openclaw gateway status 或 openclaw gateway install 可能会因为 user-level systemd / D-Bus 没准备好而失败，典型报错是：

bash 复制代码

Failed to connect to bus: No medium found

GitHub 上已有相关问题记录。常见修复方式是：

bash 复制代码

sudo loginctl enable-linger $(whoami)
echo 'export XDG_RUNTIME_DIR=/run/user/$(id -u)' >> ~/.bashrc
source ~/.bashrc

然后再重试：

bash 复制代码

openclaw gateway install --force
openclaw gateway status

这个问题更常见在纯 SSH 登录、无桌面、无完整 user systemd 会话的云主机环境。

⸻

我建议你在 Ubuntu 22.04 上直接按这个顺序来

1) 更新系统

bash 复制代码

sudo apt update

2) 跑官方安装脚本

bash 复制代码

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

3) 初始化并安装后台服务

bash 复制代码

openclaw onboard --install-daemon

4) 检查状态

bash 复制代码

openclaw gateway status

如果第 4 步报 systemctl --user unavailable 或 No medium found，再补：

bash 复制代码

sudo loginctl enable-linger $(whoami)
echo 'export XDG_RUNTIME_DIR=/run/user/$(id -u)' >> ~/.bashrc
source ~/.bashrc
openclaw gateway install --force
openclaw gateway status

⸻

额外说明

如果你这台 Ubuntu 22.04 是阿里云/腾讯云服务器，通常更适合走 Linux VPS 方式，也就是：

服务器上装 OpenClaw
本地电脑用 SSH 隧道访问 127.0.0.1:18789
不直接把控制端口裸露到公网

这也更符合官方 Linux 文档的使用方式。