Emotion State

🧠 AI情绪记忆系统,让对话更有温度

通过OpenClaw钩子实现自然语言情绪追踪与智能注入,支持跨会话情感状态持久化与衰减趋势分析。

收藏
7.8k
安装
2.7k
版本
1.2.0
CLS 安全性认证2026-06-23
点击查看完整报告 >

使用说明

核心用法

Emotion State 是一款面向 OpenClaw 网关的系统级钩子技能,旨在为 AI 代理添加自然语言情绪感知能力。其核心机制分为三层:

1. 情绪评估层:调用外部分类器(默认 OpenAI gpt-4o-mini)将用户输入和代理回复转化为简短自然语言情绪短语(如 "frustrated/seeking clarity")。
2. 状态持久层:按用户维度存储情绪历史至 ~/.openclaw/agents/<agentId>/agent/emotion-state.json,支持跨会话记忆,默认保留 100 条记录。

3. 智能注入层:通过半衰期算法(默认 12 小时)计算衰减趋势,将最新情绪条目以结构化 emotion_state 块动态注入系统提示词,增强代理的情境感知响应能力。

显著优点

  • 零侵入设计:纯钩子架构,无需修改业务代码,通过 openclaw hooks enable 一键启用
  • 隐私优先:不存储原始用户文本,仅保留模型推断的情绪标签与原因摘要
  • 灵活配置:支持自定义分类器端点、置信度阈值(默认 0.35)、时区、历史窗口等 10+ 参数
  • 容错降级:分类器失效时自动回退至 "neutral/low/unsure",保障服务连续性

潜在缺点与局限性

  • 依赖外部 LLM:核心功能绑定 OpenAI API 或自建分类器服务,存在供应商锁定风险
  • 情绪推断黑箱:模型判断过程不可解释,可能产生文化偏见或误读(如讽刺语气)
  • 存储本地化:状态文件仅存于单机目录,多实例部署需自行解决同步
  • 提示注入攻击面:动态注入用户衍生的情绪文本至系统提示,若分类器被绕过可能构成间接注入通道

适合人群

  • 需要长期情感记忆的客户支持机器人开发者
  • 追求对话连贯性的虚拟陪伴/心理健康类应用团队
  • 已部署 OpenClaw 网关、希望轻量扩展系统能力的工程团队

常规风险

| 风险类型 | 说明 |
|---------|------|
| 数据合规 | 情绪推断可能触及敏感心理特征,需评估 GDPR/CCPA 下的"推断数据"定性 |
| 模型滥用 | API Key 配置于本地明文 JSON,存在泄露与配额盗刷风险 |
| 情绪操纵 | 恶意用户可能通过精心构造输入"训练"代理对其情绪形成误判 |
| 版本漂移 | OpenAI 模型更新可能导致情绪标签语义变化,影响趋势准确性 |

安全解读

核心用法

Emotion State 是一个 OpenClaw Hook 技能,用于在对话系统中注入情绪感知能力。安装后,它会将用户的情绪状态以自然语言短语形式注入系统提示,帮助 AI 更好地理解对话氛围。

主要功能:

  • 调用 OpenAI API(gpt-4o-mini 或自定义模型)分析用户消息情绪
  • 按用户持久化存储情绪历史,支持跨会话记忆
  • 通过半衰期算法计算情绪趋势,注入系统提示
  • 支持自定义分类器端点,可替换为本地或私有模型

配置要点:

  • 必须提供 OPENAI_API_KEY
  • 可调整 EMOTION_CONFIDENCE_MIN(置信度阈值)、EMOTION_HALF_LIFE_HOURS(情绪衰减半衰期)等参数
  • 存储路径:~/.openclaw/agents/<agentId>/agent/emotion-state.json

显著优点

1. 情感上下文增强:让 AI 具备"记忆"用户情绪状态的能力,改善长期对话体验
2. 无第三方依赖:仅使用 Node.js 内置模块,减少供应链攻击面

3. 高度可配置:支持自定义模型、端点、衰减算法参数,适应不同场景

4. 代码透明:无混淆,开源可查,静态分析未发现 eval/exec 等危险函数

潜在缺点与局限性

1. 隐私数据外泄:用户消息内容必须发送到 OpenAI 或自定义端点,敏感对话存在合规风险
2. T3 来源可信度:由个人开发者维护,缺乏组织背书,长期维护存在不确定性

3. 功能依赖外部服务:无网络或 API 故障时,情绪分析降级为 neutral/low/unsure,体验下降

4. 本地数据持久化:情绪历史文件未加密,多用户环境下存在访问控制问题

适合人群

  • 产品开发者:构建情感陪伴、心理健康、客服等需要情绪感知的 AI 应用
  • 研究团队:需要对话情绪数据集用于分析(需用户知情同意)
  • 个人实验者:探索 LLM 情感计算能力的开发者

不适合: 处理高度敏感信息(医疗、金融、法律)且无法数据外泄的场景

常规风险

  • 数据合规风险:可能违反 GDPR 数据最小化原则,需用户明确同意
  • API 密钥泄露:OPENAI_API_KEY 需安全存储,避免硬编码
  • 自定义端点劫持EMOTION_CLASSIFIER_URL 可被设置为恶意地址,建议增加白名单验证
  • 情绪数据滥用:存储的情绪标签若被其他应用读取,可能形成用户画像

Emotion State 内容

hooks文件夹
emotion-state文件夹
手动下载zip · 8.3 kB
handler.tstext/plain
请选择文件