emotion-comm

🦐 小虾拟人化表情交流技能 (emo_claw)

为OpenClaw量身打造的拟人化动态表情包回复技能，能自动根据用户情绪并回复合适的动态表情包。

🎬 介绍视频

https://youtu.be/-tLqPCCq8s0

✨ 功能特性

• 多情绪识别：支持文字和语音情绪分析
• SenseVoice支持：语音情绪识别更准确（推荐安装）
• 通道差异化回复：根据通道自动选择视频或GIF格式
• 情景化回复：如6:00-10:00首次对话自动回复早安
• 天气触发：查询天气时根据温度/天气自动回复对应表情
• 节日自动触发：节日当天首次对话自动发送节日表情
• 可扩展可替换：用户可扩展更多的表情加入表情包，也可整体替换为自己的表情库，保持表情文件同名即可

🎭 支持的情绪

🎉 节日限定表情

节日自动触发：在 scripts/check_morning.py 中的 SPECIAL_HOLIDAYS 配置节日日期，节日当天用户首次对话自动发送对应节日表情（仅触发一次，同一天不再重复）。

📱 通道差异化

🚀 安装

方式一：GitHub安装（推荐）

1. 克隆仓库到本地：

git clone https://github.com/sanzhier82/emo_claw.git

1. 将表情资源复制到指定目录：

# 视频表情
cp -r assets/emo_video/* ~/.openclaw/workspace/emo_video/

# GIF表情  
cp -r assets/emo_gif/* ~/.openclaw/workspace/emo_gif/

1. 复制技能文件：

cp SKILL.md ~/.openclaw/workspace/skills/emo_claw/
cp -r scripts/* ~/.openclaw/workspace/skills/emo_claw/scripts/
cp -r config/* ~/.openclaw/workspace/skills/emo_claw/config/

1. 重启OpenClaw使技能生效

可选：安装SenseVoice（支持语音情绪识别）

推荐安装，可大幅提升语音情绪识别的准确率。

1. 创建模型目录：

mkdir -p /tmp/models/iic

1. 模型会自动在首次运行时从 HuggingFace 下载：

   • 模型地址：https://huggingface.co/iic/SenseVoiceSmall
   • 或从 Modelscope：https://modelscope.cn/models/iic/SenseVoiceSmall

2. 首次使用语音功能时会自动下载模型（约100MB）

方式二：手动下载安装

访问 GitHub releases 页面下载最新版本： https://github.com/sanzhier82/emo_claw/releases

⚙️ 配置

在 config/settings.json 中配置：

{
  "video_dir": "~/.openclaw/workspace/emo_video",
  "gif_dir": "~/.openclaw/workspace/emo_gif",
  "auto_trigger": true,
  "default_emotion": "NEUTRAL",
  "sensevoice_path": "/tmp/models/iic/SenseVoiceSmall"
}

📖 使用

命令行

# 文字情绪分析
python3 emotion_handler.py --text "你真棒！"

# 语音情绪分析
python3 emotion_handler.py --audio voice.ogg

# 早上/节日自动回复检测
python3 check_morning.py <user_id>

自动触发

配置技能自动触发后，用户发送消息时会自动分析情绪并回复对应表情。

🎨 自定义表情

1. 添加视频文件到 emo_video/ 目录
2. 添加同名GIF到 emo_gif/ 目录
3. 在 scripts/emotion_handler.py 的 EMOTION_MAP 中添加映射
4. 如需节日自动触发，在 scripts/check_morning.py 的 SPECIAL_HOLIDAYS 中添加日期

📦 项目结构

emo_claw/
├── SKILL.md              # 技能定义
├── _meta.json            # 元数据
├── CHANGELOG.md          # 更新日志
├── config/
│   └── settings.json     # 配置文件
├── scripts/
│   ├── emotion_handler.py    # 核心处理脚本
│   ├── check_sensevoice.py   # SenseVoice检测
│   ├── check_morning.py      # 早上/节日检测
│   └── check_holiday.py     # 节日检测模块
└── assets/
    ├── emo_video/       # 视频表情 (22个)
    └── emo_gif/         # GIF表情 (22个)

🤝 贡献

欢迎提交Issue和Pull Request！

📄 许可证

MIT License

---

@sanzhier82 - 2026