在所有部署环境中,Linux 是运行 OpenClaw 最稳定、最主流的选择。没有 GUI 的负担、原生 systemd 服务支持、极低的资源占用——2026年,绝大多数专业级 OpenClaw 实例都跑在 Linux 服务器或 VPS 上。

本文以 Ubuntu 24.04 LTS 为例(Debian、Fedora、Arch 等主流发行版步骤基本相同),带你用最简单的方式完成从零到运行的全流程部署。

部署前准备

开始之前,确认以下条件已就绪:

  • 服务器配置:至少 2GB RAM、1 vCPU,推荐 Ubuntu 24.04 LTS(支持至2029年)
  • SSH 访问权限:能通过终端连接到服务器(本地 Linux 桌面用户直接打开终端即可)
  • 大模型 API Key:推荐 Anthropic Claude(访问 console.anthropic.com 创建)或 DeepSeek(费用更低)
  • 通讯平台账号:准备一个 Telegram 账号用于初次连接测试(最容易配置)

⚠️ 安全提示:切勿以 root 用户身份运行 OpenClaw。请创建一个独立的普通用户专门用于运行 OpenClaw 服务,这是最基本的安全实践。

第一步:系统初始化

连接到服务器后,先更新系统并安装必要基础工具:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget build-essential ufw

同时启用防火墙并开放 SSH 端口:

sudo ufw allow OpenSSH
sudo ufw enable

运行 sudo ufw status 确认防火墙已启用。

第二步:安装 Node.js(推荐使用 nvm)

OpenClaw 需要 Node.js 22.16 或以上版本。在 Linux 上最推荐用 nvm(Node 版本管理器)安装,方便日后升级和多版本共存:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 24
nvm use 24

验证安装结果:

node --version
# 应输出 v24.x.x

如果你使用系统包管理器安装 Node.js(如 apt install nodejs),请注意 Ubuntu 默认仓库中的版本可能偏低,建议通过 nvm 或 NodeSource 仓库安装最新版。

第三步:一键安装 OpenClaw

Node.js 就绪后,使用官方安装脚本一键完成安装。这是最简单、最推荐的方式:

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

等待出现”Installation finished successfully!”提示。安装完成后刷新 shell 环境:

source ~/.bashrc

验证安装:

openclaw --version

看到版本号输出即表示安装成功。如果偏好手动控制,也可以用 npm 全局安装:

npm install -g openclaw@latest

第四步:运行引导向导完成配置

这是整个部署流程的核心步骤。运行以下命令启动官方引导程序:

openclaw onboard --install-daemon

--install-daemon 参数会在引导结束后自动将 OpenClaw 注册为 systemd 用户服务,实现开机自启和崩溃自动重启。

引导向导会依次询问以下内容:

  1. 选择大模型提供商:用方向键选择 Anthropic 或 OpenAI,按回车
  2. 输入 API Key:粘贴你的密钥后回车
  3. 选择默认模型:推荐 claude-sonnet-4-6(性价比最优)
  4. 网关绑定地址:务必选择 127.0.0.1(本地回环),不要选 0.0.0.0
  5. 工作区路径:直接回车使用默认 ~/openclaw/workspace

向导完成后,终端会显示你的 Gateway Token,请立即复制保存——这是登录控制面板的唯一凭证。

第五步:确保 24小时持续运行(关键步骤)

Linux 默认会在用户注销 SSH 后停止其用户服务。要让 OpenClaw 在你断开连接后依然持续运行,需要启用 用户驻留(lingering)

sudo loginctl enable-linger $USER

这条命令确保即使你退出 SSH,OpenClaw 的 systemd 用户服务仍然保持运行。

检查服务状态:

systemctl --user status openclaw-gateway

看到 Active: active (running) 即表示服务正常运行。常用管理命令:

# 重启服务
systemctl --user restart openclaw-gateway

# 查看实时日志
journalctl --user -u openclaw-gateway -f

# 检查整体健康状态
openclaw doctor

第六步:配置防火墙保护控制面板

OpenClaw 的控制面板运行在端口 18789,绝对不能对公网开放。确认防火墙规则正确:

sudo ufw status numbered

正常情况下,18789 端口不应出现在允许列表中。如果误将其开放,立即关闭:

sudo ufw deny 18789

需要从本地浏览器访问控制面板时,通过 SSH 隧道端口转发即可,无需开放公网端口:

ssh -L 18789:127.0.0.1:18789 用户名@服务器IP

然后在本地浏览器访问 http://127.0.0.1:18789,输入 Gateway Token 登录。

第七步:连接 Telegram 完成首次测试

控制面板登录后,按以下步骤连接 Telegram:

1. 创建 Telegram Bot:打开 Telegram,搜索 @BotFather,发送 /newbot,按提示命名后获得 Bot Token。

2. 在控制面板绑定:进入”Channels”页面,选择 Telegram,粘贴 Bot Token,保存。

3. 完成配对:在 Telegram 中找到你的机器人,点击”Start”,系统返回配对码,在控制面板确认即完成绑定。

发送”你好”测试,OpenClaw 响应即表示部署全部成功。

更新与维护

OpenClaw 迭代频繁,建议定期更新获取安全补丁:

openclaw update --channel stable
systemctl --user restart openclaw-gateway

定期备份配置和记忆数据:

cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)

常见问题排查

Q:运行 openclaw 提示”command not found”?
运行 source ~/.bashrc 刷新环境变量。若仍报错,检查 echo $PATH 中是否包含 nvm 的 bin 目录。

Q:SSH 断开后服务自动停止?
确认已运行 sudo loginctl enable-linger $USER,然后重启服务。

Q:虚拟机(VMware/VirtualBox)中遇到 systemd 报错?
VM 环境中 systemd 用户会话有时未完整初始化。尝试:

systemctl --user daemon-reload
systemctl --user enable openclaw-gateway
systemctl --user start openclaw-gateway

Q:端口 18789 被占用?
编辑 ~/.openclaw/openclaw.json,修改 gateway.port 为其他端口(如 18790),重启服务。

Q:引导向导误选了 0.0.0.0 怎么补救?
编辑 ~/.openclaw/openclaw.json,将 gateway.host 改为 127.0.0.1,重启服务。

为什么 Linux VPS 是 OpenClaw 的最佳搭档?

很多用户最初在笔记本上测试,很快发现电脑关机就等于 OpenClaw 停止。花约 $6~$10 / 月 租一台 Linux VPS,能解决以下全部问题:24小时不间断运行、Heartbeat 定时任务真正生效、与个人设备完全隔离、随时 SSH 远程管理。

国内用户可考虑 Hetzner(欧洲节点、性价比高)、Vultr 或 DigitalOcean,均提供 Ubuntu 24.04 LTS 镜像,照本文步骤直接部署即可。

部署完成后可以做什么?

  • 在控制面板安装更多 Skills 技能模块扩展能力
  • 配置 Heartbeat 心跳任务实现每日自动推送日报
  • 连接微信、WhatsApp、Slack 等更多通讯平台
  • 设置定时备份脚本保护记忆数据

想了解更多配置细节,访问 OpenClaw官网中文版(通过浏览器翻译访问 openclaw.ai)或官方文档 docs.openclaw.ai

本文安装步骤基于 OpenClaw 官方文档、cloudfromscratch.hashnode.dev、medium.com 等公开资料整理,以 Ubuntu 24.04 LTS 为主要测试环境,信息截至2026年3月28日。