本文提供了在 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 等消息频道的登录详细信息。
如果您还没有,您可以在我们的网站上购买 VM 。设置相对快捷,只需几个步骤:
选择套餐 - 为了获得可靠的性能,我们建议选择 Standard 2 套餐或更高版本。
选择操作系统 - LTS Ubuntu 或 Debian 的最新版本受到 OpenClaw 的官方支持,并因其稳定且可预测的环境而被推荐。
设置强 root 密码
添加 SSH 密钥(可选)
为您的 VM 命名
如需进一步指导,请阅读我们的指南,了解如何购买和访问 VM。
购买完成且配置完成后,您将能够访问 VPS Manager, 您可以在其中管理和修改您的 VM,以及部署 OpenClaw
现在,打开与您的 VM 的安全远程命令行会话。这将帮助您直接在服务器上安装和配置 OpenClaw。通过您选择的 SSH 客户端(例如 Terminal、PuTTY)经由端口 22022 使用 SSH 进行连接。
使用以下命令检查并安装所有软件更新:apt update && apt upgrade -y
OpenClaw 需要 Node.js 22 或更高版本。不过,Ubuntu/Debian 默认不包含 Node.js。您需要先添加 NodeSource。以下是分步说明:
使用以下命令安装安全地从互联网下载文件所需的工具:apt install -y ca-certificates curl
将 NodeSource 添加到您系统的受信任源列表中:curl -fsSL https://deb.nodesource.com/setup_22.x | bash —
运行以下命令安装 Node.js 和 npm: apt install -y nodejs
检查 Node.js 和 npm 是否已正确安装: node -vnpm -v
将 OpenClaw 的配置、auth 字段和工作区与 root 分开非常重要。您可以通过将 OpenClaw 添加为专用用户来实现这一点。如果 OpenClaw 出现错误、配置不当或被恶意输入欺骗,这将有助于减少影响范围。
要创建专用用户,请使用以下命令:
adduser {UserName}
然后将该用户添加到 sudo 组:
usermod -aG sudo {UserName}
最后,切换到该用户:
su - {UserName}
我们建议像对待 git 仓库一样对待您的 OpenClaw 工作区:保持其可丢弃且可恢复,这样如果代理学习到错误或被污染的上下文(例如通过提示注入),您就可以回滚。在可能的情况下,避免在机器上存储任何高度敏感的凭证。
注意:本指南中显示的命令按原样提供,并与撰写时项目的状态一致。由于最近的命名更新和持续开发,命令名称和选项可能会发生变化。有关最新且权威的命令列表,请参阅源代码。
现在我们已经做好了准备,是时候安装 OpenClaw 了。
OpenClaw 的文档建议除非您有特定理由,否则请使用安装程序。安装程序会通过 npm 全局安装 CLI,并默认运行引导流程。
要运行安装脚本并自动安装 OpenClaw,请使用以下命令:
curl -fsSL https://openclaw.bot/install.sh | bash
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 可以访问的任何邮件,请使用专用电子邮件地址,而不是您的主收件箱。
Linux 安装使用 systemd 用户服务,默认情况下,当用户注销时该服务会停止,从而终止 gateway。 因此,您必须启用 lingering,这样在用户注销时也能让 OpenClaw 的后台服务继续运行。
引导流程会尝试为您启用 lingering,并且可能会提示使用 sudo。但是,如果没有发生,您可以通过运行以下命令来启用 lingering:
sudo loginctl enable-linger “$USER”
默认情况下,OpenClaw 的 Gateway 被配置为绑定到回环接口,并通过 SSH 隧道或 tailnet/VPN 进行远程访问,而不是暴露公共端口。
在 VPS Manager 中,打开 Virtual Machine 选项卡并点击 Manage 以查看 VPS/网络详细信息,包括 IP 地址。
通过使用 SSH 隧道来减少攻击面,避免将 Control UI 暴露到互联网。从您的笔记本电脑/工作站(不是 VM)运行:
ssh -N -L 18789:127.0.0.1:18789 <username>@<vm-ip> -p 22022
其中 <vm-ip> 是您的 VM 公网 IP,<username> 是您在第 4 步中创建的专用用户。
要访问 OpenClaw 的私有 Control UI,请在您的 VM 上运行以下命令:
openclaw dashboard
这将生成一个登录 URL(例如,http://localhost:18789/?token=1234789),您可以在浏览器中输入该 URL 以访问 Control UI 并完成引导流程。
完成后,您就可以开始在消息频道中与 OpenClaw 交互。
最后一步是确保 OpenClaw 可以端到端正常工作。要发送测试消息,请运行:
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
如果出现问题,请运行 openclaw doctor 并在继续之前查看所有警告。在启用任何破坏性操作(例如删除或覆盖文件、更改用户权限)之前,请检查机器人的行为和输出,以确保其行为符合预期。