upgrade-openclaw

# Upgrade OpenClaw

Update, diff, audit, propose. Every new feature surfaced. Nothing missed.

## Settings

On first run, check `settings.json` in this skill's directory. If `subagentModel` not set, ask:

> "Which model for upgrade sub-agents? (e.g., `claude-sonnet-4-6`, `deepseek-chat`). Note: external providers will receive config data."

Save to `settings.json`:
```json
{ "subagentModel": "anthropic/claude-sonnet-4-6" }
```

## Procedure

### 1. Record Pre-Update State

Before touching anything:

```bash
PRE_VERSION=$(openclaw --version | grep -oP '\d{4}\.\d+\.\d+')
echo "$PRE_VERSION"
```

Save `PRE_VERSION` — needed for changelog diffing in Step 3.

### 2. Run Update

```bash
openclaw update
```

If dirty working tree, stash first:
```bash
cd "$(openclaw --version 2>&1 | grep -oP '(?<=\().*?(?=\))' || echo ~/openclaw)" 
git stash --include-untracked -m "pre-update stash" && openclaw update
```

Record new version:
```bash
POST_VERSION=$(openclaw --version | grep -oP '\d{4}\.\d+\.\d+')
```

If `PRE_VERSION == POST_VERSION`, report "Already up to date" and skip to Step 5 (audit only).

### 3. Extract Delta Changelog

The changelog lives locally at `~/openclaw/CHANGELOG.md` after update. Versions delimited by `## YYYY.x.x` headers.

Extract only entries between old and new version:

```bash
awk "/^## $POST_VERSION/,/^## $PRE_VERSION/" ~/openclaw/CHANGELOG.md
```

Then **filter by relevance** to this setup:

1. Read current config via `gateway config.get` to identify enabled channels/plugins
2. From the changelog delta, **keep** entries matching:
   - Enabled channels (e.g., Telegram — skip LINE/Discord/Feishu/etc. unless enabled)
   - Core agent/gateway/cron/tools/memory/security changes (always relevant)
   - ACP/sessions/subagent changes (if ACP enabled)
   - Breaking changes (always relevant)
3. **Discard** entries for disabled channels, iOS/macOS app changes, and platforms not in use
4. **Categorize** kept entries into: Features | Fixes | Security | Breaking C...