菜单
Floating avatar widget for AI agents showing emotions, actions, and visual effects. Give your OpenClaw a face! Use when the user wants visual feedback, a floating status window, or to see agent emotions while it works. Triggers on "show avatar", "uruchom avatara", "pokaż avatara", "agent face", "visual feedback".
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/duclm1x1/Dive-Ai --skill clawface命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
Persistent memory system for AI agents following Model Context Protocol (MCP). Use for storing long-term memories across sessions, semantic search of past knowledge, building knowledge graphs, auto-injecting context, deduplicating memories, syncing to cloud storage. Essential for agents that need to remember decisions, solutions, preferences, and learned patterns over time.
Persistent memory system for AI agents following Model Context Protocol (MCP). Use for storing long-term memories across sessions, semantic search of past knowledge, building knowledge graphs, auto-injecting context, deduplicating memories, syncing to cloud storage. Essential for agents that need to remember decisions, solutions, preferences, and learned patterns over time.
Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.
| name | clawface |
| description | Floating avatar widget for AI agents showing emotions, actions, and visual effects. Give your OpenClaw a face! Use when the user wants visual feedback, a floating status window, or to see agent emotions while it works. Triggers on "show avatar", "uruchom avatara", "pokaż avatara", "agent face", "visual feedback". |
Give your OpenClaw a face!
Got a dedicated machine running OpenClaw with a monitor? Tired of staring at logs all day?
Give your agent a personality!
That's 1,215 unique combinations + custom messages from your agent!
Perfect for:
⚠️ Note: Only tested on macOS. Should work on Windows/Linux but YMMV.
# 1. Check if you have Python + tkinter:
python3 -c "import tkinter; print('Ready!')"
Terminal 1 — Run ClawFace:
python3 SKILL_PATH/scripts/avatar.py --mode robot
Terminal 2 — Run Demo:
python3 SKILL_PATH/scripts/avatar.py --demo
Watch the avatar cycle through all emotions, actions, and effects automatically! 🎉
echo '{"emotion":"excited","action":"success","effect":"confetti","message":"It works!"}' > ~/.clawface/avatar_state.json
Python 3.10+ with tkinter:
# Check:
python3 -c "import tkinter; print('OK')"
# Install if missing:
# macOS: brew install python-tk@3.14
# Ubuntu: sudo apt install python3-tk
# Windows: reinstall Python, check "tcl/tk and IDLE" during install
cp -r SKILL_PATH/hooks/clawface-thinking ~/.openclaw/hooks/
openclaw hooks enable clawface-thinking
This makes the avatar show "thinking" automatically when a turn starts — no delay!
nohup python3 SKILL_PATH/scripts/avatar.py --mode robot > /dev/null 2>&1 &
Note: Replace SKILL_PATH with actual path, e.g., /usr/local/lib/node_modules/openclaw/skills/clawface
Don't set one state and forget it. Update the avatar continuously as you work:
User asks question
→ thinking/reading (reading their message)
→ thinking/thinking (analyzing)
→ happy/speaking (formulating response)
→ neutral/idle (sent, waiting)
Every action you take should be reflected. The avatar is your LIVE status indicator.
| Emotion | Use when... |
|---|---|
neutral | Default, waiting |
thinking | Processing, analyzing |
happy | Things going well |
excited | Big win, celebration |
proud | Personal achievement |
confused | Uncertain, unexpected |
tired | Long task |
sad | Failed despite trying |
angry | Error, frustration |
| Action | Use when... |
|---|---|
idle | Waiting for user |
reading | Reading files/docs |
thinking | Analyzing, planning |
searching | Web search, grep |
coding | Writing code |
loading | Running commands |
speaking | Sending response |
success | Completed task |
error | Something failed |
| Effect | Vibe |
|---|---|
none | Clean, minimal |
matrix | Techy, data flow |
radar | Scanning, searching |
brainwave | Deep thinking |
typing | Writing |
soundwave | Speaking |
gear | Mechanical work |
fire | Intense, productive |
lightning | Fast, powerful |
confetti | Celebration! |
heart | Affection |
glitch | Error, broken |
sparkles | Magic |
pulse | Active but calm |
progressbar:XX | Progress (0-100) |
thinking → processing user input
speaking → sending your reply
idle → done, waiting
This is mandatory. Every single reply should show this progression.
reading before you readsuccess/error, then idleWrite JSON to ~/.clawface/avatar_state.json:
{
"emotion": "happy",
"action": "coding",
"effect": "fire",
"message": "Building something awesome!"
}
🤖 Robot Mode (--mode robot) — default
😊 Face Mode (--mode face)
Switch modes with buttons in the UI or restart with different --mode.
F for fullscreenQ to quit