Issue Station
Sign In
Tools hereToolbox

openclaw - ✅(Solved) Fix [Bug]: No restore step in openclaw backup docs [1 pull requests, 1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#77849•Fetched 2026-05-06 06:20:19
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
2
Author
sanjarcodesanjarcode
Participants
clawsweeper[bot]clawsweeper[bot]sanjarcodesanjarcode
Timeline (top)
labeled ×2commented ×1cross-referenced ×1

There is no step or command to restore a backup, or atleast it has not been mentioned on the docs. URL: https://docs.openclaw.ai/cli/backup

Root Cause

There is no step or command to restore a backup, or atleast it has not been mentioned on the docs. URL: https://docs.openclaw.ai/cli/backup

Fix Action

Fixed

PR fix notes

PR #78010: docs(backup): document manual restore steps

Description (problem / solution / changelog)

Summary

  • Adds a "Restore from a backup archive" section to docs/cli/backup.md that covers inspecting, same-machine restore, and new-machine restore using tar + the embedded manifest.json.
  • Explicitly documents that openclaw backup does not ship a paired restore subcommand and explains the manual flow.
  • Extends frontmatter read_when and Related links to cover restore + the migrating guide.

Closes #77849

Testing

  • pnpm docs:check-mdx (Docs MDX check passed, 613 files)
  • pnpm docs:check-links (checked_internal_links=4217, broken_links=0)
  • pnpm vitest run src/scripts/docs-link-audit.test.ts (6/6)

Real behavior proof

  • Behavior or issue addressed: Issue #77849 reports there is no restore step in the openclaw backup docs at https://docs.openclaw.ai/cli/backup. This PR adds the missing restore procedure (same-machine, new-machine, archive layout, manifest inspection) directly to that page, and is honest that there is no openclaw backup restore subcommand today.
  • Real environment tested: Local OpenClaw checkout from this PR branch on macOS (Darwin 25.5.0) at HEAD 1ce240738fb0579ff5da52b8038f342ae590c23b. Docs build/lint commands run from the branch worktree.
  • Exact steps or command run after this patch: 
    pnpm docs:check-mdx
pnpm docs:check-links
pnpm vitest run src/scripts/docs-link-audit.test.ts
  • Evidence after fix: 
    > [email protected] docs:check-mdx /private/tmp/oc-77849-fix
> node scripts/check-docs-mdx.mjs docs README.md
Docs MDX check passed (613 files, 5015ms).

> [email protected] docs:check-links /private/tmp/oc-77849-fix
> node scripts/docs-link-audit.mjs
checked_internal_links=4217
broken_links=0

 Test Files  1 passed (1)
      Tests  6 passed (6)
  • Observed result after fix: Backup docs now include a clear, accurate, manifest-driven restore procedure for both same-machine and new-machine cases; MDX, internal-link audit, and the docs-link-audit unit test all pass.
  • What was not tested: The Mintlify hosted docs site preview was not rendered from this clone; the site preview happens in CI on merge.

Changed files

  • docs/cli/backup.md (modified, +80/-0)
RAW_BUFFERClick to expand / collapse

Bug type

Behavior bug (incorrect output/state without crash)

Beta release blocker

No

Summary

There is no step or command to restore a backup, or atleast it has not been mentioned on the docs. URL: https://docs.openclaw.ai/cli/backup

Steps to reproduce

Visit https://docs.openclaw.ai/cli/backup

Expected behavior

There should be two commands - restore and backup

Actual behavior

There is no restoration command

OpenClaw version

OpenClaw 2026.4.26 (be8c246)

Operating system

macOS Tahoe 26.04

Install method

npm global

Model

DeepSeek V4 Flash

Provider / routing chain

openclaw -> mac

Additional provider/model setup details

No response

Logs, screenshots, and evidence

Impact and severity

No response

Additional information

No response

extent analysis

TL;DR

The issue can be resolved by adding a restore command to the OpenClaw CLI documentation or implementing the restore functionality.

Guidance

  • Review the OpenClaw CLI codebase to determine if a restore command is already implemented but not documented.
  • Check the OpenClaw API documentation to see if there is a restore endpoint that can be used to create a restore command.
  • Consider submitting a feature request or pull request to add a restore command to the OpenClaw CLI.
  • Verify the existence of a restore command by running a command like openclaw --help or openclaw backup --help to see if there are any hidden or undocumented options.

Example

No code example is provided as the issue is related to missing documentation or functionality.

Notes

The issue is specific to the OpenClaw CLI documentation and may not be related to the underlying API or implementation. The solution may involve updating the documentation or implementing new functionality.

Recommendation

Apply workaround: Submit a feature request or pull request to add a restore command to the OpenClaw CLI, as it seems to be a missing feature.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

There should be two commands - restore and backup

#SSR setup#ISR setup#authentication setup#request error#file not found

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - ✅(Solved) Fix [Bug]: No restore step in openclaw backup docs [1 pull requests, 1 comments, 2 participants]