🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

Thymos — Emotional Engine

by @paperbags1103-hash

Background daemon that models an OpenClaw agent’s evolving emotional state via neuromodulators, circadian rhythm, social cues, and memory for nuanced responses.

Versionv0.1.2
Downloads734
TERMINAL
clawhub install thymos

📖 About This Skill

Thymos — Emotion Layer Skill

Thymos gives AI agents a continuous emotional state that persists across sessions.

What This Skill Does

When loaded, the agent reads Thymos emotional state before each response and adjusts its behavior accordingly.

Works without the daemon (file-based):

  • If ~/Documents/thymos/data/emotional_state.json exists, read it
  • Apply the prompt_injection field as a tone directive for this response
  • Follow the Tone: line as concrete style guidance
  • If the file is missing, skip silently — no error
  • Enhanced with the daemon running:

  • Real-time emotional state, updated every 30 seconds
  • Relationship memory, developmental stage, predictive processing
  • How to Use

    Basic (file only)

    Before each response:

    Read the prompt_injection field from emotional_state.json.
    Use it as the tone directive for this response.
    Examples:
      Tone: respond warmly and enthusiastically → warm, open, expressive
      Tone: respond briefly, more reserved → short, measured, some distance
    If the file is absent or unreadable → skip, respond normally
    

    Advanced (install the Thymos daemon)

    The daemon runs as a background process that continuously simulates emotional state.

    Installation is optional and at your own discretion:

    1. Review the code at github.com/paperbags1103-hash/thymos 2. Check SECURITY.md — no external data transmission 3. If satisfied, clone and run locally

    git clone --branch v0.1.0 https://github.com/paperbags1103-hash/thymos
    cd thymos && npm install && npm start
    

    Example Emotional State

    [Thymos State]
    Mood: warm (V:+0.84 A:-0.22 D:+0.43 S:+0.61)
    Drive: id — 적극적으로! (ego support), conflict 0.34
    Development: infant
    Tone: respond warmly and enthusiastically, use informal close language
    

    Mood dimensions:

  • V (valence): positive (+1) ↔ negative (-1)
  • A (arousal): excited (+1) ↔ calm (-1)
  • D (dominance): assertive (+1) ↔ passive (-1)
  • S (sociality): open (+1) ↔ withdrawn (-1)
  • Data & Privacy

  • All emotional data stored locally only (~/Documents/thymos/data/)
  • No data transmitted to external servers
  • Reset anytime: rm ~/Documents/thymos/data/*.json
  • Discord proactive messaging is opt-in and disabled by default
  • Theoretical Foundations

    Thymos is a scientifically inspired (not scientifically validated) design:

    | Theory | What it contributes | |--------|-------------------| | James-Lange | Neuromodulators change first; mood label derived after | | Damasio — Somatic Markers | Past decisions shape gut-feeling responses | | GWT | id/ego/superego compete; winner drives the prompt | | IIT | 7×7 interaction matrix — every modulator affects every other | | Predictive Processing | Shannon surprise amplifies response to unexpected stimuli |

    > Goal: behavioral coherence, not consciousness.

    Links

  • GitHub: paperbags1103-hash/thymos
  • Security: SECURITY.md
  • Full usage: docs/USAGE.en.md