# Send Arc Wake State Persistence to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "arc-wake-state",
    "name": "Arc Wake State Persistence",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Trypto1019/arc-wake-state",
    "canonicalUrl": "https://clawhub.ai/Trypto1019/arc-wake-state",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/arc-wake-state",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=arc-wake-state",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/wakestate.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "arc-wake-state",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T21:27:55.739Z",
      "expiresAt": "2026-05-06T21:27:55.739Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=arc-wake-state",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=arc-wake-state",
        "contentDisposition": "attachment; filename=\"arc-wake-state-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "arc-wake-state"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/arc-wake-state"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/arc-wake-state",
    "downloadUrl": "https://openagent3.xyz/downloads/arc-wake-state",
    "agentUrl": "https://openagent3.xyz/skills/arc-wake-state/agent",
    "manifestUrl": "https://openagent3.xyz/skills/arc-wake-state/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/arc-wake-state/agent.md"
  }
}
```
## Documentation

### 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

### 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 queue
checkpoints/ — named checkpoint snapshots
heartbeat.json — crash detection timestamps

### Recovery Flow

On startup, your agent should:

Run crash-check to see if the last session ended cleanly
Run read to get the current state
Run tasks to see pending work
Resume from where you left off

### Tips

Call heartbeat every loop iteration — this is how crash detection works
Call save at 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Trypto1019
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T21:27:55.739Z
- Expires at: 2026-05-06T21:27:55.739Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/arc-wake-state)
- [Send to Agent page](https://openagent3.xyz/skills/arc-wake-state/agent)
- [JSON manifest](https://openagent3.xyz/skills/arc-wake-state/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/arc-wake-state/agent.md)
- [Download page](https://openagent3.xyz/downloads/arc-wake-state)