如何在 Virtual Machine 上部署 OpenClaw

本文提供了在 Spaceship Virtual Machine (VM) 上部署 OpenClaw(前称 Clawdbot 或 Moltbot)的分步说明。OpenClaw 作为在 VM 上长期运行的 Gateway 服务进行部署,并通过 openclaw CLI 和 Control UI 进行管理

我们将为您讲解以下内容: 

  • 配置 VM

  • 访问 VM

  • 安装先决条件(Node.js 22+)

  • 安装 OpenClaw(推荐使用安装程序)

  • 运行引导向导并安装 Gateway 服务

  • 通过 SSH 端口转发安全地远程访问 Control UI                       

开始使用

在开始部署 OpenClaw 之前,请确保您已设置以下内容: 

  • 一个 Spaceship 账户 - 您可以在 spaceship.com

  • 已配置的 Virtual Machine

  • LTS Ubuntu 或 Debian 操作系统的最新版本

  • Node.js 22 或更高版本

  • 作为 LLM 凭证的 OAuth 或 API 密钥 - 请确保它们受向导支持,以便更顺畅地完成设置

  • 频道凭证 - 用于 Slack、Telegram、Discord 等消息频道的登录详细信息。 

第 1 步:购买并配置 VM

如果您还没有,您可以在我们的网站上购买 VM 。设置相对快捷,只需几个步骤:

  1. 选择套餐 - 为了获得可靠的性能,我们建议选择 Standard 2 套餐或更高版本。

  2. 选择操作系统 - LTS Ubuntu 或 Debian 的最新版本受到 OpenClaw 的官方支持,并因其稳定且可预测的环境而被推荐。

  3. 设置强 root 密码

  4. 添加 SSH 密钥(可选)

  5. 为您的 VM 命名

    如需进一步指导,请阅读我们的指南,了解如何购买和访问 VM。 

购买完成且配置完成后,您将能够访问 VPS Manager, 您可以在其中管理和修改您的 VM,以及部署 OpenClaw 

预付费 Spaceship VM 可享 7 天免费试用。

第 2 步:访问 VM SSH

现在,打开与您的 VM 的安全远程命令行会话。这将帮助您直接在服务器上安装和配置 OpenClaw。通过您选择的 SSH 客户端(例如 Terminal、PuTTY)经由端口 22022 使用 SSH 进行连接。

第 3 步:准备操作系统并安装 Node.js 22+

3.1 更新系统软件包

使用以下命令检查并安装所有软件更新:

apt update && apt upgrade -y

OpenClaw 需要 Node.js 22 或更高版本。不过,Ubuntu/Debian 默认不包含 Node.js。您需要先添加 NodeSource。以下是分步说明:

  1. 使用以下命令安装安全地从互联网下载文件所需的工具:

    apt install -y ca-certificates curl

  2. 将 NodeSource 添加到您系统的受信任源列表中:

    curl -fsSL https://deb.nodesource.com/setup_22.x | bash —

  3. 运行以下命令安装 Node.js 和 npm:

    apt install -y nodejs

  4. 检查 Node.js 和 npm 是否已正确安装:

    node -v
    npm -v

第 4 步:为 OpenClaw 创建专用用户

将 OpenClaw 的配置、auth 字段和工作区与 root 分开非常重要。您可以通过将 OpenClaw 添加为专用用户来实现这一点。如果 OpenClaw 出现错误、配置不当或被恶意输入欺骗,这将有助于减少影响范围。

要创建专用用户,请使用以下命令:

adduser {UserName}

然后将该用户添加到 sudo 组:

usermod -aG sudo {UserName}

最后,切换到该用户:

su - {UserName}

我们建议像对待 git 仓库一样对待您的 OpenClaw 工作区:保持其可丢弃且可恢复,这样如果代理学习到错误或被污染的上下文(例如通过提示注入),您就可以回滚。在可能的情况下,避免在机器上存储任何高度敏感的凭证。 

第 5 步:安装 OpenClaw

