在所有部署环境中,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 用户服务,实现开机自启和崩溃自动重启。
引导向导会依次询问以下内容:
- 选择大模型提供商:用方向键选择 Anthropic 或 OpenAI,按回车
- 输入 API Key:粘贴你的密钥后回车
- 选择默认模型:推荐
claude-sonnet-4-6(性价比最优) - 网关绑定地址:务必选择
127.0.0.1(本地回环),不要选0.0.0.0 - 工作区路径:直接回车使用默认
~/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日。