openclaw-update

# OpenClaw Update Skill

## Multilingual Support / 多语言支持

**Detect user language and respond accordingly:**
- If user speaks Chinese → respond in Chinese (简体中文)
- If user speaks English → respond in English
- Maintain consistent language throughout the session

**检测用户语言并相应回复：**
- 用户使用中文 → 用简体中文回复
- 用户使用英文 → 用英文回复
- 整个会话保持语言一致

---

## Prerequisites / 前置要求

### Agent-Reach Detection / Agent-Reach 检测

**Before using this skill, detect if agent-reach is available:**

```bash
# Detection command
agent-reach --version 2>&1 || echo "Not installed"
```

**If not installed, guide user to install:**

```bash
# Method 1: pipx install (recommended)
pipx install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto

# Method 2: Check for alternative GitHub access
# Such as gh CLI, curl (not recommended, may be blocked)
```

**If user cannot install agent-reach:**
- Explain the reason (network restrictions, permission issues, etc.)
- Suggest manual GitHub access to check versions
- Or guide to learn the `agent-reach` skill first

---

## Workflow / 工作流程

### Step 0: Detect Agent-Reach Availability / 检测 Agent-Reach 可用性

**Use detection script (recommended):**

```bash
python3 scripts/check_agent_reach.py
```

**Or manual detection:**

```bash
# Test if agent-reach is available
agent-reach read "https://github.com/openclaw/openclaw" --timeout 10 2>&1
```

**If successful**: Continue to next step  
**If failed**:
1. Inform user agent-reach is unavailable
2. Provide installation guide (see Prerequisites or run `python3 scripts/check_agent_reach.py`)
3. Ask if user wants to continue (manual mode) or install agent-reach first

---

### Step 1: Check Current Version / 检查当前版本

**Progress message:**
> 📋 **Step 1/10: Checking current version** / **正在执行第 1 步：检查当前版本**

```bash
openclaw --version
```

Record current version (e.g., v2026.3.2)

---

### Step 2: Get Lat...

# OpenClaw Update Skill - ClawHub Release

## 📦 Skill Information

- **Name**: openclaw-update
- **Version**: 1.0
- **Author**: Davis
- **Description**: OpenClaw version upgrade assessment and execution skill
- **Category**: System Tools
- **Languages**: 简体中文 / English (bilingual support)

---

## 🎯 Features

1. **Automatic Version Detection** - Check current vs latest stable version
2. **Intelligent Assessment** - 5-dimension scoring system
3. **Risk Assessment** - Check GitHub issues for critical bugs
4. **Breaking Changes Detection** - Warn about config compatibility issues
5. **Agent-Reach Integration** - Auto-detect GitHub access capability
6. **Safe Backup System** - Timestamp + random suffix to prevent conflicts
7. **Installation Method Detection** - Use correct update command (npm/pnpm/git)
8. **Auto Gateway Restart** - Restart after update or inform if failed
9. **Recovery Function** - List and restore from backups
10. **Multilingual Support** - Chinese/English based on user language

---

## 📋 Prerequisites

### Required

- **OpenClaw** v2026.3.0+
- **agent-reach** v1.0.0+ (for GitHub access)
- **Python** 3.8+ (for backup scripts)

### Optional

- npm/pnpm (for global installation updates)
- git (for source installation updates)

---

## 🚀 Installation

### Method 1: ClawHub (Recommended)

```bash
clawhub install openclaw-update
```

### Method 2: Manual Installation

```bash
# Download skill file
# Copy to OpenClaw skills directory
cp openclaw-update.skill ~/.openclaw/workspace/skills/

# Extract
cd ~/.openclaw/workspace/skills/
unzip openclaw-update.skill
```

---

## 📖 Usage

### Trigger Phrases

- "Check OpenClaw update" / "检查 OpenClaw 更新"
- "Assess if should upgrade to latest" / "评估是否升级到最新版"
- "openclaw-update"
- "Should I update OpenClaw" / "要不要更新 OpenClaw"

### Workflow (10 Steps)

1. **Detect Agent-Reach** - Check GitHub access capability
2. **Check Current Version** - `openclaw --version`
3. **Get Latest Version** - Fro...