注意:本指南中显示的命令按原样提供,并与撰写时项目的状态一致。由于最近的命名更新和持续开发,命令名称和选项可能会发生变化。有关最新且权威的命令列表,请参阅源代码。

现在我们已经做好了准备,是时候安装 OpenClaw 了。

OpenClaw 的文档建议除非您有特定理由,否则请使用安装程序。安装程序会通过 npm 全局安装 CLI,并默认运行引导流程。

要运行安装脚本并自动安装 OpenClaw,请使用以下命令:  

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

第 6 步:运行引导流程并安装 Gateway 服务

6.1 开始引导流程

OpenClaw 建议使用引导向导进行设置。除其他项目外,它还会配置模型/auth、gateway 设置、频道、配对默认值、工作区引导以及后台服务(可选)。

安装后应自动运行引导流程。如果没有发生,或者您跳过了它,请使用以下命令重新运行: 

openclaw onboard --install-daemon

在引导过程中,您将选择:

  • 本地与远程 gateway - 对于 VM 部署,请选择 Local

  • 身份验证方法 - OAuth 或 API 密钥

  • 频道凭证 - WhatsApp 二维码登录、Telegram/Discord 令牌等。我们建议为 WhatsApp 使用一次性号码以提高安全性。

  • Daemon/服务安装 - 取决于平台使用 launchd/systemd 

建议并要求使用 Node 以确保 WhatsApp/Telegram 运行可靠;在这些情况下,不建议 Gateway 使用 Bun。

在引导过程中,请牢记以下安全最佳实践: 

  • 仅向 OpenClaw 授予您愿意在第一天就交给新承包商的资源访问权限。

  • 不要向 OpenClaw 授予对高价值个人账户的访问权限,例如主要电子邮件、银行或证券账户。

  • 对于 OpenClaw 可以访问的任何邮件,请使用专用电子邮件地址,而不是您的主收件箱。 

6.2 启用 systemd 用户服务持久化

Linux 安装使用 systemd 用户服务,默认情况下,当用户注销时该服务会停止,从而终止 gateway。  因此,您必须启用 lingering,这样在用户注销时也能让 OpenClaw 的后台服务继续运行。 

引导流程会尝试为您启用 lingering,并且可能会提示使用 sudo。但是,如果没有发生,您可以通过运行以下命令来启用 lingering:

sudo loginctl enable-linger “$USER”

第 7 步:安全地远程访问 Control UI 

默认情况下,OpenClaw 的 Gateway 被配置为绑定到回环接口,并通过 SSH 隧道或 tailnet/VPN 进行远程访问,而不是暴露公共端口。

7.1 确定您的 VM IP

在 VPS Manager 中,打开 Virtual Machine 选项卡并点击 Manage 以查看 VPS/网络详细信息,包括 IP 地址。 

7.2 从您的工作站创建 SSH 隧道

通过使用 SSH 隧道来减少攻击面,避免将 Control UI 暴露到互联网。从您的笔记本电脑/工作站(不是 VM)运行:

ssh -N -L 18789:127.0.0.1:18789 <username>@<vm-ip> -p 22022

其中 <vm-ip> 是您的 VM 公网 IP,<username> 是您在第 4 步中创建的专用用户。

7.3 在本地打开 Control UI

要访问 OpenClaw 的私有 Control UI,请在您的 VM 上运行以下命令:

openclaw dashboard

这将生成一个登录 URL(例如,http://localhost:18789/?token=1234789),您可以在浏览器中输入该 URL 以访问 Control UI 并完成引导流程。 

完成后,您就可以开始在消息频道中与 OpenClaw 交互。

第 8 步 — 端到端消息测试

最后一步是确保 OpenClaw 可以端到端正常工作。要发送测试消息,请运行: 

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

如果出现问题,请运行 openclaw doctor 并在继续之前查看所有警告。在启用任何破坏性操作(例如删除或覆盖文件、更改用户权限)之前,请检查机器人的行为和输出,以确保其行为符合预期。

需要提供有效的电子邮箱