openclaw-upgrade

Automates OpenClaw upgrades on macOS with verification and smoke tests.

2|1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/cncoder/oneclaw --skill openclaw-upgrade-cncoder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-upgrade
Source: https://github.com/cncoder/oneclaw/tree/main/skills/openclaw-upgrade
Command: npx skills add https://github.com/cncoder/oneclaw --skill openclaw-upgrade-cncoder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading OpenClaw to a new version on macOS can be risky without a structured, end-to-end process. This skill provides a repeatable runbook to perform the upgrade safely, validate prerequisites, migrate configurations, re-register launch agents, and verify the deployment.

Core Features & Use Cases

  • End-to-end upgrade workflow covering version checks, installation, configuration migration, and service re-registration.
  • Built-in smoke tests to verify gateway/daemon status and overall OpenClaw health after upgrade.
  • Rollback guidance to restore a known-good version if anything goes wrong.

Quick Start

Tell OpenClaw to upgrade to the latest stable version and verify the deployment end-to-end.

Frequently Asked Questions about openclaw-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade OpenClaw on macOS safely?

To upgrade OpenClaw on macOS safely, use an automated end-to-end workflow that performs version checks, installation, configuration migration, and launchd service re-registration. This structured runbook ensures a repeatable upgrade process without risking your deployment.

What is the end-to-end process for OpenClaw version migration?

The OpenClaw version migration process covers Phase 0 through Phase 7 workflows. It includes verifying prerequisites, installing the target version, migrating configurations, re-registering launch agents, and running smoke tests across gateway and daemon components.

Do I need pnpm and Node.js to run an OpenClaw upgrade?

Yes, you need pnpm and Node.js to run an OpenClaw upgrade. The upgrade workflow also requires proper AWS Bedrock and OpenClaw prerequisites, plus specific environment configuration for proxies and launch agent plist files.

How do I verify OpenClaw gateway and daemon status after an upgrade?

You verify OpenClaw gateway and daemon status after an upgrade by running built-in end-to-end smoke tests. These tests check overall OpenClaw health and confirm that both gateway and daemon components are functioning correctly post-migration.

What is the best way to handle a failed OpenClaw upgrade on macOS?

The best way to handle a failed OpenClaw upgrade on macOS is to follow the provided rollback guidance. This structured approach helps you restore a known-good version if anything goes wrong during the installation or migration process.

Why does my OpenClaw launchd service not start after upgrading?

Your OpenClaw launchd service might not start after upgrading if the launch agent plist was not properly re-registered during the migration phase. The upgrade workflow explicitly handles re-registration of launchd services to prevent this issue.