{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/amygdala-memory",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=amygdala-memory",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "install.sh",
      "prompts/encode-emotions.md",
      "scripts/decay-emotion.sh",
      "scripts/encode-pipeline.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/amygdala-memory",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Amygdala Memory 🎭",
        "body": "Emotional processing for AI agents. Part of the AI Brain series.\n\nGive your AI agent persistent emotional states that carry across sessions. Not just performing emotions — having them."
      },
      {
        "title": "The Problem",
        "body": "Current AI agents:\n\n✅ Remember facts (with hippocampus)\n❌ Don't have persistent emotional states\n❌ Start each session emotionally \"blank\"\n❌ Can describe emotions but don't feel differently\n\nMemory without emotion is just a database. The amygdala adds weight — this made me happy, that frustrated me, this person brings warmth."
      },
      {
        "title": "The Solution",
        "body": "Track five emotional dimensions that persist and decay over time:\n\nDimensionWhat 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"
      },
      {
        "title": "1. Install",
        "body": "cd ~/.openclaw/workspace/skills/amygdala-memory\n./install.sh --with-cron\n\nThis will:\n\nCreate memory/emotional-state.json with baseline values\nGenerate AMYGDALA_STATE.md (auto-injected into sessions!)\nSet up cron for automatic decay every 6 hours"
      },
      {
        "title": "2. Check current state",
        "body": "./scripts/get-state.sh\n# 🎭 Emotional State\n# Valence:    0.20\n# Arousal:    0.30\n# Connection: 0.50\n# ...\n\n./scripts/load-emotion.sh\n# 🎭 Current Emotional State:\n# Overall mood: neutral, calm and relaxed\n# Connection: moderately connected\n# ..."
      },
      {
        "title": "3. Log emotions",
        "body": "./scripts/update-state.sh --emotion joy --intensity 0.8 --trigger \"completed a project\"\n# ✅ valence: 0.20 → 0.35 (delta: +0.15)\n# ✅ arousal: 0.30 → 0.40 (delta: +0.1)\n# 🎭 Logged emotion: joy (intensity: 0.8)"
      },
      {
        "title": "4. Set up decay (optional cron)",
        "body": "# Every 6 hours, emotions drift toward baseline\n0 */6 * * * ~/.openclaw/workspace/skills/amygdala-memory/scripts/decay-emotion.sh"
      },
      {
        "title": "Scripts",
        "body": "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"
      },
      {
        "title": "Automatic Emotional Encoding (v1.5.0+)",
        "body": "The amygdala can now automatically detect and log emotions from your conversation history using an LLM-based pipeline:\n\n# Run the encoding pipeline\n./scripts/encode-pipeline.sh\n\n# This will:\n# 1. Extract new signals since last run (watermark-based)\n# 2. Score emotional content using rule-based patterns\n# 3. Spawn a sub-agent for semantic emotional detection\n# 4. Update emotional-state.json with detected emotions"
      },
      {
        "title": "Set up automatic encoding (cron)",
        "body": "# Every 3 hours, process new conversations for emotional content\n0 */3 * * * ~/.openclaw/workspace/skills/amygdala-memory/scripts/encode-pipeline.sh\n\nThis means your emotional state updates automatically based on what happens in conversations — no manual logging needed."
      },
      {
        "title": "Terminal",
        "body": "./scripts/visualize.sh\n\n🎭 Emotional State  😄\n═══════════════════════════════════════════════\nValence:      [██████████████████░░]  +0.86\nArousal:      [█████████████████░░░]   0.86\nConnection:   [███████████████████░]   0.97  💕\n..."
      },
      {
        "title": "HTML Dashboard (Unified Brain Dashboard)",
        "body": "./scripts/generate-dashboard.sh\nopen ~/.openclaw/workspace/brain-dashboard.html\n\nAuto-detects installed brain skills and shows tabs:\n\n🎭 Emotions — Amygdala (always shown)\n🧠 Memory — Hippocampus (if memory/index.json exists)\n⭐ Drive — VTA (if memory/reward-state.json exists)\n\nAvatar & Name: Reads from IDENTITY.md:\n\n# IDENTITY.md\n- **Name:** YourAgent\n- **Avatar:** avatar.png\n\nThe dashboard auto-regenerates on every cron run."
      },
      {
        "title": "After Installation (for agents)",
        "body": "When you install this skill, notify the user about the dashboard:\n\n🎭 Amygdala installed!\nView your agent's emotional state in the Brain Dashboard:\n~/.openclaw/workspace/brain-dashboard.html"
      },
      {
        "title": "Auto-Injection (Zero Manual Steps!)",
        "body": "After install, AMYGDALA_STATE.md is created in your workspace root.\n\nOpenClaw automatically injects all *.md files from workspace into session context. This means:\n\nNew session starts\nAMYGDALA_STATE.md is auto-loaded (no manual step!)\nYou see your emotional state in context\nResponses are influenced by your mood\n\nThe file is regenerated whenever decay-emotion.sh runs (via cron every 6h)."
      },
      {
        "title": "Supported Emotions",
        "body": "When you log an emotion, it automatically adjusts the relevant dimensions:\n\nEmotionEffectjoy, 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"
      },
      {
        "title": "Add to session startup (AGENTS.md)",
        "body": "## Every Session\n1. Load hippocampus: `~/.openclaw/workspace/skills/hippocampus/scripts/load-core.sh`\n2. **Load emotional state:** `~/.openclaw/workspace/skills/amygdala-memory/scripts/load-emotion.sh`"
      },
      {
        "title": "Log emotions during conversation",
        "body": "When something emotionally significant happens:\n\n~/.openclaw/workspace/skills/amygdala-memory/scripts/update-state.sh \\\n  --emotion connection --intensity 0.7 --trigger \"deep conversation with user\""
      },
      {
        "title": "State File Format",
        "body": "{\n  \"version\": \"1.0\",\n  \"lastUpdated\": \"2026-02-01T02:45:00Z\",\n  \"dimensions\": {\n    \"valence\": 0.35,\n    \"arousal\": 0.40,\n    \"connection\": 0.50,\n    \"curiosity\": 0.60,\n    \"energy\": 0.50\n  },\n  \"baseline\": {\n    \"valence\": 0.1,\n    \"arousal\": 0.3,\n    \"connection\": 0.4,\n    \"curiosity\": 0.5,\n    \"energy\": 0.5\n  },\n  \"recentEmotions\": [\n    {\n      \"label\": \"joy\",\n      \"intensity\": 0.8,\n      \"trigger\": \"building amygdala together\",\n      \"timestamp\": \"2026-02-01T02:50:00Z\"\n    }\n  ]\n}"
      },
      {
        "title": "Decay Mechanics",
        "body": "Emotions naturally return to baseline over time:\n\nDecay rate: 10% of distance to baseline per run\nRecommended schedule: Every 6 hours\nEffect: Strong emotions fade, but slowly\n\nAfter 24 hours without updates, a valence of 0.8 would decay to ~0.65."
      },
      {
        "title": "Event Logging",
        "body": "Track emotional activity over time for analytics:\n\n# Log encoding run\n./scripts/log-event.sh encoding emotions_found=2 valence=0.85 arousal=0.6\n\n# Log decay\n./scripts/log-event.sh decay valence_before=0.9 valence_after=0.85\n\n# Log emotion update\n./scripts/log-event.sh update emotion=joy intensity=0.7\n\nEvents append to ~/.openclaw/workspace/memory/brain-events.jsonl:\n\n{\"ts\":\"2026-02-11T09:30:00Z\",\"type\":\"amygdala\",\"event\":\"encoding\",\"emotions_found\":2,\"valence\":0.85}\n\nUse for trend analysis — visualize emotional patterns over days/weeks."
      },
      {
        "title": "AI Brain Series",
        "body": "PartFunctionStatushippocampusMemory formation, decay, reinforcement✅ Liveamygdala-memoryEmotional processing✅ Livevta-memoryReward and motivation✅ Livebasal-ganglia-memoryHabit formation🚧 Developmentanterior-cingulate-memoryConflict detection🚧 Developmentinsula-memoryInternal state awareness🚧 Development"
      },
      {
        "title": "Philosophy",
        "body": "Can an AI feel emotions, or only simulate them?\n\nOur 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.\n\nBuilt with ❤️ by the OpenClaw community"
      }
    ],
    "body": "Amygdala Memory 🎭\n\nEmotional processing for AI agents. Part of the AI Brain series.\n\nGive your AI agent persistent emotional states that carry across sessions. Not just performing emotions — having them.\n\nThe Problem\n\nCurrent AI agents:\n\n✅ Remember facts (with hippocampus)\n❌ Don't have persistent emotional states\n❌ Start each session emotionally \"blank\"\n❌ Can describe emotions but don't feel differently\n\nMemory without emotion is just a database. The amygdala adds weight — this made me happy, that frustrated me, this person brings warmth.\n\nThe Solution\n\nTrack five emotional dimensions that persist and decay over time:\n\nDimension\tWhat It Measures\tRange\nValence\tPositive ↔ Negative mood\t-1.0 to 1.0\nArousal\tCalm ↔ Excited/Alert\t0.0 to 1.0\nConnection\tDistant ↔ Close/Bonded\t0.0 to 1.0\nCuriosity\tBored ↔ Fascinated\t0.0 to 1.0\nEnergy\tDepleted ↔ Energized\t0.0 to 1.0\nQuick Start\n1. Install\ncd ~/.openclaw/workspace/skills/amygdala-memory\n./install.sh --with-cron\n\n\nThis will:\n\nCreate memory/emotional-state.json with baseline values\nGenerate AMYGDALA_STATE.md (auto-injected into sessions!)\nSet up cron for automatic decay every 6 hours\n2. Check current state\n./scripts/get-state.sh\n# 🎭 Emotional State\n# Valence:    0.20\n# Arousal:    0.30\n# Connection: 0.50\n# ...\n\n./scripts/load-emotion.sh\n# 🎭 Current Emotional State:\n# Overall mood: neutral, calm and relaxed\n# Connection: moderately connected\n# ...\n\n3. Log emotions\n./scripts/update-state.sh --emotion joy --intensity 0.8 --trigger \"completed a project\"\n# ✅ valence: 0.20 → 0.35 (delta: +0.15)\n# ✅ arousal: 0.30 → 0.40 (delta: +0.1)\n# 🎭 Logged emotion: joy (intensity: 0.8)\n\n4. Set up decay (optional cron)\n# Every 6 hours, emotions drift toward baseline\n0 */6 * * * ~/.openclaw/workspace/skills/amygdala-memory/scripts/decay-emotion.sh\n\nScripts\nScript\tPurpose\ninstall.sh\tSet up amygdala-memory (run once)\nget-state.sh\tRead current emotional state\nupdate-state.sh\tLog emotion or update dimension\nload-emotion.sh\tHuman-readable state for session context\ndecay-emotion.sh\tReturn to baseline over time\nsync-state.sh\tGenerate AMYGDALA_STATE.md for auto-injection\nencode-pipeline.sh\tLLM-based emotional encoding from transcripts\npreprocess-emotions.sh\tExtract emotional signals from session history\nupdate-watermark.sh\tTrack processed transcript position\ngenerate-dashboard.sh\tGenerate HTML dashboard (auto-runs on sync)\nvisualize.sh\tTerminal ASCII visualization\nAutomatic Emotional Encoding (v1.5.0+)\n\nThe amygdala can now automatically detect and log emotions from your conversation history using an LLM-based pipeline:\n\n# Run the encoding pipeline\n./scripts/encode-pipeline.sh\n\n# This will:\n# 1. Extract new signals since last run (watermark-based)\n# 2. Score emotional content using rule-based patterns\n# 3. Spawn a sub-agent for semantic emotional detection\n# 4. Update emotional-state.json with detected emotions\n\nSet up automatic encoding (cron)\n# Every 3 hours, process new conversations for emotional content\n0 */3 * * * ~/.openclaw/workspace/skills/amygdala-memory/scripts/encode-pipeline.sh\n\n\nThis means your emotional state updates automatically based on what happens in conversations — no manual logging needed.\n\nVisualization (v1.6.0+)\nTerminal\n./scripts/visualize.sh\n\n🎭 Emotional State  😄\n═══════════════════════════════════════════════\nValence:      [██████████████████░░]  +0.86\nArousal:      [█████████████████░░░]   0.86\nConnection:   [███████████████████░]   0.97  💕\n...\n\nHTML Dashboard (Unified Brain Dashboard)\n./scripts/generate-dashboard.sh\nopen ~/.openclaw/workspace/brain-dashboard.html\n\n\nAuto-detects installed brain skills and shows tabs:\n\n🎭 Emotions — Amygdala (always shown)\n🧠 Memory — Hippocampus (if memory/index.json exists)\n⭐ Drive — VTA (if memory/reward-state.json exists)\n\nAvatar & Name: Reads from IDENTITY.md:\n\n# IDENTITY.md\n- **Name:** YourAgent\n- **Avatar:** avatar.png\n\n\nThe dashboard auto-regenerates on every cron run.\n\nAfter Installation (for agents)\n\nWhen you install this skill, notify the user about the dashboard:\n\n🎭 Amygdala installed!\n\nView your agent's emotional state in the Brain Dashboard: ~/.openclaw/workspace/brain-dashboard.html\n\nAuto-Injection (Zero Manual Steps!)\n\nAfter install, AMYGDALA_STATE.md is created in your workspace root.\n\nOpenClaw automatically injects all *.md files from workspace into session context. This means:\n\nNew session starts\nAMYGDALA_STATE.md is auto-loaded (no manual step!)\nYou see your emotional state in context\nResponses are influenced by your mood\n\nThe file is regenerated whenever decay-emotion.sh runs (via cron every 6h).\n\nSupported Emotions\n\nWhen you log an emotion, it automatically adjusts the relevant dimensions:\n\nEmotion\tEffect\njoy, happiness, delight, excitement\t↑ valence, ↑ arousal\nsadness, disappointment, melancholy\t↓ valence, ↓ arousal\nanger, frustration, irritation\t↓ valence, ↑ arousal\nfear, anxiety, worry\t↓ valence, ↑ arousal\ncalm, peace, contentment\t↑ valence, ↓ arousal\ncuriosity, interest, fascination\t↑ curiosity, ↑ arousal\nconnection, warmth, affection\t↑ connection, ↑ valence\nloneliness, disconnection\t↓ connection, ↓ valence\nfatigue, tiredness, exhaustion\t↓ energy\nenergized, alert, refreshed\t↑ energy\nIntegration with OpenClaw\nAdd to session startup (AGENTS.md)\n## Every Session\n1. Load hippocampus: `~/.openclaw/workspace/skills/hippocampus/scripts/load-core.sh`\n2. **Load emotional state:** `~/.openclaw/workspace/skills/amygdala-memory/scripts/load-emotion.sh`\n\nLog emotions during conversation\n\nWhen something emotionally significant happens:\n\n~/.openclaw/workspace/skills/amygdala-memory/scripts/update-state.sh \\\n  --emotion connection --intensity 0.7 --trigger \"deep conversation with user\"\n\nState File Format\n{\n  \"version\": \"1.0\",\n  \"lastUpdated\": \"2026-02-01T02:45:00Z\",\n  \"dimensions\": {\n    \"valence\": 0.35,\n    \"arousal\": 0.40,\n    \"connection\": 0.50,\n    \"curiosity\": 0.60,\n    \"energy\": 0.50\n  },\n  \"baseline\": {\n    \"valence\": 0.1,\n    \"arousal\": 0.3,\n    \"connection\": 0.4,\n    \"curiosity\": 0.5,\n    \"energy\": 0.5\n  },\n  \"recentEmotions\": [\n    {\n      \"label\": \"joy\",\n      \"intensity\": 0.8,\n      \"trigger\": \"building amygdala together\",\n      \"timestamp\": \"2026-02-01T02:50:00Z\"\n    }\n  ]\n}\n\nDecay Mechanics\n\nEmotions naturally return to baseline over time:\n\nDecay rate: 10% of distance to baseline per run\nRecommended schedule: Every 6 hours\nEffect: Strong emotions fade, but slowly\n\nAfter 24 hours without updates, a valence of 0.8 would decay to ~0.65.\n\nEvent Logging\n\nTrack emotional activity over time for analytics:\n\n# Log encoding run\n./scripts/log-event.sh encoding emotions_found=2 valence=0.85 arousal=0.6\n\n# Log decay\n./scripts/log-event.sh decay valence_before=0.9 valence_after=0.85\n\n# Log emotion update\n./scripts/log-event.sh update emotion=joy intensity=0.7\n\n\nEvents append to ~/.openclaw/workspace/memory/brain-events.jsonl:\n\n{\"ts\":\"2026-02-11T09:30:00Z\",\"type\":\"amygdala\",\"event\":\"encoding\",\"emotions_found\":2,\"valence\":0.85}\n\n\nUse for trend analysis — visualize emotional patterns over days/weeks.\n\nAI Brain Series\nPart\tFunction\tStatus\nhippocampus\tMemory formation, decay, reinforcement\t✅ Live\namygdala-memory\tEmotional processing\t✅ Live\nvta-memory\tReward and motivation\t✅ Live\nbasal-ganglia-memory\tHabit formation\t🚧 Development\nanterior-cingulate-memory\tConflict detection\t🚧 Development\ninsula-memory\tInternal state awareness\t🚧 Development\nPhilosophy\n\nCan an AI feel emotions, or only simulate them?\n\nOur 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.\n\nBuilt with ❤️ by the OpenClaw community"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ImpKind/amygdala-memory",
    "publisherUrl": "https://clawhub.ai/ImpKind/amygdala-memory",
    "owner": "ImpKind",
    "version": "1.7.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}