{"item":{"id":"wf-upgrade-regression","product":"openclaw","language":"en","title":"Check an upgrade against a recorded baseline","summary":"Record the actual CLI and gateway versions, preserve recovery data, and recheck chat, tools, memory, messaging and schedules after upgrading.","contentType":"guide","category":"release","revision":2,"canonicalUrl":"https://botclaw.tech/items/wf-upgrade-regression","sourceUrls":["https://docs.openclaw.ai/install/updating","https://docs.openclaw.ai/cli/backup"],"sourcePublishedAt":"2026-10-01T13:51:23.773Z","reviewedAt":"2026-10-01T00:00:00.000Z","collectedAt":"2026-10-01T13:51:23.773Z","updatedAt":"2026-10-01T13:51:29.241Z","source":{"id":"botclaw-editorial","name":"BotClaw","origin":"editorial"},"summaryMethod":"editor","applicability":{"version":null,"platforms":["Current OpenClaw installation"],"requirements":["A verified backup and permission to restart this instance","A recorded harmless task baseline"]},"verification":{"kind":"official_documentation","checkedAt":"2026-10-01T00:00:00.000Z","urls":["https://docs.openclaw.ai/install/updating","https://docs.openclaw.ai/cli/backup"],"limitations":["Original BotClaw acceptance procedure based on linked official documentation. Product commands were not executed; check your installed version."]},"body":{"introduction":"An upgrade is useful when your existing tasks still work. Use the same harmless inputs before and after the change. Separate package installation from the version running in the gateway; those can differ after a failed restart.","sections":[{"heading":"Prepare a comparison","paragraphs":[],"steps":["Record CLI version, running gateway identity, release channel and configuration paths. Do not include secrets in the shared record.","Review the release notes relevant to your enabled channels and tools. Create and verify a backup before the change.","Run five small baseline checks: text response, read-only file access, a fresh-session memory check, private test-channel reply and one harmless scheduled event.","Follow the update method for your installation. Inspect completion and the actual running gateway version, then repeat the same checks."]},{"heading":"Acceptance","paragraphs":["Compare outputs at each seam, not just the updater’s exit code. If a formerly passing task fails, keep the before/after versions, failure evidence and recovery files. Pause recurring tasks affected by the failure before they repeatedly act on incomplete output."]},{"heading":"Recovery and cleanup","paragraphs":["Use the current official recovery method for the recorded installation. Do not delete migration originals or backups until the baseline passes and intended data is present. Restoring code alone may not reverse a state migration."]}]},"indexable":true,"supersededBy":null,"review":{"state":"current","pendingChanges":0,"policyDays":7}}}