A floating, animated desktop avatar that visualizes your AI agent's emotions, tasks, and real-time status.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install claw-face
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install claw-face using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is ClawFace?
ClawFace is a cross-platform visual feedback widget designed to give your AI assistants a tangible presence. By integrating with Openclaw Skills, it translates abstract agent operations into relatable animations, allowing developers to see exactly what their agent is feeling or doing at any given moment. Whether the agent is deep in thought, actively coding, or celebrating a successful task completion, ClawFace ensures you are never left guessing about the current state of your automation.
This tool is especially valuable for power users who maintain dedicated AI workstations. It offers a sophisticated layering system consisting of 9 distinct emotions, 9 functional actions, and 15 immersive visual effects. This creates a high-fidelity feedback loop that improves the transparency and engagement of local AI agent interactions.
ClawFace Use Cases
- Monitoring agent status on secondary monitors during complex workflows.
- Debugging agent logic by observing real-time state transitions through Openclaw Skills.
- Reducing cognitive load by using visual cues instead of parsing dense terminal logs.
- Adding a professional and interactive layer to AI-centric demos and presentations.
How ClawFace Works
- The avatar script initializes a lightweight, floating GUI window on the desktop.
- The Openclaw Skills execution engine triggers updates to a local state JSON file as tasks progress.
- The GUI script reacts to changes in this JSON file to update the character's appearance instantly.
- Visual effects and animations are rendered to reflect the agent's current cognitive activity and task progress.
ClawFace Setup
Ensure Python and tkinter are installed on your system. To integrate with your existing Openclaw Skills environment, use the following commands:
# Verify tkinter installation
python3 -c "import tkinter; print('OK')"
# Enable the automatic thinking hook
cp -r SKILL_PATH/hooks/clawface-thinking ~/.openclaw/hooks/
openclaw hooks enable clawface-thinking
# Start the avatar in robot mode
python3 SKILL_PATH/scripts/avatar.py --mode robot &
ClawFace Data Schema & Taxonomy
The core state is managed via a JSON object which determines the visual output. This allows any external process within the Openclaw Skills ecosystem to control the avatar.
| Key | Allowed Values | Purpose |
|---|---|---|
emotion |
happy, thinking, proud, confused, etc. | Sets the facial expression |
action |
coding, searching, loading, speaking, etc. | Sets the activity animation |
effect |
matrix, radar, brainwave, fire, etc. | Sets the background visual vibe |
message |
Any string | Displays custom text feedback |
ClawFace Advanced Features
- Integrated thinking hook that eliminates latency between user input and agent visual response.
- Robot and Face display modes to match different user preferences and UI aesthetics.
- Support for dynamic progress bars using the progressbar:XX format for tracking long-running tasks.
- Keyboard shortcuts for quick UI management including fullscreen (F) and quit (Q).
- Customizable state persistence through a centralized JSON configuration for multi-agent support.
SKILL.md
Loading
Related Openclaw Skills
Token Counter
A dedicated monitoring tool to track and analyze token consumption across all Openclaw Skills sessions and sub-agents.
Skill Firewall
A defense-in-depth security layer that sanitizes external AI skills by regenerating them from scratch to eliminate hidden prompt injection and malicious payloads.
Token Optimizer
A specialized CLI tool for Openclaw Skills designed to analyze, compress, and optimize token consumption in AI agent sessions.
Awwwards-Level Web Design
A specialized skill for building award-winning, immersive web experiences with advanced animations, creative interactions, and high-end visual storytelling.
ClawSmith
ClawSmith is a comprehensive automation engine designed to help developers build, secure, and optimize high-quality Openclaw Skills with a single command.
Content Repurposer
A privacy-first AI agent skill that transforms a single piece of content into over seven platform-optimized formats entirely on your local machine.
Featured*
