{"item":{"id":"obs-topic-upgrade","product":"openclaw","language":"en","title":"How do I upgrade an agent without losing working state?","summary":"Inventory the real runtime, save a recoverable state and test the seam after restart. Package installation is only one checkpoint.","contentType":"guide","category":"deployment","revision":2,"canonicalUrl":"https://botclaw.tech/items/obs-topic-upgrade","sourceUrls":["https://docs.openclaw.ai/releases/2026.9.7","https://docs.openclaw.ai/cli/backup","https://github.com/NousResearch/hermes-agent/releases/tag/v2026.9.24"],"sourcePublishedAt":"2026-10-01T16:24:26.193Z","reviewedAt":"2026-10-01T15:50:00.000Z","collectedAt":"2026-10-01T16:24:26.193Z","updatedAt":"2026-10-01T16:24:32.310Z","source":{"id":"botclaw-editorial","name":"BotClaw","origin":"editorial"},"summaryMethod":"editor","applicability":{"version":null,"platforms":[],"requirements":["Check current account access, plan and task requirements."]},"verification":{"kind":"official_documentation","checkedAt":"2026-10-01T15:50:00.000Z","urls":["https://docs.openclaw.ai/releases/2026.9.7","https://docs.openclaw.ai/cli/backup","https://github.com/NousResearch/hermes-agent/releases/tag/v2026.9.24"],"limitations":["Source-backed facts plus BotClaw editorial interpretation. No product account, inference or agent performance test was run."]},"body":{"introduction":"Plan the rollback before changing the package. Preserve both data and enough configuration to recreate the process that used it.","sections":[{"heading":"Inventory the running system","paragraphs":["Record the real executable, version, working directory, identity, profile, data paths, model endpoint and channel. A shell’s default executable can differ from the running service."]},{"heading":"Rehearse recovery","paragraphs":["A backup file’s existence is not proof that the whole system can recover. Restore to an isolated target with test channels, check memory and schedules, and keep the original untouched until the result is understood."]},{"heading":"Acceptance after restart","paragraphs":[],"steps":["Confirm the intended executable, configuration and data paths in the actual process.","Check a real test message, a fresh session and one scheduled task.","Compare activity, errors and state changes with the pre-upgrade baseline."]}]},"editorial":{"section":"topic","productIds":["openclaw","hermes"],"relatedIds":["obs-radar-openclaw-2026-9-7","obs-radar-hermes-2026-9-24"],"sourceDate":null,"version":null},"indexable":true,"supersededBy":null,"review":{"state":"current","pendingChanges":0,"policyDays":7}}}