clawreverse
Inspect, checkpoint, rollback, and branch OpenClaw sessions with the ClawReverse plugin. Use when a user wants to recover from bad tool or file changes, restore a known-good checkpoint, inspect session lineage, create a child branch from an earlier point, or avoid re-spending tokens after a long OpenClaw run. Do not use for plain git history operations or non-OpenClaw workspaces.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/binhuangpjlab/clawreverseClawReverse
Use this skill for OpenClaw session recovery and branching.
ClawReverse is a native OpenClaw plugin that adds the openclaw reverse command family for checkpoint listing, rollback, continue, checkout, and lineage inspection.
Use this skill when
- a user wants to undo a bad OpenClaw tool call or recover from unwanted file changes
- a user wants to restore a known-good point without rerunning the whole task
- a user wants to branch from an earlier checkpoint and keep the parent session untouched
- a user wants to inspect checkpoint lineage, rollback status, rollback reports, or branch records
- a user wants to save tokens after a long analysis run by continuing from a checkpoint instead of starting over
Do not use this skill when
- the task is a normal git revert, git checkout, or git branch workflow that should be handled directly with git
- the workspace is not managed by OpenClaw
- there are no OpenClaw sessions or checkpoints to operate on yet
Key behavior you should know first
- ClawReverse creates checkpoints before mutating tool calls. Read-only tools and read-only shell commands do not create checkpoints.
rollbackrewinds the current session to a checkpoint. By default it does not restore the live workspace files unless--restore-workspaceis used.continuerequires a non-empty--promptand creates a new child agent, new workspace, and new session, leaving the parent untouched.checkoutcreates a new session in the same agent from a checkpoint-backed entry.--continuecan immediately start a run in that new session.treeis the fastest way to explain lineage and branch points to a user.- Add
--jsonwhenever another tool needs machine-readable output.
Prerequisites
- a working OpenClaw installation
- access to the machine that runs OpenClaw
- a valid
openclaw.json - the ClawReverse plugin files available in this skill bundle
First step: verify or install the plugin
- Check whether the plugin is already available:
openclaw reverse --help
- If the command is missing, install the plugin from this skill bundle:
openclaw plugins install -l "{baseDir}"
- Then initialize or repair config:
openclaw reverse setup
- Restart the OpenClaw Gateway after install or config changes, then verify again:
openclaw reverse --help
If the OpenClaw state directory is not the default one, use:
openclaw reverse setup --base-dir /path/to/openclaw-state
Default config created by setup
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-binhuangpjlab-clawreverse": {
"enabled": true,
"auto_update": true
}
}
}