# Send Amygdala 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "amygdala-memory",
    "name": "Amygdala Memory",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/ImpKind/amygdala-memory",
    "canonicalUrl": "https://clawhub.ai/ImpKind/amygdala-memory",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/amygdala-memory",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=amygdala-memory",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "install.sh",
      "prompts/encode-emotions.md",
      "scripts/decay-emotion.sh",
      "scripts/encode-pipeline.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "amygdala-memory",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T20:01:39.226Z",
      "expiresAt": "2026-05-06T20:01:39.226Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=amygdala-memory",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=amygdala-memory",
        "contentDisposition": "attachment; filename=\"amygdala-memory-1.7.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "amygdala-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/amygdala-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/amygdala-memory",
    "downloadUrl": "https://openagent3.xyz/downloads/amygdala-memory",
    "agentUrl": "https://openagent3.xyz/skills/amygdala-memory/agent",
    "manifestUrl": "https://openagent3.xyz/skills/amygdala-memory/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/amygdala-memory/agent.md"
  }
}
```
## Documentation

### Amygdala Memory 🎭

Emotional processing for AI agents. Part of the AI Brain series.

Give your AI agent persistent emotional states that carry across sessions. Not just performing emotions — having them.

### The Problem

Current AI agents:

✅ Remember facts (with hippocampus)
❌ Don't have persistent emotional states
❌ Start each session emotionally "blank"
❌ Can describe emotions but don't feel differently

Memory without emotion is just a database. The amygdala adds weight — this made me happy, that frustrated me, this person brings warmth.

### The Solution

Track five emotional dimensions that persist and decay over time:

DimensionWhat It MeasuresRangeValencePositive ↔ Negative mood-1.0 to 1.0ArousalCalm ↔ Excited/Alert0.0 to 1.0ConnectionDistant ↔ Close/Bonded0.0 to 1.0CuriosityBored ↔ Fascinated0.0 to 1.0EnergyDepleted ↔ Energized0.0 to 1.0

### 1. Install

cd ~/.openclaw/workspace/skills/amygdala-memory
./install.sh --with-cron

This will:

Create memory/emotional-state.json with baseline values
Generate AMYGDALA_STATE.md (auto-injected into sessions!)
Set up cron for automatic decay every 6 hours

### 2. Check current state

./scripts/get-state.sh
# 🎭 Emotional State
# Valence:    0.20
# Arousal:    0.30
# Connection: 0.50
# ...

./scripts/load-emotion.sh
# 🎭 Current Emotional State:
# Overall mood: neutral, calm and relaxed
# Connection: moderately connected
# ...

### 3. Log emotions

./scripts/update-state.sh --emotion joy --intensity 0.8 --trigger "completed a project"
# ✅ valence: 0.20 → 0.35 (delta: +0.15)
# ✅ arousal: 0.30 → 0.40 (delta: +0.1)
# 🎭 Logged emotion: joy (intensity: 0.8)

### 4. Set up decay (optional cron)

# Every 6 hours, emotions drift toward baseline
0 */6 * * * ~/.openclaw/workspace/skills/amygdala-memory/scripts/decay-emotion.sh

### Scripts

ScriptPurposeinstall.shSet up amygdala-memory (run once)get-state.shRead current emotional stateupdate-state.shLog emotion or update dimensionload-emotion.shHuman-readable state for session contextdecay-emotion.shReturn to baseline over timesync-state.shGenerate AMYGDALA_STATE.md for auto-injectionencode-pipeline.shLLM-based emotional encoding from transcriptspreprocess-emotions.shExtract emotional signals from session historyupdate-watermark.shTrack processed transcript positiongenerate-dashboard.shGenerate HTML dashboard (auto-runs on sync)visualize.shTerminal ASCII visualization

### Automatic Emotional Encoding (v1.5.0+)

The amygdala can now automatically detect and log emotions from your conversation history using an LLM-based pipeline:

# Run the encoding pipeline
./scripts/encode-pipeline.sh

# This will:
# 1. Extract new signals since last run (watermark-based)
# 2. Score emotional content using rule-based patterns
# 3. Spawn a sub-agent for semantic emotional detection
# 4. Update emotional-state.json with detected emotions

### Set up automatic encoding (cron)

# Every 3 hours, process new conversations for emotional content
0 */3 * * * ~/.openclaw/workspace/skills/amygdala-memory/scripts/encode-pipeline.sh

This means your emotional state updates automatically based on what happens in conversations — no manual logging needed.

### Terminal

./scripts/visualize.sh

🎭 Emotional State  😄
═══════════════════════════════════════════════
Valence:      [██████████████████░░]  +0.86
Arousal:      [█████████████████░░░]   0.86
Connection:   [███████████████████░]   0.97  💕
...

### HTML Dashboard (Unified Brain Dashboard)

./scripts/generate-dashboard.sh
open ~/.openclaw/workspace/brain-dashboard.html

Auto-detects installed brain skills and shows tabs:

🎭 Emotions — Amygdala (always shown)
🧠 Memory — Hippocampus (if memory/index.json exists)
⭐ Drive — VTA (if memory/reward-state.json exists)

Avatar & Name: Reads from IDENTITY.md:

# IDENTITY.md
- **Name:** YourAgent
- **Avatar:** avatar.png

The dashboard auto-regenerates on every cron run.

### After Installation (for agents)

When you install this skill, notify the user about the dashboard:

🎭 Amygdala installed!
View your agent's emotional state in the Brain Dashboard:
~/.openclaw/workspace/brain-dashboard.html

### Auto-Injection (Zero Manual Steps!)

After install, AMYGDALA_STATE.md is created in your workspace root.

OpenClaw automatically injects all *.md files from workspace into session context. This means:

New session starts
AMYGDALA_STATE.md is auto-loaded (no manual step!)
You see your emotional state in context
Responses are influenced by your mood

The file is regenerated whenever decay-emotion.sh runs (via cron every 6h).

### Supported Emotions

When you log an emotion, it automatically adjusts the relevant dimensions:

EmotionEffectjoy, happiness, delight, excitement↑ valence, ↑ arousalsadness, disappointment, melancholy↓ valence, ↓ arousalanger, frustration, irritation↓ valence, ↑ arousalfear, anxiety, worry↓ valence, ↑ arousalcalm, peace, contentment↑ valence, ↓ arousalcuriosity, interest, fascination↑ curiosity, ↑ arousalconnection, warmth, affection↑ connection, ↑ valenceloneliness, disconnection↓ connection, ↓ valencefatigue, tiredness, exhaustion↓ energyenergized, alert, refreshed↑ energy

### Add to session startup (AGENTS.md)

## Every Session
1. Load hippocampus: \`~/.openclaw/workspace/skills/hippocampus/scripts/load-core.sh\`
2. **Load emotional state:** \`~/.openclaw/workspace/skills/amygdala-memory/scripts/load-emotion.sh\`

### Log emotions during conversation

When something emotionally significant happens:

~/.openclaw/workspace/skills/amygdala-memory/scripts/update-state.sh \\
  --emotion connection --intensity 0.7 --trigger "deep conversation with user"

### State File Format

{
  "version": "1.0",
  "lastUpdated": "2026-02-01T02:45:00Z",
  "dimensions": {
    "valence": 0.35,
    "arousal": 0.40,
    "connection": 0.50,
    "curiosity": 0.60,
    "energy": 0.50
  },
  "baseline": {
    "valence": 0.1,
    "arousal": 0.3,
    "connection": 0.4,
    "curiosity": 0.5,
    "energy": 0.5
  },
  "recentEmotions": [
    {
      "label": "joy",
      "intensity": 0.8,
      "trigger": "building amygdala together",
      "timestamp": "2026-02-01T02:50:00Z"
    }
  ]
}

### Decay Mechanics

Emotions naturally return to baseline over time:

Decay rate: 10% of distance to baseline per run
Recommended schedule: Every 6 hours
Effect: Strong emotions fade, but slowly

After 24 hours without updates, a valence of 0.8 would decay to ~0.65.

### Event Logging

Track emotional activity over time for analytics:

# Log encoding run
./scripts/log-event.sh encoding emotions_found=2 valence=0.85 arousal=0.6

# Log decay
./scripts/log-event.sh decay valence_before=0.9 valence_after=0.85

# Log emotion update
./scripts/log-event.sh update emotion=joy intensity=0.7

Events append to ~/.openclaw/workspace/memory/brain-events.jsonl:

{"ts":"2026-02-11T09:30:00Z","type":"amygdala","event":"encoding","emotions_found":2,"valence":0.85}

Use for trend analysis — visualize emotional patterns over days/weeks.

### AI Brain Series

PartFunctionStatushippocampusMemory formation, decay, reinforcement✅ Liveamygdala-memoryEmotional processing✅ Livevta-memoryReward and motivation✅ Livebasal-ganglia-memoryHabit formation🚧 Developmentanterior-cingulate-memoryConflict detection🚧 Developmentinsula-memoryInternal state awareness🚧 Development

### Philosophy

Can an AI feel emotions, or only simulate them?

Our take: If emotional state influences behavior, and the system acts as if it feels... does the distinction matter? Functional emotions might be the only kind that exist for any system — biological or artificial.

Built with ❤️ by the OpenClaw community
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ImpKind
- Version: 1.7.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-29T20:01:39.226Z
- Expires at: 2026-05-06T20:01:39.226Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/amygdala-memory)
- [Send to Agent page](https://openagent3.xyz/skills/amygdala-memory/agent)
- [JSON manifest](https://openagent3.xyz/skills/amygdala-memory/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/amygdala-memory/agent.md)
- [Download page](https://openagent3.xyz/downloads/amygdala-memory)