Skip to content
OpenClaw 书稿预览

第16章 部署与运维：从本地到服务器

🎯 本章目标：学完这章，你能把 OpenClaw 部署到服务器并稳定运行

⏱️ 预计时间：30分钟

📋 前置要求：已完成前15章

本章你将学会什么

Section titled “本章你将学会什么”
  • 本地与云主机的选择方法
  • 官方推荐的部署步骤
  • 远程访问（SSH 隧道 / Tailscale）
  • 服务守护、状态检查与日志排查
  • 备份、升级与回滚

16.1 本地还是上云：怎么选

Section titled “16.1 本地还是上云：怎么选”

16.1.1 先看你的使用强度

Section titled “16.1.1 先看你的使用强度”

如果你是个人学习、偶尔用一用，本地就够。
如果你要每天用、多人用、或者希望它全天在线，建议上云。

16.1.2 一个实用判断表

Section titled “16.1.2 一个实用判断表”
场景推荐
个人学习、偶尔使用本地运行
每天使用，要求 7×24 在线云主机
团队多人共用云主机
预算有限但想常驻先本地守护，后续迁移云主机

16.1.3 云主机最低建议

Section titled “16.1.3 云主机最低建议”
  • 系统：Ubuntu 24.04 LTS（官方平台文档示例）
  • 规格：至少 1 vCPU / 1GB 内存（轻量可跑）
  • 网络：能稳定访问模型与渠道 API

16.2 官方推荐部署路径（最稳）

Section titled “16.2 官方推荐部署路径（最稳）”

先给你一个“小白不迷路顺序”（照着做就行）：

  1. 安装
  2. 体检
  3. 向导初始化
  4. 状态验证

别跳步骤，尤其不要直接跳过 doctor。

16.2.1 安装 OpenClaw

Section titled “16.2.1 安装 OpenClaw”

在服务器终端执行：

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

操作提醒：这一段命令要在服务器终端执行，不是在你本机终端执行；很多人会在这一步跑错环境。

安装后先确认版本：

Terminal window
openclaw --version

16.2.2 体检与初始化

Section titled “16.2.2 体检与初始化”

先做体检：

Terminal window
openclaw doctor

如果这里提示修复建议，先修完再继续；
不要抱着“先往下走走看”的心态硬跳过，这一步能省掉后面大量排障时间。

再跑初始化向导并安装守护服务：

Terminal window
openclaw onboard --install-daemon

16.2.3 启动后验证

Section titled “16.2.3 启动后验证”
Terminal window
openclaw status
Terminal window
openclaw gateway status
Terminal window
openclaw channels status --probe

这里的 --probe 可以理解成“做一次连通性体检”：
它会主动探测渠道是否连得上、凭证是否可用，而不只是静态显示配置。

16.3 服务守护与运维命令

Section titled “16.3 服务守护与运维命令”

16.3.1 服务生命周期管理

Section titled “16.3.1 服务生命周期管理”

优先使用 OpenClaw 自带命令，不建议新手自己手写 systemd/launchd：

Terminal window
openclaw gateway install
Terminal window
openclaw gateway start
Terminal window
openclaw gateway stop
Terminal window
openclaw gateway restart
Terminal window
openclaw gateway status

16.3.2 日志与日常排查

Section titled “16.3.2 日志与日常排查”
Terminal window
openclaw logs --follow

实操建议：

  • 前台调试优先：openclaw gateway
  • 常驻运行优先：gateway install + status
  • 排障顺序优先：先 status，再 logs

16.4 远程访问：两条主路径

Section titled “16.4 远程访问：两条主路径”

16.4.1 路径A：SSH 隧道（最通用）

Section titled “16.4.1 路径A：SSH 隧道（最通用）”

在本地电脑执行：

Terminal window
ssh -N -L 18789:127.0.0.1:18789 user@server

操作提醒：这条 SSH 隧道命令要在你的本地电脑执行，并保持窗口不关闭；关掉后转发就断开。

然后在本地浏览器访问：http://127.0.0.1:18789

16.4.2 路径B：Tailscale（长期方案）

Section titled “16.4.2 路径B：Tailscale（长期方案）”

方式1：tailnet 绑定

Terminal window
openclaw config set gateway.bind tailnet
Terminal window
openclaw gateway restart

方式2：Tailscale Serve

Terminal window
openclaw config set gateway.tailscale.mode serve
Terminal window
openclaw gateway restart

16.4.3 为什么不建议新手直接公网暴露

Section titled “16.4.3 为什么不建议新手直接公网暴露”

因为公网暴露会把“网络、安全、鉴权”问题叠在一起。
对小白来说，排障成本陡增。先用 SSH 隧道或 Tailscale 更稳。

16.5 备份、升级与回滚

Section titled “16.5 备份、升级与回滚”

16.5.1 备份范围

Section titled “16.5.1 备份范围”

核心目录在 ~/.openclaw/，至少要保住：

  • openclaw.json
  • credentials/
  • workspace/
  • agents/

16.5.2 一条命令打备份包

Section titled “16.5.2 一条命令打备份包”
Terminal window
tar -czvf openclaw-backup-$(date +%Y%m%d_%H%M%S).tar.gz ~/.openclaw

16.5.3 升级（官方推荐）

Section titled “16.5.3 升级（官方推荐）”

优先方案：重新执行安装脚本做就地升级

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

升级后执行：

Terminal window
openclaw doctor
Terminal window
openclaw gateway restart

包管理器升级（可选）：

Terminal window
npm i -g openclaw@latest
Terminal window
pnpm add -g openclaw@latest

16.5.4 回滚（固定到已知稳定版本）

Section titled “16.5.4 回滚（固定到已知稳定版本）”
Terminal window
npm i -g openclaw@<version>
Terminal window
openclaw doctor
Terminal window
openclaw gateway restart

本章小结

Section titled “本章小结”
  1. 先本地跑稳，再上云。
  2. 部署优先走“安装脚本 → doctor → onboard —install-daemon”。
  3. 运维优先看 gateway status 和 logs --follow。
  4. 远程访问优先 SSH 隧道 / Tailscale。
  5. 升级前先备份，升级后能回滚。

动手试试

Section titled “动手试试”
  1. 在一台 Ubuntu 服务器跑完安装、doctor、onboard。
  2. 用 openclaw gateway status 验证服务在线。
  3. 用 SSH 隧道访问控制台。
  4. 生成一份 ~/.openclaw 备份包。