OpenClaw Docs CN

安装部署 / Linux

Linux / 服务器

Linux / Server Install

如果你想长期在线运行,Linux 和云服务器是最稳的一条路。

这篇只做一件事:带你用官方主路线把 OpenClaw 安装到 Linux 或云服务器上,并用更安全的方式访问 Dashboard。目标不是“公网裸开”,而是“能长期稳定跑起来”。

长期运行推荐 10-20 分钟 服务器安全优先
Before You Start

开始前先记住这 4 件事

服务器安装真正容易出问题的,不是命令本身,而是运行方式和访问方式。

官方主路线依然是安装脚本 这篇不走源码,不走容器,先把 Linux 主机安装这条最稳的路跑通。
Ubuntu / Debian 最省心 如果你现在才选服务器系统,优先 Ubuntu 或 Debian,社区经验最多,维护也最轻松。
Dashboard 不要直接暴露到公网 服务器场景优先 SSH 隧道或 Tailscale,不建议直接开放 18789 给全网访问。
先跑通,再谈高可用 第一次部署的目标是先让 Gateway 正常、Dashboard 可访问,不用一开始就把所有高级优化做满。
Overview

服务器安装的顺序就是这样

你可以先扫一眼,再往下按步骤做。

01 登录服务器并更新系统 先把运行环境整理干净,再开始安装。
02 运行官方安装脚本 让系统自动处理 Node 检测和 OpenClaw 安装。
03 完成 onboarding 把 Gateway 和基础配置准备好。
04 检查服务状态 确认不是只装了命令,而是系统真的已经在运行。
05 通过安全方式访问 Dashboard 优先 SSH 隧道,而不是直接开公网端口。

第 1 步:登录服务器并更新系统

先通过 SSH 登录你的服务器:

ssh your_user@your_server_ip

然后更新系统软件包。Ubuntu / Debian 执行:

sudo apt update && sudo apt upgrade -y

如果你用的是 RHEL 系发行版,则改用:

sudo dnf update -y

这一步不是 OpenClaw 特有要求,但对减少依赖问题和 SSL 问题很有帮助。

第 2 步:运行官方安装脚本

在服务器终端里直接执行:

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

如果系统没有 curl,先补装:

sudo apt install curl -y

然后再重新运行官方安装脚本。这里建议优先用官方地址,不要把第三方镜像脚本当作默认主路线。

第 3 步:如果下载慢,先准备代理

服务器场景里最容易卡住的,通常也是网络。你如果已经有代理能力,可以先临时设置:

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

然后重新执行安装脚本。这里的端口按你的实际环境替换。

第 4 步:完成 onboarding

官方安装脚本通常会直接进入 onboarding。如果没有自动进入,可以手动执行:

openclaw onboard --install-daemon

这一步更适合长期运行场景,因为它会把 Gateway 和基础服务准备好。

第 5 步:检查环境和服务状态

安装完成后,先在服务器里确认系统状态:

openclaw doctor
openclaw gateway status

如果你需要持续看日志,可以执行:

openclaw logs --follow

这一步确认的是:系统不是只装完了命令,而是已经具备运行状态。

第 6 步:用更安全的方式访问 Dashboard

这是服务器部署最关键的一步。官方建议不要把 OpenClaw UI 直接暴露到公网,而是优先走 SSH 隧道或 Tailscale。

先在服务器里执行:

openclaw dashboard --no-open

然后在你自己的本地电脑上建立 SSH 隧道:

ssh -N -L 18789:127.0.0.1:18789 your_user@your_server_ip

接着在你的本地浏览器打开:

http://127.0.0.1:18789/

如果页面要求 Token,可以在服务器上执行:

openclaw config get gateway.auth.token
Success Check

怎样才算服务器部署成功

真正的成功标准不是端口开放了,而是系统进入了稳定可管理状态。

openclaw doctor 正常

说明基础环境已经进入可用状态。

openclaw gateway status 正常

说明 Gateway 已经运行,不只是装完一个命令。

SSH 隧道能正常连通

说明你已经能从本地安全访问服务器上的 Dashboard。

Dashboard 能在本地浏览器打开

这才算真正跨过了服务器安装阶段。

Troubleshooting

服务器部署先查这 4 类问题

大多数问题都集中在访问方式、PATH、服务状态和日志上。

浏览器打不开 Dashboard 先确认是不是忘了做 SSH 隧道,再检查 openclaw gateway status
装完找不到 openclaw 命令 通常是 PATH 问题,先检查 npm prefix -gecho "$PATH"
想长期后台运行 优先使用 openclaw onboard --install-daemon,或者后续显式安装 Gateway 服务。
想看实时日志 直接用 openclaw logs --follow,别盲猜是不是模型或渠道出了问题。
Common Commands

以后在服务器上最常用的几个命令

这几条命令基本覆盖了日常状态检查和维护。

openclaw doctor
openclaw gateway status
openclaw gateway restart
openclaw logs --follow
openclaw update

一句话总结

如果你的目标是让 OpenClaw 24 小时在线,Linux / 服务器是最稳的一条路。关键不是“把端口直接开到公网”,而是让 Gateway 稳定运行,并通过 SSH 隧道或类似方式安全访问。