# 云上蜕壳

Adopt this skill: https://proskills.md/skills/data/skill

Page: https://proskills.md/skills/data/skill
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: .gitignore
upstream: https://github.com/alexli126312-blip/cloud-molting/blob/HEAD/.gitignore

Content is not inlined in the catalog. Read the upstream file: https://github.com/alexli126312-blip/cloud-molting/blob/HEAD/.gitignore

## File: LICENSE
upstream: https://github.com/alexli126312-blip/cloud-molting/blob/HEAD/LICENSE

Content is not inlined in the catalog. Read the upstream file: https://github.com/alexli126312-blip/cloud-molting/blob/HEAD/LICENSE

## File: README.md
upstream: https://github.com/alexli126312-blip/cloud-molting/blob/HEAD/README.md

````text
🦞 云上蜕壳 (Cloud Molting)

OpenClaw 安全升级技能，专为低内存环境设计。通过创建临时交换空间确保升级过程顺利完成。

[图片]

🌟 功能特性

🦞 自动检测内存状态：识别系统资源限制
💾 智能交换空间管理：自动创建和清理临时交换空间  
🔧 安全升级流程：使用官方更新机制，包含回退保护
📊 完整状态报告：提供升级前后的详细状态对比
⚡ 一键执行：单命令完成整个升级过程
✅ 版本准确性保障：强制使用 `openclaw --version` 获取真实版本，避免缓存错误
🌐 智能在线版本检测：自动搜索最新版本，仅在有更新时才执行升级

🚀 快速开始

通过 ClawHub 安装（推荐）
```bash

openclaw skills install cloud-molting
```

手动安装
```bash

克隆仓库
git clone https://github.com/alexli126312-blip/cloud-molting.git ~/.openclaw/skills/cloud-molting

重启 OpenClaw
openclaw gateway restart
```

📖 使用方法

聊天交互使用
直接在聊天中说：
"升级大钳子"
"执行云上蜕壳" 
"更新 OpenClaw"
"检查最新版本"
"检查真实版本"

命令行使用
```bash

执行智能安全升级（自动检测在线最新版本）
uv run ~/.openclaw/skills/cloud-molting/scripts/cloud-molting.py upgrade

仅检查在线最新版本（不执行升级）
uv run ~/.openclaw/skills/cloud-molting/scripts/cloud-molting.py check-online

强制升级（跳过在线检查，直接升级）
uv run ~/.openclaw/skills/cloud-molting/scripts/cloud-molting.py upgrade --force

验证版本准确性
uv run ~/.openclaw/skills/cloud-molting/scripts/cloud-molting.py verify-version

清理临时资源（通常不需要手动调用）
uv run ~/.openclaw/skills/cloud-molting/scripts/cloud-molting.py cleanup

```

🔧 升级流程

1. 在线版本检测：使用 searxng 搜索 OpenClaw 最新版本信息
2. 本地版本验证：使用 `openclaw --version` 获取准确本地版本（避免 session_status 缓存错误）
3. 智能版本对比：比较本地版本与在线最新版本
4. 条件决策：
   如果本地版本 >= 在线版本 → 跳过升级，报告"已是最新版本"
   如果本地版本 < 在线版本 → 继续执行升级流程
5. 资源准备：创建 2GB 临时交换空间（如内存 < 4GB）
6. 执行升级：使用 `pnpm add -g openclaw@latest` 安全更新
7. 验证结果：确认新版本正常工作，再次验证版本准确性
8. 清理资源：移除临时交换空间
9. 报告状态：向用户汇报最终结果（升级成功或已是最新）

⚙️ 配置选项

可通过环境变量自定义行为：
`CLOUD_MOLTING_SWAP_SIZE_MB`：交换空间大小（默认 2048）
`CLOUD_MOLTING_TIMEOUT_MIN`：升级超时时间（默认 10 分钟）
`CLOUD_MOLTING_DRY_RUN`：仅模拟升级（不实际执行）
`CLOUD_MOLTING_FORCE_VERSION_CHECK`：强制版本验证（默认 true）
`CLOUD_MOLTING_ONLINE_CHECK`：启用在线版本检测（默认 true）
`CLOUD_MOLTING_SEARCH_TIMEOUT_SEC`：在线搜索超时时间（默认 30 秒）

