# Send Upgrade Openclaw - Stay on the edge when updating openclaw. Update, audit, discover, propose. Latest features, always. to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "upgrade-openclaw",
    "name": "Upgrade Openclaw - Stay on the edge when updating openclaw. Update, audit, discover, propose. Latest features, always.",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/decentraliser/upgrade-openclaw",
    "canonicalUrl": "https://clawhub.ai/decentraliser/upgrade-openclaw",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/upgrade-openclaw",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=upgrade-openclaw",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "settings.json",
      "state.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "upgrade-openclaw",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T07:48:32.738Z",
      "expiresAt": "2026-05-11T07:48:32.738Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=upgrade-openclaw",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=upgrade-openclaw",
        "contentDisposition": "attachment; filename=\"upgrade-openclaw-2.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "upgrade-openclaw"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/upgrade-openclaw"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/upgrade-openclaw",
    "downloadUrl": "https://openagent3.xyz/downloads/upgrade-openclaw",
    "agentUrl": "https://openagent3.xyz/skills/upgrade-openclaw/agent",
    "manifestUrl": "https://openagent3.xyz/skills/upgrade-openclaw/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/upgrade-openclaw/agent.md"
  }
}
```
## Documentation

### 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:

{ "subagentModel": "anthropic/claude-sonnet-4-6" }

### 1. Record Pre-Update State

Before touching anything:

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

openclaw update

If dirty working tree, stash first:

cd "$(openclaw --version 2>&1 | grep -oP '(?<=\\().*?(?=\\))' || echo ~/openclaw)" 
git stash --include-untracked -m "pre-update stash" && openclaw update

Record new version:

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:

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

Then filter by relevance to this setup:

Read current config via gateway config.get to identify enabled channels/plugins
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)


Discard entries for disabled channels, iOS/macOS app changes, and platforms not in use
Categorize kept entries into: Features | Fixes | Security | Breaking Changes

### 4. Config Schema Gap Analysis

Fetch the live schema and current config:

Schema: gateway config.schema
Current: gateway config.get

Compare systematically:

Walk schema properties tree recursively
For each schema key path, check if it exists in current config
New/unset options = schema keys not present in current config (excluding keys with sensible defaults)
Focus on actionable fields — ones where setting a non-default value provides clear benefit
Flag fields from the changelog delta (new in this version) separately as "New in this release"

Present as a table:

| Config Path | Type | Default | Description | New? |

### 5. Audit Current Setup

openclaw hooks list --json
openclaw doctor --non-interactive
clawhub update --all --dry-run 2>&1

Collect:

Hooks: any hooks available but not enabled
Doctor: all warnings and recommendations
Skills: any ClawHub updates available

### 6. Present Comprehensive Report

Structure the report exactly like this:

## 🔍 Post-Upgrade Report: {PRE_VERSION} → {POST_VERSION}

### 🆕 New Features (Relevant to Your Setup)
- [Feature]: What it does, why it matters for you
  - Config: \`path.to.setting\` (if applicable)

### 🔧 Notable Fixes
- [Fix]: What was broken, now fixed

### 🔐 Security Updates
- [Security]: What was patched

### ⚠️ Breaking Changes
- [Breaking]: What changed, migration needed

### 📋 New Config Options Available
| Config Path | Type | Default | Why Enable |
|-------------|------|---------|------------|

### 🪝 Hooks Status
- [hook]: enabled/available/new

### 🏥 Doctor Recommendations
- [Item]: severity + action

### 📦 Skill Updates Available
- [skill]: current → available version

---
**Apply these improvements?** Reply with:
- "yes" / "all" — apply everything
- "select" — I'll list numbered items to pick from
- specific items by name

Critical: Do NOT present a thin report. Every changelog entry that survived the relevance filter in Step 3 MUST appear. Every new config option from Step 4 MUST appear. Every doctor finding from Step 5 MUST appear. The user triggered this skill to see EVERYTHING.

### 7. Apply with Approval

Never apply without explicit user approval.

On approval, apply changes via:

Config changes: gateway config.patch
Hook enablement: openclaw hooks enable <hook>
Skill installs: clawhub install <skill>

After applying, pop any git stash:

cd ~/openclaw && git stash list | grep -q "pre-update stash" && git stash pop

### 8. Persist State

Write upgrade state to state.json in this skill's directory:

{
  "lastUpgrade": {
    "from": "2026.3.2",
    "to": "2026.3.3",
    "timestamp": "2026-03-05T06:50:00Z",
    "featuresProposed": ["telegram-streaming", "pdf-tool", ...],
    "featuresApplied": ["telegram-streaming", ...],
    "doctorApplied": ["entrypoint-fix", ...]
  }
}

This prevents re-proposing on repeated runs and enables "what changed since last upgrade" queries.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: decentraliser
- Version: 2.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T07:48:32.738Z
- Expires at: 2026-05-11T07:48:32.738Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/upgrade-openclaw)
- [Send to Agent page](https://openagent3.xyz/skills/upgrade-openclaw/agent)
- [JSON manifest](https://openagent3.xyz/skills/upgrade-openclaw/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/upgrade-openclaw/agent.md)
- [Download page](https://openagent3.xyz/downloads/upgrade-openclaw)