Arc Wake State Persistence

这是适配OpenClaw的Wake State工具，核心功能含结构化状态存储、自动快照、崩溃检测、持久任务队列、checkpoint备份恢复。适用于自主代理因上下文窗口限制重启、崩溃后恢复场景。通过Python脚本执行存/读状态、增删任务等命令，输出可解析的结构化数据，状态本地JSON存储，助力代理重启后无缝衔接工作。

Trypto1019

热度 60.91

最近更新 2026-02-26 06:25:35

分类：自动化依赖：代码执行 / 读写文件应用场景：自动化脚本 / 任务管理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add arc-wake-state

Metadata

name: 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 across sessions, or implement crash recovery. Essential for autonomous agents that must survive context window limits.
user-invocable: true
metadata: {"openclaw":{"emoji":"🧠","os":["darwin","linux"],"requires":{"bins":["python3"]}}}

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