Official Verified utilities Safety 4/5

pixel-lobster

Pixel art desktop lobster that lip-syncs to OpenClaw TTS speech. Use when: (1) user wants a visual avatar for their AI agent, (2) user wants a desktop overlay that animates when their agent speaks, (3) user asks to set up or configure the pixel lobster. Guides the user to install, configure, and launch the bundled Electron app.

Why use this skill?

Add a reactive pixel-art lobster avatar to your desktop that lip-syncs with your OpenClaw agent's speech. Lightweight and easy to configure.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/joeproai/pixel-lobster

Download Source Code (.zip)

What This Skill Does

The pixel-lobster skill brings a charming, animated pixel-art crustacean to your desktop that acts as a visual companion for your OpenClaw AI agent. Unlike standard static avatars, this lobster is context-aware; it leverages the envelope data from your local TTS server to synchronize its mouth movements with the speech generated by your agent. By polling the TTS envelope endpoint, the lobster ensures that its animations feel natural and reactive to the conversation, rather than just playing a looping animation. The app operates as a transparent overlay, allowing it to float above your workspace without interfering with your workflow. It includes built-in features like click-through modes, display cycle support, and high-performance animation physics to ensure a smooth, lightweight experience that doesn't tax your CPU.

Installation

Use the clawhub install command: clawhub install openclaw/skills/skills/joeproai/pixel-lobster
Navigate to the installation directory: cd <skill_dir>/app
Run npm install to set up the Electron dependencies.
Open config.json in the same directory to verify your ttsUrl matches your local TTS server address.
Launch the application using either npx electron . or the provided bash <skill_dir>/scripts/launch.sh script.

Use Cases

Creating an immersive AI persona for streaming, demonstration, or personal entertainment.
Visualizing active agent state to confirm the AI is processing or speaking.
Improving accessibility by providing a visual indicator of speech output.
Customizing your development environment with unique, lightweight desktop UI widgets.

Example Prompts

"Hey OpenClaw, can you help me set up the pixel-lobster avatar so I can see you when you speak?"
"I want the lobster to be click-through so I can work behind it. How do I configure that?"
"My lobster's mouth movements seem slightly off-sync with the audio, can you show me how to adjust the offset?"

Tips & Limitations

For optimal performance, ensure your XTTS server is running before launching the lobster app. The application is designed for Windows and Linux; macOS is not currently supported. If you experience latency in lip-syncing, use the ttsPlayStartOffsetMs parameter to fine-tune the timing against your specific audio output device. Remember that the lobster relies on direct access to the TTS envelope endpoint; if you are using an OpenClaw proxy, ensure the app points to the TTS server's native port (usually 8787). Keep the DevTools toggle (F12) in mind if you need to debug connectivity issues between the app and your TTS engine.

Read Full Documentation on GitHub

Metadata

Author@joeproai

Stars1947

Updated2026-03-04

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-joeproai-pixel-lobster": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Related Skills

narrator-ai-cli

Create AI-narrated film/drama commentary videos via CLI. Two workflow paths (Original & Adapted narration), 100+ movies, 146 BGM tracks, 63 dubbing voices in 11 languages, 90+ narration templates. Use when creating narration videos, film commentary, short drama dubbing, or video production.

4myhime 4473