openclaw doctor 正常
说明基础环境已经进入可用状态。
安装部署 / Linux
这篇只做一件事:带你用官方主路线把 OpenClaw 安装到 Linux 或云服务器上,并用更安全的方式访问 Dashboard。目标不是“公网裸开”,而是“能长期稳定跑起来”。
服务器安装真正容易出问题的,不是命令本身,而是运行方式和访问方式。
你可以先扫一眼,再往下按步骤做。
先通过 SSH 登录你的服务器:
ssh your_user@your_server_ip
然后更新系统软件包。Ubuntu / Debian 执行:
sudo apt update && sudo apt upgrade -y
如果你用的是 RHEL 系发行版,则改用:
sudo dnf update -y
这一步不是 OpenClaw 特有要求,但对减少依赖问题和 SSL 问题很有帮助。
在服务器终端里直接执行:
curl -fsSL https://openclaw.ai/install.sh | bash
如果系统没有 curl,先补装:
sudo apt install curl -y
然后再重新运行官方安装脚本。这里建议优先用官方地址,不要把第三方镜像脚本当作默认主路线。
服务器场景里最容易卡住的,通常也是网络。你如果已经有代理能力,可以先临时设置:
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
然后重新执行安装脚本。这里的端口按你的实际环境替换。
官方安装脚本通常会直接进入 onboarding。如果没有自动进入,可以手动执行:
openclaw onboard --install-daemon
这一步更适合长期运行场景,因为它会把 Gateway 和基础服务准备好。
安装完成后,先在服务器里确认系统状态:
openclaw doctor
openclaw gateway status
如果你需要持续看日志,可以执行:
openclaw logs --follow
这一步确认的是:系统不是只装完了命令,而是已经具备运行状态。
这是服务器部署最关键的一步。官方建议不要把 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
真正的成功标准不是端口开放了,而是系统进入了稳定可管理状态。
openclaw doctor 正常说明基础环境已经进入可用状态。
openclaw gateway status 正常说明 Gateway 已经运行,不只是装完一个命令。
说明你已经能从本地安全访问服务器上的 Dashboard。
这才算真正跨过了服务器安装阶段。
大多数问题都集中在访问方式、PATH、服务状态和日志上。
openclaw gateway status。
npm prefix -g 和 echo "$PATH"。
openclaw onboard --install-daemon,或者后续显式安装 Gateway 服务。
openclaw logs --follow,别盲猜是不是模型或渠道出了问题。
这几条命令基本覆盖了日常状态检查和维护。
openclaw doctor
openclaw gateway status
openclaw gateway restart
openclaw logs --follow
openclaw update
如果你的目标是让 OpenClaw 24 小时在线,Linux / 服务器是最稳的一条路。关键不是“把端口直接开到公网”,而是让 Gateway 稳定运行,并通过 SSH 隧道或类似方式安全访问。