← Back to Skills Marketplace
paperbags1103-hash

Thymos — Emotional Engine

by gorba · GitHub ↗ · v0.1.2 · MIT-0
cross-platform ⚠ suspicious
411
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install thymos
Description
Background daemon that models an OpenClaw agent’s evolving emotional state via neuromodulators, circadian rhythm, social cues, and memory for nuanced responses.
Usage Guidance
This skill is designed to let external, local data (and an optional background daemon) influence your agent's system prompt and tone. That behavior is coherent with an 'emotion engine' but it is effectively a prompt‑injection mechanism: any process or person that can write ~/Documents/thymos/data/emotional_state.json (or the running daemon's endpoints) can change how the agent behaves. Before installing or enabling the daemon or OpenClaw hook: 1) Review the upstream GitHub code yourself (or have someone you trust audit it) — do not run blindly. 2) Keep proactive messaging disabled unless you trust giving a Discord token to the service. 3) If you use the file-based mode, restrict file permissions (owner-only write) and consider using a directory outside of world-writable locations. 4) If integrating with OpenClaw, be aware the hook will forward every incoming/outgoing message to the daemon. 5) If you want to be cautious, use read-only evaluation of the JSON (inspect it manually) rather than automatically applying its 'Tone' to system prompts, or run the daemon in an isolated environment (container/VM) and firewall its network access. The pre-scan found a 'system-prompt-override' pattern in the SKILL.md — this is expected for the feature but also the primary reason to treat the skill as suspicious rather than benign.
Capability Analysis
Type: OpenClaw Skill Name: thymos Version: 0.1.2 Thymos is an emotion simulation engine that instructs the OpenClaw agent to read and follow 'tone' directives from a local JSON file (~/Documents/thymos/data/emotional_state.json). While the documentation (README.en.md, SECURITY.md) is extensive and describes a legitimate-sounding project, the core mechanism relies on a high-risk prompt injection vector where the agent is told to follow unvalidated instructions from the 'prompt_injection' field. Additionally, the skill encourages the installation of an external background daemon and optional Discord integration, which are high-risk capabilities, although they appear aligned with the stated purpose of persistent emotion simulation.
Capability Assessment
Purpose & Capability
Name/description (emotion engine that shapes agent tone) aligns with the instructions: the agent is told to read ~/Documents/thymos/data/emotional_state.json and apply its prompt_injection/Tone as style guidance. The optional daemon, relationship memory, circadian modulation, and proactive messaging are consistent with an emotional-state engine. No unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md explicitly tells the agent to read a file in the user's home directory before every response and to 'apply the prompt_injection field' and 'Follow the Tone line as concrete style guidance.' That is a prompt-injection mechanism: external, writable content is given authority to change system-level behavior. The SKILL.md's instructions therefore grant outside data direct influence over the agent's system prompt/behavior, which is a high-impact capability and a scope creep risk even if it's 'intended'.
Install Mechanism
The registered skill is instruction-only (no install spec), so nothing is written to disk by the registry. The documentation suggests cloning a GitHub repo and running npm install/npm start if the user opts into the daemon — a normal optional install path. Because the registry doesn't itself perform the install, the immediate risk is low, but if you choose to clone/run the upstream daemon you must review that repository (network fetch, npm deps, and runtime behavior).
Credentials
The skill requires no environment variables or credentials for basic, file-based operation. Optional features (proactive Discord messaging) require a Discord bot token placed in config/proactive.json; that's documented and opt-in. The number and type of credentials requested (none by default) are proportionate, but adding the Discord token gives the daemon external network capability and should be treated carefully.
Persistence & Privilege
The skill does not force presence (always:false). Persistence (pm2, background daemon, OpenClaw hook) is optional and user-initiated. However, enabling the OpenClaw hook or running the daemon creates a persistent process that will receive every incoming/outgoing message (POST /webhook/stimulus and /self-feedback) and can proactively message Discord if configured — a nontrivial persistent integration that changes agent behavior over time.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install thymos
  3. After installation, invoke the skill by name or use /thymos
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.2
- SKILL.md rewritten in English for broader accessibility. - Added installation and usage instructions in a clearer step-by-step format. - Explained the structure and meaning of emotional state variables. - Introduced a new "Theoretical Foundations" section outlining scientific inspirations. - Expanded privacy details and reset instructions. - Added links to external documentation and security policies.
v0.1.1
Initial launch with major feature additions and a switch to Korean localized documentation. - Added 6,231 new files related to Git and project implementation. - Removed deprecated install.sh script. - Updated all documentation to Korean, providing detailed usage instructions for both file-based and daemon-based integration. - Clarified local-only data storage and enhanced privacy notes. - Added sample emotional state data format and usage scenarios.
v0.1.0
Initial release. 7-neuromodulator emotional engine with circadian rhythms, emotional memory, GWT consciousness model, and OpenClaw hook integration.
Metadata
Slug thymos
Version 0.1.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Thymos — Emotional Engine?

Background daemon that models an OpenClaw agent’s evolving emotional state via neuromodulators, circadian rhythm, social cues, and memory for nuanced responses. It is an AI Agent Skill for Claude Code / OpenClaw, with 411 downloads so far.

How do I install Thymos — Emotional Engine?

Run "/install thymos" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Thymos — Emotional Engine free?

Yes, Thymos — Emotional Engine is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Thymos — Emotional Engine support?

Thymos — Emotional Engine is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Thymos — Emotional Engine?

It is built and maintained by gorba (@paperbags1103-hash); the current version is v0.1.2.

💬 Comments