name: emotion-state
description: 通过 OpenClaw 钩子实现自然语言情绪追踪与提示词注入

Emotion State (NL) 技能

本技能介绍如何安装和配置 Emotion State 钩子，该钩子会在系统提示词中添加一个简洁的 emotion_state 区块。

功能概述

• 将用户和智能体的情绪评估为简短的自然语言短语。
• 在智能体状态目录中，跨会话存储每个用户的情绪状态。
• 将最新的情绪条目以及一条衰减的趋势线注入到系统提示词中。

安装与启用（工作空间钩子）

1) 安装技能后，将捆绑的钩子复制到您的工作空间：

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

2) 在 OpenClaw 中启用此钩子：

openclaw hooks enable emotion-state

3) 重启 OpenClaw 网关。

配置

通过 OpenClaw 配置文件设置钩子的环境变量，例如在 ~/.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"
          }
        }
      }
    }
  }
}

注意事项

• 钩子将状态存储在 ~/.openclaw/agents/<agentId>/agent/emotion-state.json。
• 它不存储原始用户文本，仅存储模型推断的原因。
• 如果分类器失败，条目将回退为 neutral/low/unsure。