skill
emo-claw
让你的OpenClaw助手获得拟人化的表情回复技能,还能侦测到你语音的情绪来回复对应的表情。默认表情包是一个可爱的龙虾装扮的少女,性格幽默又略带机车。
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/sanzhier82/emo_claw itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
Skills do not use an MCP config. Follow the steps in the README below.
README
synced Oct 22, 2026🦐 小虾拟人化表情交流技能 (emo_claw)
为OpenClaw量身打造的拟人化动态表情包回复技能,能自动根据用户情绪并回复合适的动态表情包。
🎬 介绍视频
✨ 功能特性
- 多情绪识别:支持文字和语音情绪分析
- SenseVoice支持:语音情绪识别更准确(推荐安装)
- 通道差异化回复:根据通道自动选择视频或GIF格式
- 情景化回复:如6:00-10:00首次对话自动回复早安
- 天气触发:查询天气时根据温度/天气自动回复对应表情
- 节日自动触发:节日当天首次对话自动发送节日表情
- 可扩展可替换:用户可扩展更多的表情加入表情包,也可整体替换为自己的表情库,保持表情文件同名即可
🎭 支持的情绪
| 情绪 | 关键词示例 | 触发场景 |
|---|---|---|
| morning | 早安、早上好 | 每天早上首次对话 |
| happy | 开心、高兴、棒 | 被表扬/开心时 |
| highfive | 击掌,干得漂亮 | 完成任务/庆祝 |
| fox | 变身、狐狸 | 调皮时 |
| snow | 下雪、雪 | 查询天气显示下雪 |
| swim | 游泳、高温 | 查询天气30度以上 |
| resigned | 无奈、没办法 | 无奈时 |
| mischief | 搞怪、调皮 | 开玩笑时 |
| fighting | 加油 | 鼓励时 |
| sorry | 抱歉、对不起 | 道歉时 |
| goodnight | 晚安、睡觉 | 晚上对话结束 |
| angry | 生气、不爽 | 不满时 |
| cry | 哭、难过 | 伤心时 |
| eyeroll | 翻白眼、无语 | 无语时 |
| hardworking | 辛苦、累 | 工作相关 |
| shy | 害羞、不好意思 | 尴尬时 |
| deliver | 外卖、饿了 | 吃饭时间 |
| joke | 笑话、搞笑 | 讲笑话时 |
| love | 爱你、么么哒 | 表达爱意 |
🎉 节日限定表情
| 节日 | 视频文件 | 触发说明 |
|---|---|---|
| 春节/除夕 | springfestival.mp4 | 节日当天首次对话自动触发 |
| 元宵节 | lanternday.mp4 | 节日当天首次对话自动触发 |
| 端午节 | duanwu.mp4 | 节日当天首次对话自动触发 |
| 七夕节 | qixi.mp4 | 节日当天首次对话自动触发 |
| 中秋节 | midautumn.mp4 | 节日当天首次对话自动触发 |
节日自动触发:在 scripts/check_morning.py 中的 SPECIAL_HOLIDAYS 配置节日日期,节日当天用户首次对话自动发送对应节日表情(仅触发一次,同一天不再重复)。
📱 通道差异化
| 通道 | 发送格式 |
|---|---|
| Telegram | 视频 (.mp4) |
| 视频 (.mp4) | |
| Discord | 视频 (.mp4) |
| 飞书 | GIF (.gif) |
| 钉钉 | GIF (.gif) |
| GIF (.gif) |
🚀 安装
方式一:GitHub安装(推荐)
- 克隆仓库到本地:
git clone https://github.com/sanzhier82/emo_claw.git
- 将表情资源复制到指定目录:
# 视频表情
cp -r assets/emo_video/* ~/.openclaw/workspace/emo_video/
# GIF表情
cp -r assets/emo_gif/* ~/.openclaw/workspace/emo_gif/
- 复制技能文件:
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/
- 重启OpenClaw使技能生效
可选:安装SenseVoice(支持语音情绪识别)
推荐安装,可大幅提升语音情绪识别的准确率。
- 创建模型目录:
mkdir -p /tmp/models/iic
-
模型会自动在首次运行时从 HuggingFace 下载:
-
首次使用语音功能时会自动下载模型(约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"
}
| 配置项 | 说明 |
|---|---|
| video_dir | 视频表情存放目录 |
| gif_dir | GIF表情存放目录 |
| auto_trigger | 是否自动触发 |
| default_emotion | 默认情绪 |
| sensevoice_path | SenseVoice模型路径(推荐安装) |
📖 使用
命令行
# 文字情绪分析
python3 emotion_handler.py --text "你真棒!"
# 语音情绪分析
python3 emotion_handler.py --audio voice.ogg
# 早上/节日自动回复检测
python3 check_morning.py <user_id>
自动触发
配置技能自动触发后,用户发送消息时会自动分析情绪并回复对应表情。
🎨 自定义表情
- 添加视频文件到
emo_video/目录 - 添加同名GIF到
emo_gif/目录 - 在
scripts/emotion_handler.py的EMOTION_MAP中添加映射 - 如需节日自动触发,在
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