Agent Skills
返回列表
OpenClaw 部署助手

OpenClaw 部署助手

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_2d144860/openclaw-deployer

技能介绍

##部署OpenClaw时常见的痛点

  • 平台选择困难：不清楚本地Docker、Railway还是火山引擎更适配自身场景
  • 容器启动后访问失败：出现502 Bad Gateway错误却难以定位原因
  • 容器频繁崩溃：OOM错误、文件权限问题导致服务不稳定
  • 技能加载异常：技能文件放置位置正确但UI中无法显示
  • 数据迁移无头绪：更换服务器时不知道如何备份和恢复持久数据

##技能的核心能力
###环境配置与平台选择

  • 提供Railway、火山引擎、本地Docker三类平台的适用场景对比，火山引擎推荐用于生产环境
  • 明确服务器最低要求：Ubuntu 22.04+系统、2+核心CPU、4GB RAM（最低2GB但易出现OOM错误）

###新部署操作流程

  • 火山引擎一键部署：预装Docker与OpenClaw镜像，通过docker ps验证容器运行状态
  • 其他平台手动部署：创建docker-compose.yml与openclaw.json，关键配置bind: lan确保外部访问

###故障排查指南

  • 502 Bad Gateway：检查日志确认bind是否设为lan，修复后执行docker-compose restart重启容器
  • 容器崩溃（CrashLoopBackOff）：排查OOM错误（升级内存至4GB+）或文件权限问题（chmod -R 777临时修复）
  • 技能加载失败：确认技能目录位于/home/ubuntu/openclaw_data/workspace/skills/，检查SKILL.md的YAML头

###数据迁移步骤

  • 备份旧服务器持久卷：tar -czvf openclaw_backup.tar.gz /home/ubuntu/openclaw_data
  • 传输备份文件至新服务器：使用scp命令
  • 恢复备份并启动容器：按新部署流程操作

##适用边界与注意事项

  • 内存限制：Railway Hobby版（1GB）仅适合测试，生产环境需4GB+内存
  • 配置文件修改：修改openclaw.json后需重启容器
  • 技能格式要求：SKILL.md必须包含正确的YAML frontmatter（name、description）

使用场景

  • 准备上线 OpenClaw 实例，需要在火山引擎购买并配置 2核4GB 服务器，完成 Docker 环境的初始化部署
  • 容器运行后外部访问返回 502 错误，需要排查 openclaw.json 的 bind 配置并重启服务恢复访问
  • 容器频繁崩溃重启（CrashLoopBackOff），需要诊断是否为内存不足或文件权限问题，升级内存或修复权限
  • 需要把现有 OpenClaw 实例迁移到新服务器，备份持久卷并恢复数据后重新启动容器

适合人员

  • 首次部署 OpenClaw 的运维工程师，需要在云服务器上完成从环境准备到容器启动的完整流程
  • 负责线上 OpenClaw 服务稳定性的 SRE，需要在出现 502 或容器崩溃时快速定位并修复问题
  • 需要更换服务器或迁移 OpenClaw 实例的技术人员，希望无损备份并恢复技能、日志等持久数据
  • 在本地 Docker 环境中调试 OpenClaw 的开发者，需要搭建开发测试环境并验证配置变更