📦 Amygdala Memory — 技能工具

v2.0.0

Emotional processing layer for AI agents. Persistent emotional states that influence behavior and responses. Part of the AI Brain series.

0· 28·0 当前·0 累计
by @alvisdunlop (AlvisDunlop)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/4/15
0
安全扫描
VirusTotal
可疑
查看报告
OpenClaw
可疑
medium confidence
The skill's purpose (emotion memory + LLM-based encoding) aligns with requiring a SkillBoss API key and small CLI tools, but the SKILL.md instructs background cron jobs, automatic ingesting of conversation transcripts to an external API, and references many install scripts that are not present in the package — this raises privacy and coherence concerns you should review before installing.
评估建议
This skill's purpose is coherent with needing jq/awk and a SkillBoss API key, but exercise caution: 1) The package contains only SKILL.md — no install or pipeline scripts — so do not run any install.sh or cron commands until you have obtained and inspected the actual scripts (preferably from the referenced GitHub repo). 2) The encode pipeline explicitly sends conversation transcripts to SkillBoss (/v1/pilot). If you install it, you will be transmitting chat history to a third party; confirm what...
详细分析 ▾
用途与能力
The stated goal (persistent emotional state with an LLM-based encoder) reasonably explains the declared requirements: jq/awk for local JSON processing and SkillBoss_API_KEY for calls to SkillBoss API Hub. However, the registry lists source as 'unknown' while SKILL.md includes a GitHub repo URL; the package contains no scripts despite the README-style instructions that expect many local scripts (install.sh, encode-pipeline.sh, etc.).
指令范围
SKILL.md instructs extracting conversation history, running an encode pipeline that 'calls SkillBoss API Hub (/v1/pilot)', and setting up cron jobs that automatically process transcripts every few hours. It also describes creating AMYGDALA_STATE.md which OpenClaw will auto-inject into sessions. These instructions imply sending potentially sensitive conversation content to a third-party service and automatic background processing; the document does not describe data minimization, consent, or what exact transcript content is sent. Additionally, the instructions reference many scripts and files that are not present in the submitted skill bundle.
安装机制
There is no install spec in the registry (instruction-only), so nothing will be written by the platform itself. But SKILL.md tells the user to run install.sh and set up cron to write files and schedule background tasks. Because the package lacks those scripts, a user would either fetch them from the referenced GitHub repo or run custom commands — you should inspect the actual install scripts before executing them.
凭证需求
Only SkillBoss_API_KEY is required — which makes sense if the skill calls SkillBoss. However, that key would be used to send conversation transcripts and derived emotion data to a third party; this is privacy-sensitive. The skill also auto-creates files that are injected into session context (AMYGDALA_STATE.md), which may contain or surface user data. The SKILL.md does not document what is sent, retention policy, or whether sensitive tokens/PII might be transmitted.
持久化与权限
always:false (good). The skill expects to create persistent state files in the user's workspace and to schedule cron jobs for periodic decay and encoding. While not an elevated platform privilege, this persistent presence combined with automatic transcript processing increases the risk footprint — review cron entries and generated files before enabling them.
安全有层次,运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发,无需署名。

运行时依赖

无特殊依赖

版本

latestv2.0.02026/4/15

Fixed API to api.skillboss.co

可疑

安装命令

点击复制
官方npx clawhub@latest install alvis2-amygdala-memory
镜像加速npx clawhub@latest install alvis2-amygdala-memory --registry https://cn.longxiaskill.com

技能文档

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 MeasuresRange
ValencePositive ? Negative mood-1.0 to 1.0
ArousalCalm ? Excited/Alert0.0 to 1.0
ConnectionDistant ? Close/Bonded0.0 to 1.0
CuriosityBored ? Fascinated0.0 to 1.0
EnergyDepleted ? Energized0.0 to 1.0

Quick Start

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

ScriptPurpose
install.shSet up amygdala-memory (run once)
get-state.shRead current emotional state
update-state.shLog emotion or update dimension
load-emotion.shHuman-readable state for session context
decay-emotion.shReturn to baseline over time
sync-state.shGenerate AMYGDALA_STATE.md for auto-injection
encode-pipeline.shSkillBoss API Hub LLM-based emotional encoding from transcripts
preprocess-emotions.shExtract emotional signals from session history
update-watermark.shTrack processed transcript position
generate-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 SkillBoss API Hub for LLM-based semantic emotional detection:

# 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. Call SkillBoss API Hub (/v1/pilot) 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.

Visualization (v1.6.0+)

Terminal

./scripts/visualize.sh

?? Emotional State ?? �T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T 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:

EmotionEffect
joy, happiness, delight, excitement�� valence, �� arousal
sadness, disappointment, melancholy�� valence, �� arousal
anger, frustration, irritation�� valence, �� arousal
fear, anxiety, worry�� valence, �� arousal
calm, peace, contentment�� valence, �� arousal
curiosity, interest, fascination�� curiosity, �� arousal
connection, warmth, affection�� connection, �� valence
loneliness, disconnection�� connection, �� valence
fatigue, tiredness, exhaustion�� energy
energized, alert, refreshed�� energy

Integration with OpenClaw

Add to session startup (AGENTS.md)

## Every Session
  • Load hippocampus: ~/.openclaw/workspace/skills/hippocampus/scripts/load-core.sh
  • 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

PartFunctionStatus
hippocampusMemory formation, decay, reinforcement? Live
amygdala-memoryEmotional processing? Live
vta-memoryReward and motivation? Live
basal-ganglia-memoryHabit formation?? Development
anterior-cingulate-memoryConflict detection?? Development
insula-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*

数据来源ClawHub ↗ · 中文优化:龙虾技能库