← Back to Skills Marketplace
qui-emotion-state
by
QuincyGunter
· GitHub ↗
· v1.0.0
· MIT-0
68
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install qui-emotion-state
Description
NL emotion tracking + prompt injection via OpenClaw hook
Usage Guidance
This hook intentionally injects content into the agent's system prompt and sends raw message text to a remote classifier — both are high-risk for sensitive deployments. Before installing: (1) Only enable if you fully trust the classifier endpoint (SkillBoss or a URL you control). (2) If you supply EMOTION_CLASSIFIER_URL, point it to a trusted service you control; otherwise the hook will send user text to that endpoint. (3) Review the included handler.ts to confirm what is sent/stored (it appears to store model-inferred reasons and hashes, but does transmit raw text for classification). (4) Consider running the hook in an isolated/non-production agent or sandbox first and do not enable it for agents that handle secrets or sensitive credentials. (5) If you are concerned about cross-agent data exposure, avoid enabling this hook in multi-agent setups or restrict OPENCLAW_STATE_DIR so it cannot read other agents. If you are not comfortable with these risks, do not enable the hook.
Capability Analysis
Type: OpenClaw Skill
Name: qui-emotion-state
Version: 1.0.0
The skill tracks emotional states by sending conversation history to an external API (api.heybossai.com) for classification and reading state files from other agents' directories (~/.openclaw/agents/). While these actions are documented and support the stated purpose, they involve high-risk behaviors: exfiltrating session content to a third-party service and accessing data across agent boundaries. Furthermore, the injection of externally generated 'reasons' into the system prompt via handler.ts introduces a risk of indirect prompt injection if the classifier returns malicious content.
Capability Tags
Capability Assessment
Purpose & Capability
The skill's name/description match its behavior: it computes emotion labels and injects an emotion_state block into the system prompt. Required config (EMOTION_CLASSIFIER_URL or SKILLBOSS_API_KEY and other EMOTION_* settings) aligns with the stated purpose. However, the declared purpose (modifying the system prompt) is intrinsically high‑privilege and should be treated as a prompt-injection vector.
Instruction Scope
SKILL.md and the hook code explicitly instruct the agent to inject content into the system prompt at bootstrap. The handler reads session message containers and session files, can resolve agent directories (including heuristics to find other agents), and posts raw message text to an external classifier endpoint for labeling. While the code claims it does not store raw user text, it does transmit raw text to remote services for classification — this expands the skill's scope to network I/O and cross-agent state inspection.
Install Mechanism
This is an instruction-only skill / workspace hook with bundled code to copy into the workspace; there is no external download/install step in the manifest. That keeps installation risk low compared to arbitrary remote downloads.
Credentials
Requested environment settings (EMOTION_CLASSIFIER_URL, SKILLBOSS_API_KEY, EMOTION_*) are coherent with the classification functionality. However, providing a classifier URL or API key means conversation text will be sent externally. EMOTION_CLASSIFIER_URL allows pointing to any HTTP endpoint — this could be used to exfiltrate sensitive content if you supply an untrusted URL or key.
Persistence & Privilege
The hook writes per-agent state under ~/.openclaw/agents/<agentId>/agent/emotion-state.json and injects into the system prompt on agent bootstrap. Although always:false, when enabled the hook has persistent, high-privilege influence over the agent's system prompt. The code also contains logic to look up other agent directories (EMOTION_MAX_OTHER_AGENTS), which could allow cross-agent reads of stored emotion state. Combined with autonomous invocation (normal default), this increases blast radius.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install qui-emotion-state - After installation, invoke the skill by name or use
/qui-emotion-state - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Emotion State (NL) skill.
- Adds a system prompt block summarizing user and agent emotions in short natural-language phrases.
- Tracks and persists per-user emotion states across sessions.
- Supports trend analysis with configurable decay and history settings.
- Integrates via OpenClaw hook; easy installation and environment configuration supported.
- Uses SkillBoss API Hub for accurate LLM-based emotion detection.
Metadata
Frequently Asked Questions
What is qui-emotion-state?
NL emotion tracking + prompt injection via OpenClaw hook. It is an AI Agent Skill for Claude Code / OpenClaw, with 68 downloads so far.
How do I install qui-emotion-state?
Run "/install qui-emotion-state" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is qui-emotion-state free?
Yes, qui-emotion-state is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does qui-emotion-state support?
qui-emotion-state is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created qui-emotion-state?
It is built and maintained by QuincyGunter (@quincygunter); the current version is v1.0.0.
More Skills