VPS 初始化脚本

面向 Ubuntu VPS 的 OpenClaw 全量部署与灾难恢复框架。

概览

三个脚本覆盖完整生命周期：

1. bootstrap.sh — 新建 VPS → 完全可用的 OpenClaw（耗时约 15–20 分钟）
2. restore.sh — 从备份中还原工作区、配置、密钥及定时任务（crontab）
3. verify.sh — 部署后验证（全绿 = 就绪可用）

快速开始

新 VPS 初始化

# 在全新 Ubuntu 24.04 VPS 上执行
bash scripts/bootstrap.sh

从备份恢复

bash scripts/restore.sh ~/openclaw-backup-*.tar.gz

验证全部功能正常

bash scripts/verify.sh

bootstrap.sh 执行内容

按顺序执行安装流程，每一步均含错误处理：

1. 系统基础包 — build-essential、curl、git、jq、unzip 等
2. Node.js — 通过 NodeSource 安装最新 LTS 版本
3. Google Chrome — Stable 渠道 + headless shim（支持浏览器类工具）
4. OpenClaw — 全局 npm 安装 + 网关服务配置
5. 安全基线 — UFW 防火墙、fail2ban、SSH 密钥认证强制启用
6. 服务配置 — systemd 用户级服务，启用自动重启与 linger 模式

所有步骤均为幂等操作——中断后可安全重试。

restore.sh 执行内容

解压备份 tarball 并还原以下内容：

• 工作区文件（SOUL.md、MEMORY.md、AGENTS.md、memory/、scripts/）
• OpenClaw 配置（openclaw.json、.env）
• cron 数据库
• GPG 密钥 + 密码库（加密存储的密钥）
• OAuth 凭据（GOG、rclone）
• 系统配置快照

verify.sh 执行内容

运行 10 余项检查并报告通过/失败状态：

• OpenClaw 网关正在运行且健康
• Telegram / Discord 提供方已连接
• 浏览器类工具功能正常
• 备份系统运行正常
• cron 任务已加载
• SSH 安全基线符合要求
• 磁盘空间与内存使用情况

备份脚本（可选）

如需自动化每日备份，请参阅 references/backup-guide.md。

自定义配置

编辑 scripts/bootstrap.sh 文件顶部的变量：

OPENCLAW_PORT=18789        # 网关端口
ENABLE_FIREWALL=true       # 启用 UFW 防火墙配置
ENABLE_FAIL2BAN=true       # 启用 fail2ban（SSH 防护）
INSTALL_CHROME=true        # 启用浏览器工具支持

运行要求

• Ubuntu 22.04+ 或 Debian 12+
• 具备 root 权限或 sudo 访问能力
• 建议配备 2GB 及以上内存
• 已配置 SSH 密钥登录

安全说明

• 脚本本身绝不在技能（skill）中以明文形式存储任何密钥
• GPG 密钥以加密方式备份
• SSH 已加固为仅允许密钥认证
• 网关默认仅绑定到 localhost