在 Ubuntu 服务器上部署 OpenClaw：养一个 7×24 小时的私人 AI 助手

2026 年自托管圈最火的项目非 OpenClaw 莫属——就是那个前身叫 Clawdbot、年初在 GitHub 上火箭般蹿升的开源 AI 助手。它和网页版 ChatGPT 的本质区别是：它是一个常驻你服务器的 Gateway 进程，连接 Telegram、WhatsApp、Discord 等 50 多个消息平台，有持久记忆，能主动推送提醒，关掉浏览器它照样活着干活。

这篇是部署篇：把它装进我们的 Ubuntu 服务器，让 Gateway 稳定常驻。下篇再讲接入 Telegram 和具体玩法。

部署前先想清楚三件事

1. 模型从哪来。 OpenClaw 本身只是「网关+大脑骨架」，思考能力来自外部 LLM。两条路：接云端 API（Anthropic、OpenAI、OpenRouter 等，按 token 付费），或者复用你本机已有的 Claude Code / Codex CLI 登录（onboarding 能自动检测并复用）。这篇以 API Key 方式为例。

2. 跑在哪台机器上。 OpenClaw 本体很轻（Node.js 进程），真正的算力在云端模型那边，所以家里那台小主机完全够。想 7×24 在线就放常开的服务器上。

3. 端口别裸奔。 Gateway 默认监听 18789 端口，这个管理入口不应该暴露公网。我们之前的文章正好派上用场：要么走 Tailscale 虚拟内网，要么 Nginx 反代 + HTTPS。

第一步：装 Node.js

OpenClaw 要求 Node.js 22.22.3+（官方推荐 Node 26）。Ubuntu 仓库的版本太旧，用 NodeSource 源：

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version    # 确认 >= 22.22.3

第二步：安装并初始化

官方一键脚本（Linux / macOS 通用）：

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

安装脚本会自动检测系统环境、装好 CLI，然后自动进入 onboarding 向导。两条路：

• Quick start：检测到本机已有 Claude Code / Codex CLI 登录或 API Key 时，自动复用、做一次真实调用验证、保存配置，然后直接打开 Web 控制台。适合大多数情况。
• Custom setup：完整引导流程，手动配置 provider、渠道、技能。

第一次跑 Gateway 会停在前台，终端里能看到日志。验证一下：

openclaw gateway status
# 应显示 Gateway 监听在 18789 端口

openclaw dashboard
# 打开 Web 控制台（Control UI）

在控制台的聊天框发一句话，收到 AI 回复，说明大脑接通了。

第三步：常驻后台

前台进程 SSH 一断就没了，装成系统服务：

# Ctrl+C 停掉前台进程，然后：
openclaw gateway install

之后 Gateway 就由系统托管，开机自启、崩溃自动拉起。日常管理：

openclaw gateway status     # 看状态
openclaw gateway restart    # 重启（改配置后）

第四步：体检与排障

OpenClaw 自带两个诊断工具，非常贴心：

openclaw doctor    # 只读体检，输出当前配置的问题
openclaw triage    # 更进一步：生成诊断报告，可一键交给本机的编码 Agent 处理

triage 生成的报告会剔除密钥和聊天内容，可以放心用。

安全基线（重要）

AI 助手和普通 Web 服务不一样——它能执行命令、读写文件，权限给大了就是一个会自己动手的后门。部署阶段先守住三条底线：

• 18789 端口不暴露公网：只监听本机，通过 Tailscale 或 Nginx 反代（加认证）访问控制台。
• API Key 只给它需要的权限：单独建一个 Key，设置用量上限，防止异常调用刷爆账单。
• 配置文件权限收紧：配置和密钥默认在 ~/.openclaw/ 目录下，确认权限是 600/700，别共享这个目录。

常见问题

现象	原因与解决
安装脚本报 Node 版本不符	换 NodeSource 源装 Node 22.22.3+，Ubuntu 自带源版本太旧
onboarding 找不到可用模型	本机没有可复用的 CLI 登录，走 Custom setup 手动填 API Key
openclaw 命令找不到	安装脚本改了 PATH 但当前会话没刷新，重开终端或 source ~/.bashrc
控制台打不开	检查 openclaw gateway status；防火墙拦了 18789；远程服务器上要用 SSH 端口转发（ssh -L 18789:localhost:18789 服务器）先验证

小结

到这里，一个常驻的 AI Gateway 就在你服务器上跑着等你差遣了：

# 整个部署浓缩版
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
curl -fsSL https://openclaw.ai/install.sh | bash
# 走完 onboarding 后：
openclaw gateway install

但目前它还只能在 Web 控制台里对话——还不够「助手」。下一篇进入真正好玩的部分：接入 Telegram，让它住进你的手机，顺便玩几个自动化场景。

参考：OpenClaw 官方文档