auto-drive

# Auto-Drive Skill

Permanent decentralized memory on the Autonomys Network with linked-list memory chains for agent resurrection. Works with agents powered by Claude, GPT, Gemini, and any LLM that supports OpenClaw skills.

## What This Skill Does

1. **Upload files** to Auto Drive and get back a CID (Content Identifier) — a permanent, immutable address on the Autonomys distributed storage network.
2. **Download files** from Auto Drive using a CID — uses the authenticated API if a key is set, otherwise falls back to the public gateway.
3. **Save memories as a chain** — each memory entry is a JSON experience with a `header.previousCid` pointer, forming a linked list stored permanently on-chain.
4. **Resurrect from a chain** — given the latest CID, walk the chain backwards to reconstruct full agent history.

## When To Use This Skill

- User says "save this to Auto-Drive" or "upload to Autonomys" or "store permanently"
- User says "download from Auto-Drive" or provides a CID to retrieve
- User says "save memory", "remember this permanently", or "checkpoint"
- User says "resurrect", "recall chain", "rebuild memory", or "load history"
- Any time the user wants data stored permanently and immutably on a decentralized network

## Post-Install

After installing via ClawHub, make the scripts executable:

```bash
chmod +x skills/auto-drive/scripts/*.sh
```

ClawHub does not currently preserve file permissions during install.

## Configuration

### API Key

Requires an `AUTO_DRIVE_API_KEY`. Run the guided setup script for the easiest path:

```bash
scripts/setup-auto-drive.sh
```

This opens [explorer.ai3.storage](https://explorer.ai3.storage/mainnet/drive/developers) in your browser, prompts for the key, saves it to `~/.openclaw/.env`, and verifies the connection.

**Manual setup:**

1. Navigate to **https://explorer.ai3.storage** (not `ai3.storage` — that's just the landing page)
2. Check authentication: if the sidebar shows a "Log In" button or lock icons on My Files / Pr...