AI浮动头像组件

技能简介

ClawFace 是一个为 AI 代理设计的浮动头像小部件，可在桌面实时展示当前情绪、动作和视觉特效。

业务背景

为AI交互增添可视化反馈层，让用户通过直观的情绪表情和动态特效实时感知AI的工作状态，降低人机协作的认知摩擦。适用于客服机器人、编程助手等需要持续陪伴的场景，提升用户对AI响应的预判能力和信任感。

落地案例：某开发团队将ClawFace集成至内部代码助手，当AI进入深度检索时头像显示"搜索"动作叠加雷达特效，生成代码时切换"编码"姿态伴随矩阵雨效果。遇到报错则呈现"困惑"情绪加闪电提示，开发者无需紧盯日志即可判断AI当前任务阶段，显著减少反复确认的心理负担。

能做什么

• 显示 9 种情绪状态：中性、思考、开心、兴奋、自豪、困惑、疲惫、悲伤、愤怒
• 呈现 9 种动作姿态：空闲、阅读、思考、搜索、编码、加载、说话、成功、错误
• 叠加 15 种视觉特效：矩阵雨、雷达扫描、脑波、火焰、彩纸、闪电等
• 支持自定义文字消息叠加显示
• 通过 JSON 文件实时更新状态，无需重启

使用说明

1. 环境检查

python3 -c "import tkinter; print('Ready!')"

若缺失 tkinter，按系统安装：

• macOS: brew install python-tk@3.14
• Ubuntu: sudo apt install python3-tk
• Windows: 重装 Python 时勾选 “tcl/tk and IDLE”

2. 快速体验

# 终端1：启动头像
python3 SKILL_PATH/scripts/avatar.py --mode robot

# 终端2：运行演示
python3 SKILL_PATH/scripts/avatar.py --demo

3. 完整安装（推荐）

# 复制自动思考钩子
cp -r SKILL_PATH/hooks/clawface-thinking ~/.openclaw/hooks/
openclaw hooks enable clawface-thinking

# 后台启动头像
nohup python3 SKILL_PATH/scripts/avatar.py --mode robot > /dev/null 2>&1 &

注：将 SKILL_PATH 替换为实际路径，如 /usr/local/lib/node_modules/openclaw/skills/clawface

4. 手动控制状态

echo '{"emotion":"excited","action":"success","effect":"confetti","message":"完成！"}' > ~/.clawface/avatar_state.json

输入与输出

见下方输入与输出表格。

风险提示

• 目前仅在 macOS 上测试，Windows/Linux 兼容性未验证
• 需要图形界面环境，纯 SSH/无显示器服务器无法运行
• 频繁写入状态文件可能产生磁盘 I/O，建议合理控制更新频率
• 后台进程需手动管理，重启系统后需重新启动

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/mkoslacz/claw-face/SKILL.md
来源类型：GitHub 开源仓库