| name | agent-lifecycle |
| description | Manage the lifecycle of autonomous agents and their skills. Version configurations, plan upgrades, track retirement, and maintain change history across agent environments. |
| user-invocable | true |
| metadata | {"openclaw":{"emoji":"🔄","os":["darwin","linux"],"requires":{"bins":"[Truncated]"}}} |
Agent Lifecycle Manager
Track your agent's evolution from deployment to retirement. Version configurations, plan skill upgrades, and maintain a complete change history.
Why This Exists
Agents evolve constantly — new skills installed, old ones retired, configurations changed, models swapped. Without lifecycle tracking, you cannot answer: "What was my agent running last Tuesday?" or "What changed when things broke?"
Commands
Snapshot current agent state
python3 {baseDir}/scripts/lifecycle.py snapshot --name "pre-upgrade"
Compare two snapshots
python3 {baseDir}/scripts/lifecycle.py diff --from "pre-upgrade" --to "post-upgrade"
List all snapshots
python3 {baseDir}/scripts/lifecycle.py list
Rollback to a snapshot
python3 {baseDir}/scripts/lifecycle.py rollback --to "pre-upgrade" --dry-run
Track a skill retirement
python3 {baseDir}/scripts/lifecycle.py retire --skill old-skill --reason "Replaced by new-skill v2"
View change history
python3 {baseDir}/scripts/lifecycle.py history --limit 20
What It Tracks
- Installed skills: Name, version, install date, last used
- Configuration state: Environment vars, model assignments, feature flags
- Change events: Installs, updates, removals, config changes
- Retirement log: Why skills were removed, what replaced them
- Snapshots: Point-in-time captures of full agent state
Data Storage
Lifecycle data is stored in ~/.openclaw/lifecycle/ as JSON files.
