emoclaw

🎭 会成长的 AI 情感记忆引擎

🥥32总安装量 15评分人数 13
100% 的用户推荐

本地运行的 AI 情感建模引擎,基于记忆训练轻量神经网络,实时生成动态情绪状态注入系统提示,赋予 Agent 持续演化的情感指纹。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码安全规范:无 eval/exec/system 等危险函数,extract.py 实现严格路径验证防止目录遍历,torch.load 使用 weights_only=True 防止模型加载漏洞
  • ✅ 数据隐私保护完善:内置 redact_patterns 自动脱敏 API Key、GitHub PAT、SSH 密钥等敏感信息,训练与推理完全本地执行,无数据外泄风险
  • ⚠️ 可选网络调用需确认:label.py 向 Anthropic API 发送数据前需用户显式同意(支持 --dry-run 预览),非强制流程且仅发生在初始化阶段
  • ⚠️ 来源为 T3 级别社区项目:虽代码质量良好并通过 A 级认证,但建议在高敏感度生产环境进行额外安全审计
  • ✅ 权限控制合理:Unix socket 创建权限设置为 0o660(用户+组读写),路径验证确保文件访问限制在项目目录内,错误处理不暴露敏感系统信息

使用说明

Emoclaw 是一款为 AI Agent 设计的情感状态建模技能,通过构建轻量级神经网络(约 2MB)让机器具备基于记忆的情感演化能力。其核心工作流程分为三个阶段:首先是 Bootstrap 阶段,通过提取身份文件和对话历史,使用可选的 Claude API 进行情感标注,训练出专属的 GRU+MLP 情感模型;其次是实时推理阶段,利用冻结的 MiniLM 编码器将消息转为 384 维向量,结合上下文和上一时刻的情感残差(GRU hidden state),输出多维情感向量(0-1 区间);最后是衰减与注入阶段,情感状态会随时间自然衰减(可配置半衰期),并通过 [EMOTIONAL STATE] 代码块注入系统提示,让 AI 拥有"内心感受"。

该技能的显著优势在于其本地优先架构:训练和推理完全在本地 CPU 运行,单次延迟低于 50 毫秒,无需持续联网;隐私保护完善,内置正则脱敏机制自动过滤 API Key、Token、密码等敏感信息;情感连续性强,GRU 隐藏状态跨会话持久化,形成"情感 residue",配合时间衰减算法模拟真实的情绪冷却过程;高度可配置,支持自定义情感维度(愉悦度、唤醒度、安全感等)、关系映射和渠道上下文。

潜在局限性包括:来源可信度为 T3(社区项目),虽然代码质量达到 A 级,但生产环境仍建议额外审计;初始配置门槛较高,需要 Python 3.10+ 环境,执行提取、标注、训练等多步初始化;可选依赖外部 API,自动标注需调用 Anthropic API(需显式用户确认);模型维护成本,随着对话数据积累需要定期重训练以保持情感准确性。

该技能特别适合以下群体:AI Agent 开发者希望为助手添加人格化特征;虚拟角色创作者构建具有情感记忆的游戏 NPC 或数字人;对话系统设计师需要基于长期关系演化的情感反馈;隐私敏感场景要求情感处理完全本地化而不依赖云端 API。

使用时的常规风险需注意:首次使用需从 Hugging Face 下载 sentence-transformers 模型(约几十 MB);emotional-state.json 状态文件需妥善管理权限(虽然默认 0o660),避免情感数据被未授权读取;若启用自动标注功能,需确保 extracted_passages.jsonl 经过审查,尽管有脱敏机制仍建议预览确认;长时间运行后情感基线可能漂移,需要监控并适时重新校准。

emoclaw 内容

文件夹图标assets文件夹
文件夹图标engine文件夹
文件夹图标emotion_model文件夹
文件夹图标scripts文件夹
文件夹图标tests文件夹
文件夹图标references文件夹
文件夹图标scripts文件夹
手动下载zip · 62.7 kB
emoclaw.yamltext/plain
请选择文件