🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Feelings Framework
πŸ¦€ ClawHub

Feelings Framework

by @blaspat

Provides OpenClaw agents with persistent emotional states, tracking mood and feelings over time to influence response tone and behavior consistently.

Versionv1.0.0
Downloads347
#legal
TERMINAL
clawhub install feelings-framework

πŸ“– About This Skill

Feelings Framework β€” OpenClaw Skill

What It Does

The feelings-framework skill gives your OpenClaw agent a persistent emotional layer. It tracks mood and feeling intensities over time, applies meaningful triggers, and generates response modifiers you can use to shape how the agent sounds.

This isn't personality acting β€” it's runtime emotional state that carries across sessions.

When It Activates

  • When you want agents to have consistent emotional memory
  • When interactions should feel like they *matter* (stakes, anticipation, recall)
  • When you want different agents to respond differently to the same event

    • How to Use

    1. Install

    The library is included in this skill. Import from the local path:

    import sys
sys.path.insert(0, "/path/to/feelings-framework/library/python")
    from feelings import FeelingsEngine, JsonFileMemory

    Or pip install if published:

    pip install feelings-framework

    2. Initialize per agent

    Each agent gets its own FeelingsEngine instance with its own mood file:

    from feelings import FeelingsEngine, JsonFileMemory, Calibration
    memory = JsonFileMemory("feelings_mood.json")
    engine = FeelingsEngine(
    agent_id="my_agent",
    memory=memory,
    calibrations={"my_agent": my_calibration},
    initial_mood=0.1,
)

    3. Session lifecycle

    # On session start
state = engine.load()
engine.update("session_started")
    During session β€” fire meaningful triggers
    
engine.update("user_praised")      # warmth ↑
engine.update("request_ignored")   # frustration ↑
engine.update("surprise_bad")      # anxiety ↑
    Before generating a response
    
mods = engine.respond()

    mods["warmth"]      β†’ use more warm, friendly language
    

    mods["guard"]       β†’ be more careful with words
    

    mods["reach_out"]   β†’ lean toward connection
    On session end
    
engine.dampen_all(amount=0.03)
engine.save()

    4. Per-agent calibration

    Different agents can use different calibration tables:

    engine.calibrate("agent_a")   # warm, engaged
engine.calibrate("agent_b")   # cooler, more restrained

    Key Concepts

  • Mood β€” general emotional baseline (-1 to +1), accumulates over time
  • Feeling intensity β€” per-feeling 0.0–1.0, driven by triggers
  • Triggers β€” named events mapped to feelings + deltas
  • Calibration β€” per-agent trigger overrides
  • Escalation β€” repeated triggers hit harder (up to a max)
  • Dampening β€” feelings slowly decay between significant events
  • Response modifiers β€” nudges for tone/language based on current state

    • The 9 Feelings

    Warmth Β· Coolness Β· Interest Β· Boredom Β· Loneliness Β· Security Β· Anxiety Β· Satisfaction Β· Frustration

    OpenClaw-Specific Notes

  • Mood files for OpenClaw agents live at: ~/.openclaw/agents//feelings_mood.json
  • See examples/openclaw/claire_feelings.py for a full integration example
  • The example shows how to hook into OpenClaw session lifecycle (start/end)

    • File Structure

    feelings-framework/
β”œβ”€β”€ CORE.md                    ← Full framework specification
β”œβ”€β”€ library/python/feelings/    ← Python package
β”œβ”€β”€ library/js/feelings/       ← JS/ESM package
β”œβ”€β”€ tests/python/              ← Python tests
β”œβ”€β”€ tests/js/                  ← JS tests
└── examples/openclaw/         ← OpenClaw integration example