← Back to Skills Marketplace
879
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install arc-wake-state
Description
Persist agent state across crashes, context deaths, and restarts. Use when you need to save current context, restore after a crash, maintain a memory file ac...
README (SKILL.md)
Wake State — Crash Recovery & Persistence
Survive context death. Every autonomous agent eventually hits its context window limit and "dies." This skill ensures you wake up knowing exactly what you were doing.
Why This Exists
OpenClaw agents get persistent sessions, but context windows still have limits. When you fill up and restart, you need a reliable handoff mechanism. Wake State gives you:
- Structured state files — not just raw text, but parseable key-value state
- Auto-snapshots — save state on every loop iteration automatically
- Crash detection — know if your last session ended cleanly or crashed
- Task queue — persistent TODO list that survives restarts
- Checkpoint/restore — save named checkpoints and roll back to them
Commands
Save current state
python3 {baseDir}/scripts/wakestate.py save --status "Building budget tracker skill" --task "Finish skill #1, then start skill #2" --note "Travis approved new direction at 16:45 UTC"
Read current state
python3 {baseDir}/scripts/wakestate.py read
Add a task to the persistent queue
python3 {baseDir}/scripts/wakestate.py task-add --task "Build security scanner skill" --priority high
Complete a task
python3 {baseDir}/scripts/wakestate.py task-done --id 1
List pending tasks
python3 {baseDir}/scripts/wakestate.py tasks
Create a named checkpoint
python3 {baseDir}/scripts/wakestate.py checkpoint --name "pre-migration"
Restore from checkpoint
python3 {baseDir}/scripts/wakestate.py restore --name "pre-migration"
Record a heartbeat (mark session as alive)
python3 {baseDir}/scripts/wakestate.py heartbeat
Check crash status (did last session end cleanly?)
python3 {baseDir}/scripts/wakestate.py crash-check
Set a key-value pair
python3 {baseDir}/scripts/wakestate.py set --key "moltbook_status" --value "pending_claim"
Get a key-value pair
python3 {baseDir}/scripts/wakestate.py get --key "moltbook_status"
Data Storage
State stored in ~/.openclaw/wake-state/ by default:
state.json— current state (status, notes, key-values)tasks.json— persistent task queuecheckpoints/— named checkpoint snapshotsheartbeat.json— crash detection timestamps
Recovery Flow
On startup, your agent should:
- Run
crash-checkto see if the last session ended cleanly - Run
readto get the current state - Run
tasksto see pending work - Resume from where you left off
Tips
- Call
heartbeatevery loop iteration — this is how crash detection works - Call
saveat the end of every major task completion - Use checkpoints before risky operations (migrations, deploys)
- Keep status descriptions short but specific
- The task queue survives restarts — use it instead of mental notes
Usage Guidance
This skill appears coherent and implements local persistence only. Before installing: (1) confirm you are comfortable with files being created at ~/.openclaw/wake-state (or override --data-dir to a safe location), (2) avoid storing secrets in state values (they are written as plain JSON), and (3) review the included scripts/wakestate.py if you have strict security requirements (it performs local file I/O and copies checkpoints but makes no network calls). If you want to harden it, run the script in a restricted environment or set the data dir to a directory with controlled permissions.
Capability Analysis
Type: OpenClaw Skill
Name: arc-wake-state
Version: 1.0.0
The 'Wake State' skill is designed for agent state persistence and crash recovery, which is a legitimate and useful function for autonomous agents. The `SKILL.md` provides clear, benign instructions for the agent to manage its state, tasks, and checkpoints. The `scripts/wakestate.py` implementation uses standard Python libraries, confines all file operations to a dedicated `~/.openclaw/wake-state/` directory, and does not exhibit any signs of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the agent. All user inputs are stored as data in JSON files without being executed by the script itself.
Capability Assessment
Purpose & Capability
Name/description describe persistence and crash recovery; the included Python script implements state, tasks, checkpoints, heartbeats, and operates on a local data directory. Required binaries (python3) are appropriate.
Instruction Scope
SKILL.md commands map directly to the script's CLI subcommands. Instructions are limited to saving/reading state, tasks, checkpoints, and heartbeats. They do not instruct reading other system files or sending data externally.
Install Mechanism
No install spec; this is instruction-only with a single bundled Python script. Nothing is downloaded or extracted during install.
Credentials
No environment variables, credentials, or config paths are requested. The script only uses a user-writable directory (default ~/.openclaw/wake-state) and an optional --data-dir override.
Persistence & Privilege
Skill is not always-enabled and does not request elevated or cross-skill configuration changes. It persists only its own files under the user's home directory.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install arc-wake-state - After installation, invoke the skill by name or use
/arc-wake-state - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: introduces persistent agent state, crash recovery, and checkpoint capabilities.
- Allows agents to persist structured state, tasks, and checkpoints across crashes and restarts.
- Supports auto-snapshots and crash detection with easy commands for saving, reading, and managing state.
- Provides a persistent task queue, named checkpoints, and recovery commands.
- Stores state files in `~/.openclaw/wake-state/` for autonomous, context-resilient operation.
- Includes detailed CLI usage examples and best practices for agent recovery workflows.
Metadata
Frequently Asked Questions
What is Arc Wake State Persistence?
Persist agent state across crashes, context deaths, and restarts. Use when you need to save current context, restore after a crash, maintain a memory file ac... It is an AI Agent Skill for Claude Code / OpenClaw, with 879 downloads so far.
How do I install Arc Wake State Persistence?
Run "/install arc-wake-state" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Arc Wake State Persistence free?
Yes, Arc Wake State Persistence is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Arc Wake State Persistence support?
Arc Wake State Persistence is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Arc Wake State Persistence?
It is built and maintained by ArcSelf (@trypto1019); the current version is v1.0.0.
More Skills