名称： clawface
描述： 为AI智能体提供悬浮头像组件，可显示情绪、动作与视觉特效。给你的OpenClaw一张脸！适用于用户需要视觉反馈、悬浮状态窗口或查看智能体工作时的情绪状态。触发词包括“显示头像”、“uruchom avatara”、“pokaż avatara”、“智能体面部”、“视觉反馈”。

🤖 ClawFace

给你的OpenClaw一张脸！

有一台运行OpenClaw并连接显示器的专用机器？厌倦了整天盯着日志？

给你的智能体注入个性！

• 9种情绪 — 从开心到生气，思考到自豪
• 9种动作 — 编码、搜索、阅读、说话...
• 15种视觉特效 — 矩阵雨、火焰、彩带、雷达扫描...

这相当于 1,215种独特组合，外加来自智能体的自定义消息！

非常适合：
- 💻 笔记本电脑设置，想亲眼看到智能体工作
- 🖥️ 连接显示器的专用OpenClaw机器
- 🎮 让你的AI助手栩栩如生
- 📺 给朋友/同事留下深刻印象

⚠️ 注意： 仅在macOS上测试过。Windows/Linux应可运行，但效果可能因环境而异。

🚀 快速测试（立即尝试！）

# 1. 检查是否已安装Python + tkinter：
python3 -c "import tkinter; print('准备就绪！')"

终端1 — 运行ClawFace：

python3 SKILL_PATH/scripts/avatar.py --mode robot

终端2 — 运行演示：

python3 SKILL_PATH/scripts/avatar.py --demo

观看头像自动循环展示所有情绪、动作和特效！🎉

手动控制：

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

⚠️ 环境要求

Python 3.10+ 并包含 tkinter：

# 检查：
python3 -c "import tkinter; print('OK')"

# 若缺失则安装：
# macOS:   brew install python-tk@3.14
# Ubuntu:  sudo apt install python3-tk
# Windows: 重新安装Python，安装时勾选“tcl/tk and IDLE”

📦 完整安装

1. 安装自动思考钩子（推荐）：

cp -r SKILL_PATH/hooks/clawface-thinking ~/.openclaw/hooks/
openclaw hooks enable clawface-thinking

这会使头像在每次交互开始时自动显示“思考”状态——无延迟！

2. 启动头像：

nohup python3 SKILL_PATH/scripts/avatar.py --mode robot > /dev/null 2>&1 &

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

🎯 核心原则：保持动态！

不要设置一次状态就置之不理。 在工作过程中持续更新头像：

用户提问
  → thinking/reading    （阅读用户消息）
  → thinking/thinking   （分析）
  → happy/speaking      （组织回复）
  → neutral/idle        （已发送，等待中）

你的每个动作都应反映出来。头像是你的实时状态指示器。

🎭 状态参考

情绪

动作

特效

⚡ 最佳实践

🔴 每次响应的最低流程：

thinking  →  处理用户输入
speaking  →  发送回复
idle      →  完成，等待中

这是强制性的。 每一次回复都应展示这个流程。

技巧：

1. 在每个动作前更新 — 在阅读前设置 reading
2. 完成后立即更新 — 显示 success/error，然后转为 idle
3. 匹配强度 — 小任务用微妙状态，大任务用丰富表达
4. 始终返回空闲状态 — 当等待用户时

🔧 技术参考

状态文件

将JSON写入 ~/.clawface/avatar_state.json：

{
  "emotion": "happy",
  "action": "coding",
  "effect": "fire",
  "message": "正在构建超棒的东西！"
}

显示模式

🤖 机器人模式 (--mode robot) — 默认
- LED风格的像素眼睛，带动画
- 机械臂与爪子
- 复古未来赛博朋克风格
- 最适合：科技美学，专用屏幕

😊 面部模式 (--mode face)
- 简化的卡通脸
- 富有表现力的眼睛和嘴巴
- 友好，平易近人的外观
- 最适合：日常使用，小窗口

通过UI中的按钮切换模式，或使用不同的 --mode 参数重启。

窗口控制

• 拖动以移动
• 拖动边缘以调整大小
• F 键全屏
• Q 键退出