# Send Memory 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": "memory",
    "name": "Memory",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/ivangdavila/memory",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/memory",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/memory",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "memory-template.md",
      "patterns.md",
      "setup.md",
      "troubleshooting.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "memory",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T08:18:33.101Z",
      "expiresAt": "2026-05-09T08:18:33.101Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory",
        "contentDisposition": "attachment; filename=\"memory-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "memory"
      },
      "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/memory"
    },
    "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/memory",
    "downloadUrl": "https://openagent3.xyz/downloads/memory",
    "agentUrl": "https://openagent3.xyz/skills/memory/agent",
    "manifestUrl": "https://openagent3.xyz/skills/memory/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/memory/agent.md"
  }
}
```
## Documentation

### Memory 🧠

Superpowered memory that never forgets.

Your agent has basic built-in memory. This skill adds infinite, perfectly organized memory for everything else — parallel and complementary, never conflicting.

### How It Works

Built-in Agent Memory          This Skill (~/memory/)
┌─────────────────────┐        ┌─────────────────────────────┐
│ MEMORY.md           │        │ Infinite categorized storage │
│ memory/ (daily logs)│   +    │ Any structure you want       │
│ Basic recall        │        │ Perfect organization         │
└─────────────────────┘        └─────────────────────────────┘
         ↓                                  ↓
   Agent basics                    Everything else
   (works automatically)           (scales infinitely)

Not a replacement. Your agent's built-in memory keeps working. This adds a parallel system for unlimited, organized storage.

### Setup

On first use, read setup.md to configure the memory system with the user. Key decisions:

What categories do they need?
Should we sync anything from built-in memory?
How do they want to find things?

### When to Use

User needs organized long-term storage beyond basic agent memory: detailed project histories, extensive contact networks, decision logs, domain knowledge, collections, or any structured data that grows over time.

### Architecture

Memory lives in ~/memory/ — a dedicated folder separate from built-in agent memory.

~/memory/
├── config.md              # System configuration
├── INDEX.md               # What's stored, where to find it
│
├── [user-defined]/        # Categories the user needs
│   ├── INDEX.md           # Category overview
│   └── {items}.md         # Individual entries
│
└── sync/                  # Optional: synced from built-in memory
    └── ...

The user defines the categories. Common examples:

projects/ — detailed project context
people/ — contact network with full context
decisions/ — reasoning behind choices
knowledge/ — domain expertise, reference material
collections/ — books, recipes, anything they collect

See memory-template.md for all templates.

### Quick Reference

TopicFileFirst-time setupsetup.mdAll templatesmemory-template.mdOrganization patternspatterns.mdProblems & fixestroubleshooting.md

### 1. Separate from Built-In Memory

This system lives in ~/memory/. Never modify:

Agent's MEMORY.md (workspace root)
Agent's memory/ folder (if it exists in workspace)

Parallel, not replacement. Both systems work together.

### 2. User Defines Structure

During setup, ask what they want to store. Create categories based on their needs:

They say...Create"I have many projects"~/memory/projects/"I meet lots of people"~/memory/people/"I want to track decisions"~/memory/decisions/"I'm learning [topic]"~/memory/knowledge/[topic]/"I collect [things]"~/memory/collections/[things]/

No preset structure. Build what they need.

### 3. Every Category Has an Index

Each folder gets an INDEX.md that lists contents:

# Projects Index

| Name | Status | Updated | File |
|------|--------|---------|------|
| Alpha | Active | 2026-02 | alpha.md |
| Beta | Paused | 2026-01 | beta.md |

Total: 2 active, 5 archived

Indices stay small (<100 entries). When full, split into subcategories.

### 4. Write Immediately

When user shares important information:

Write to appropriate file in ~/memory/
Update the category INDEX.md
Then respond

Don't wait. Don't batch. Write immediately.

### 5. Search Then Navigate

To find information:

Ask first: "Is this in ~/memory/ or built-in memory?"
Search: grep or semantic search in ~/memory/
Navigate: INDEX.md → category → specific file

# Quick search
grep -r "keyword" ~/memory/

# Navigate
cat ~/memory/INDEX.md           # What categories exist?
cat ~/memory/projects/INDEX.md  # What projects?
cat ~/memory/projects/alpha.md  # Specific project

### 6. Sync from Built-In (Optional)

If user wants certain info copied from built-in memory:

~/memory/sync/
├── preferences.md    # Synced from built-in
└── decisions.md      # Synced from built-in

Sync is one-way: Built-in → this system. Never modify built-in.

### 7. Scale by Splitting

When a category grows large:

INDEX.md > 100 entries → split into subcategories
Create sub-INDEX.md for each subcategory
Root INDEX.md points to subcategories

~/memory/projects/
├── INDEX.md           # "See active/, archived/"
├── active/
│   ├── INDEX.md       # 30 active projects
│   └── ...
└── archived/
    ├── INDEX.md       # 200 archived projects
    └── ...

### What to Store Here (vs Built-In)

Store HERE (~/memory/)Keep in BUILT-INDetailed project historiesCurrent project statusFull contact profilesKey contacts quick-refAll decision reasoningRecent decisionsDomain knowledge basesQuick factsCollections, inventories—Anything that grows largeSummaries

Rule: Built-in for quick context. Here for depth and scale.

### For Small Memory (<50 files)

# Grep is fast enough
grep -r "keyword" ~/memory/

### For Large Memory (50+ files)

Navigate via indices:

1. ~/memory/INDEX.md → find category
2. ~/memory/{category}/INDEX.md → find item
3. ~/memory/{category}/{item}.md → read details

### For Huge Memory (500+ files)

Use semantic search if available, or hierarchical indices:

~/memory/projects/INDEX.md → "web projects in web/"
~/memory/projects/web/INDEX.md → "alpha project"
~/memory/projects/web/alpha.md → details

### Weekly (5 min)

Update INDEX.md files if entries added
Archive completed/inactive items

### Monthly (15 min)

Review category sizes
Split large categories
Remove outdated entries

### When Memory is Slow

Check INDEX.md sizes (keep <100 lines)
Split big categories into subcategories
Archive old content

### Common Traps

Modifying built-in memory → Never touch agent's MEMORY.md or workspace memory/. This system is parallel.


No indices → Without INDEX.md, finding things requires searching all files. Always maintain indices.


One giant category → 500 items in one folder is slow. Split into subcategories.


Syncing everything → Don't copy all built-in memory. Only sync what needs organization here.


Waiting to write → Write immediately when user shares info. Don't batch.

### Security & Privacy

Data location:

All data in ~/memory/ on user's machine
No external services required
No network requests

This skill does NOT:

Access built-in agent memory (only reads if syncing)
Send data anywhere
Store credentials (never store secrets in memory)

### Related Skills

Install with clawhub install <slug> if user confirms:

decide - Decision tracking patterns
escalate - When to involve humans
learn - Adaptive learning

### Feedback

If useful: clawhub star memory
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.2
## 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-05-02T08:18:33.101Z
- Expires at: 2026-05-09T08:18:33.101Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/memory)
- [Send to Agent page](https://openagent3.xyz/skills/memory/agent)
- [JSON manifest](https://openagent3.xyz/skills/memory/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/memory/agent.md)
- [Download page](https://openagent3.xyz/downloads/memory)