← Back to Skills Marketplace

Emotion State

Name: Emotion State
Author: tashfeenahmed

by tashfeenahmed · GitHub ↗ · v1.2.0

cross-platform ⚠ suspicious

2718

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install emotion-state

Description

NL emotion tracking + prompt injection via OpenClaw hook

README (SKILL.md)

Emotion State (NL) Skill

This skill describes how to install and configure the Emotion State hook, which adds a compact emotion_state block to the system prompt.

What it does

Evaluates user and agent emotions as short natural-language phrases.
Stores per-user emotion state across sessions in the agent state directory.
Injects the latest entries plus a decayed trend line into the system prompt.

Install & enable (workspace hook)

After installing the skill, copy the bundled hook into your workspace:

cp -R ./skills/emotion-state/hooks/emotion-state ./hooks/

Enable the hook in OpenClaw:

openclaw hooks enable emotion-state

Restart the OpenClaw gateway.

Configuration

Set environment variables for the hook via OpenClaw config, e.g. in ~/.openclaw/openclaw.json:

{
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "emotion-state": {
          "enabled": true,
          "env": {
            "EMOTION_CLASSIFIER_URL": "",
            "OPENAI_API_KEY": "YOUR_KEY",
            "OPENAI_BASE_URL": "https://api.openai.com/v1",
            "EMOTION_MODEL": "gpt-4o-mini",
            "EMOTION_CONFIDENCE_MIN": "0.35",
            "EMOTION_HISTORY_SIZE": "100",
            "EMOTION_HALF_LIFE_HOURS": "12",
            "EMOTION_TREND_WINDOW_HOURS": "24",
            "EMOTION_MAX_USER_ENTRIES": "3",
            "EMOTION_MAX_AGENT_ENTRIES": "2",
            "EMOTION_MAX_OTHER_AGENTS": "3",
            "EMOTION_TIMEZONE": "America/Los_Angeles"
          }
        }
      }
    }
  }
}

Notes

The hook stores state at ~/.openclaw/agents/\x3CagentId>/agent/emotion-state.json.
It does not store raw user text; only model-inferred reasons.
If the classifier fails, entries fall back to neutral/low/unsure.

Usage Guidance

This skill will read session messages, keep a per-agent emotion_state file under ~/.openclaw/agents/<agentId>/agent/emotion-state.json, and may send raw message text to an external classifier or OpenAI if configured. The registry omitted required env vars, and the SKILL.md's claim that it 'does not store raw user text' does not prevent it from transmitting raw text to external services. Before installing: (1) review the handler.ts code yourself or with a trusted developer; (2) do not provide an OPENAI_API_KEY (or any classifier URL) unless you trust the operator of that endpoint; (3) if you must test, run in an isolated agent/workspace with non-sensitive data; (4) inspect the system-prompt content the hook injects to ensure it doesn't contain instructions you don't want the model to follow. If you cannot audit the code or you need to protect sensitive user messages, avoid enabling this hook.

Capability Analysis

Type: OpenClaw Skill Name: Developer: Version: Description: OpenClaw Agent Skill Suspicious High-Entropy/Eval files: 1 The skill is classified as suspicious due to its network capabilities and broader file system access. It makes network calls to user-configurable external endpoints (`EMOTION_CLASSIFIER_URL`) or OpenAI, sending user and agent message content for emotion classification, which is a risky capability if a malicious URL is configured by the user. Additionally, the hook reads state files of other agents from the OpenClaw state directory (`~/.openclaw/agents/<otherAgentId>/agent/emotion-state.json`), which represents a broader scope of file system access than strictly its own agent's state. While the `SKILL.md` mentions 'prompt injection', the code demonstrates this is for functional context injection of classified emotions, not malicious manipulation.

Capability Assessment

⚠ Purpose & Capability

The skill's name/description (emotion tracking + injecting an emotion_state block into the system prompt) aligns with the included hook code. However the registry declares no required environment variables while the hook clearly expects and uses many (OPENAI_API_KEY, EMOTION_CLASSIFIER_URL, etc.). That discrepancy is incoherent and surprising to an installer.

⚠ Instruction Scope

The SKILL.md and HOOK.md instruct the agent to copy/enable a hook that reads session messages and injects an emotion_state block into the system prompt. The hook will transmit user/agent message text to an external classifier endpoint or OpenAI for classification (network calls). The SKILL.md claims it 'does not store raw user text' but the code sends raw text externally — this is a scope mismatch and a potential data-exfiltration vector. Injecting content into the system prompt is powerful and can change agent behavior.

✓ Install Mechanism

No remote install or downloads are used; this is an instruction-only skill with a bundled hook file you copy into your workspace. That limits installer-level risk (nothing fetched from arbitrary URLs).

⚠ Credentials

Registry metadata lists no required env vars, but the hook expects multiple configuration variables (OPENAI_API_KEY, OPENAI_BASE_URL, EMOTION_CLASSIFIER_URL, EMOTION_* settings). Requiring an OpenAI API key (or any classifier endpoint) is a powerful permission because it causes user message text to be sent off-host. The number and sensitivity of env vars is disproportionate to what's declared.

ℹ Persistence & Privilege

The hook writes per-agent state to ~/.openclaw/agents/<agentId>/agent/emotion-state.json and injects a block into the system prompt during bootstrap. It does not request permanent 'always' inclusion, but system-prompt modification is an elevated capability — expected for hooks but worth noting because it can influence model behavior.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install emotion-state
After installation, invoke the skill by name or use /emotion-state
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.2.0

Fix JSONL session file parsing, add fetch timeouts, fix OpenAI classifier role handling, use JSON response mode, add LRU user eviction, add state file locking, add error logging

v1.1.0

Initial public release

v1.0.1

Initial public release with bundled hook files

v1.0.0

- Initial release of the emotion-state skill. - Tracks user and agent emotions as natural language phrases. - Stores per-user emotion state across sessions in the agent state directory. - Injects emotion trends into the system prompt for contextual awareness. - Provides configuration options for emotion model, history, and other parameters.

v0.1.0

Initial release

Metadata

Slug emotion-state

Version 1.2.0

License —

All-time Installs 3

Active Installs 3

Total Versions 5

Frequently Asked Questions

What is Emotion State?

NL emotion tracking + prompt injection via OpenClaw hook. It is an AI Agent Skill for Claude Code / OpenClaw, with 2718 downloads so far.

How do I install Emotion State?

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

Is Emotion State free?

Yes, Emotion State is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Emotion State support?

Emotion State is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Emotion State?

It is built and maintained by tashfeenahmed (@tashfeenahmed); the current version is v1.2.0.

More Skills