写在前面

最近在折腾一个长期运行的个人 AI 助手，最终选择了 OpenClaw 作为底座。

OpenClaw 的整体设计思路很明确：
它不是一个“网页应用”，而是一个 以 CLI + Gateway 为核心的常驻型工具，更像你服务器上的一个基础服务。

在 Linux（尤其是 Ubuntu Server）环境下，官方推荐的使用方式也很清晰：

• 全局安装 CLI
• 使用官方的 Onboarding Wizard 完成初始化
• 通过 systemd 用户级服务 让 Gateway 常驻运行

这篇文章记录一套 从零到可用、尽量少踩坑 的部署流程，适合个人服务器、家宽公网或云主机环境。

0. 部署前准备

在正式开始之前，先简单确认一下环境。

OpenClaw 对系统本身没有太多特殊要求，但下面这些是必不可少的：

• 操作系统：Ubuntu 24.04 LTS（或同级发行版）
• Node.js：22 及以上
• systemd：用于常驻 Gateway（Ubuntu 默认自带）
• 一些基础工具：
  • bash
  • curl
  • git
  • ca-certificates
  • sudo
  • lsof（用于排查端口占用）

如果你是通过 SSH 使用服务器，并且希望在退出登录后 OpenClaw 仍然继续运行，那么 loginctl linger 是后面一定要开的。

1. 安装系统必备组件

1
2
3
4
5
6
7
8

sudo apt update
sudo apt install -y \
  bash \
  curl \
  git \
  ca-certificates \
  sudo \
  lsof

2. 安装 Node.js 22（推荐 nvm）

2.1 安装 nvm

1

curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

1

source ~/.bashrc

2.2 安装并启用 Node.js 22

1
2
3
4
5

nvm install 22
nvm use 22

node -v
npm -v

3. 安装 OpenClaw

1
2

npm install -g openclaw@latest
openclaw --version

4. 运行 Doctor（强烈建议）

1

openclaw doctor

5. 使用 Onboarding 向导初始化

1

openclaw onboard --install-daemon

6. 启用 linger（非常关键）

1

sudo loginctl enable-linger <user>

7. 启动与验证

1

openclaw gateway --port 18789 --verbose

1

openclaw agent --message "hello，帮我确认你正常工作" --thinking high

8. 常用排错命令

1
2
3
4

openclaw gateway probe
systemctl --user status openclaw-gateway --no-pager
journalctl --user -u openclaw-gateway.service -n 200 --no-pager
openclaw doctor

9. 默认目录说明

1

~/.openclaw/

小结

到这里，一个 可以长期运行、可扩展、可维护的 OpenClaw 基础环境 就已经搭建完成。