avatar✓ تایید شده

محتوای SKILL.md

---
name: avatar
description: Interactive AI avatar with Simli video rendering and ElevenLabs TTS
emoji: "\U0001F9D1\u200D\U0001F4BB"
homepage: https://github.com/Johannes-Berggren/openclaw-avatar
metadata:
  clawdis:
    skillKey: avatar
    os: [macos, linux, windows]
    requires:
      bins: [node, npm]
      env: [SIMLI_API_KEY, ELEVENLABS_API_KEY]
    install:
      - npm install -g openclaw-avatar
    config:
      requiredEnv:
        - SIMLI_API_KEY
        - ELEVENLABS_API_KEY
      example: |
        SIMLI_API_KEY=your-simli-api-key
        ELEVENLABS_API_KEY=your-elevenlabs-api-key
    cliHelp: |
      openclaw-avatar - Interactive AI avatar frontend

      Usage: openclaw-avatar [options]

      Starts the avatar server at http://localhost:5173
      Requires SIMLI_API_KEY and ELEVENLABS_API_KEY environment variables.
---

# Avatar Skill

Interactive AI avatar interface for OpenClaw with real-time lip-synced video and text-to-speech.

## Features

- **Voice Responses**: Speaks conversational summaries using ElevenLabs TTS
- **Visual Avatar**: Realistic lip-synced video via Simli
- **Detail Panel**: Shows formatted markdown alongside spoken responses
- **Multi-language**: Supports multiple languages for speech and TTS
- **Slack/Email**: Forward responses to Slack DMs or email (when configured)
- **Stream Deck**: Optional hardware control with Elgato Stream Deck

## Setup

1. Get API keys:
   - [Simli](https://simli.com) - Avatar rendering
   - [ElevenLabs](https://elevenlabs.io) - Text-to-speech

2. Set environment variables:
   ```bash
   export SIMLI_API_KEY=your-key
   export ELEVENLABS_API_KEY=your-key
   ```

3. Start the avatar:
   ```bash
   openclaw-avatar
   ```

4. Open http://localhost:5173

## Response Format

When responding to avatar queries, use this format:

```
<spoken>
A short conversational summary (1-3 sentences). NO markdown, NO formatting. Plain speech only.
</spoken>
<detail>
Full detailed response with markdown formatting (bullet points, headers, bold, etc).
</detail>
```

### Guidelines

1. **spoken**: Brief, natural, conversational. This is read aloud.
2. **detail**: Comprehensive information with proper markdown.
3. Always include both sections.

## Example

User: "What meetings do I have today?"

```
<spoken>
You have three meetings today. Your first one is a team standup at 9 AM, then a product review at 2 PM, and finally a 1-on-1 with Sarah at 4 PM.
</spoken>
<detail>
## Today's Meetings

### 9:00 AM - Team Standup
- **Duration**: 15 minutes
- **Attendees**: Engineering team

### 2:00 PM - Product Review
- **Duration**: 1 hour
- **Attendees**: Product, Design, Engineering leads

### 4:00 PM - 1:1 with Sarah
- **Duration**: 30 minutes
- **Notes**: Follow up on project timeline
</detail>
```

## Session Key

Avatar responses use session key: `agent:main:avatar`

مجوز

مجوز اعلام‌شده: MIT

MIT License

Copyright (c) 2026 openclaw

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

مشاهدهٔ مجوز در مخزن منبع — نسخهٔ منتشرشده در آن‌جا مرجع است.