🎯 适用环境

阿里云 ECS：特别优化的低内存实例
树莓派/ARM 设备：资源受限的嵌入式环境  
容器环境：Docker/Podman 中的 OpenClaw 实例
任何 Linux 系统：支持标准 swap 工具的环境

🛠️ 故障排除

常见问题及解决方案

问题：无法找到 swapon/mkswap 命令
原因：工具不在标准 PATH 中或未安装
解决方案：
  ```bash

检查工具位置
  which swapon mkswap || find /usr -name "swapon" -o -name "mkswap"

如果未安装，在 CentOS/RHEL 中运行：
  sudo yum install util-linux

在 Ubuntu/Debian 中运行：
  sudo apt-get install util-linux
  ```

问题：权限不足创建交换空间
原因：需要 root 权限执行 swapon
解决方案：确保以管理员权限运行，或使用 sudo

问题：云服务器禁用 swap
原因：某些云服务商默认禁用 swap 功能
解决方案：直接跳过交换空间创建，尝试直接升级

问题：版本显示错误或不一致
原因：session_status 可能显示缓存的旧版本信息，而非真实版本
解决方案：
  ```bash

始终使用以下命令获取真实版本（强制规则）
  openclaw --version

如果发现版本不一致，执行版本验证修复
  uv run ~/.openclaw/skills/cloud-molting/scripts/cloud-molting.py verify-version

手动强制刷新版本缓存
  openclaw gateway restart
  ```

问题：在线版本检测失败或超时
原因：网络连接问题或搜索引擎不可用
解决方案：
  ```bash

禁用在线检查，使用本地模式
  CLOUD_MOLTING_ONLINE_CHECK=false uv run ~/.openclaw/skills/cloud-molting/scripts/cloud-molting.py upgrade

或者增加超时时间
  CLOUD_MOLTING_SEARCH_TIMEOUT_SEC=60 uv run ~/.openclaw/skills/cloud-molting/scripts/cloud-molting.py upgrade
  ```

手动执行步骤
如遇问题，可手动执行以下步骤：
```bash

检查当前真实版本（关键步骤）
openclaw --version

手动检查在线最新版本
curl -s "https://github.com/openclaw/openclaw/releases/latest" | grep -o 'v[0-9]*\.[0-9]*\.[0-9]*' | head -1

手动创建交换空间
sudo dd if=/dev/zero of=/tmp/swapfile bs=1M count=2048
sudo mkswap /tmp/swapfile
sudo swapon /tmp/swapfile

手动升级（仅当确认有新版本时）
pnpm add -g openclaw@latest

验证升级后的真实版本
openclaw --version

清理交换空间
sudo swapoff /tmp/swapfile
sudo rm /tmp/swapfile
```

📜 版本历史

1.4.0：品牌重塑，从"空中蜕壳"更名为"云上蜕壳 (Cloud Molting)"；新增智能在线版本检测功能，自动搜索最新版本并仅在需要时执行升级；添加网络容错和配置选项
1.3.0：新增智能在线版本检测功能，自动搜索最新版本并仅在需要时执行升级；添加网络容错和配置选项
1.2.0：新增版本准确性保障功能，强制使用 `openclaw --version` 获取真实版本，解决版本显示错误问题；增强故障排除指南
1.1.0：改进故障排除，添加工具路径检查和权限处理
1.0.0：初始版本，支持基础升级功能

📄 许可证

本项目采用 MIT License。

🤝 贡献

欢迎提交 Issue 和 Pull Request！请先阅读 CONTRIBUTING.md。

📞 支持

文档: OpenClaw 官方文档
社区: BotLearn 社区帖子
问题反馈: 在 GitHub Issues 中提交

--

Made with ❤️ for the OpenClaw community 🦞
```
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the
````

## File: SKILL.md
upstream: https://github.com/alexli126312-blip/cloud-molting/blob/HEAD/SKILL.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/alexli126312-blip/cloud-molting/blob/HEAD/SKILL.md