Audio Cog - AI Audio Generation Powered by CellCog

---

name: audio-cog

description: AI audio generation powered by CellCog. Text-to-speech, voice synthesis, voiceovers, podcast audio, narration, music generation, background music, sound design. Professional audio creation with AI.

metadata:

openclaw:

emoji: "🎵"

author: CellCog

dependencies: [cellcog]

---

# Audio Cog - AI Audio Generation Powered by CellCog

Create professional audio with AI - from voiceovers and narration to background music and sound design.

---

Prerequisites

This skill requires the `cellcog` skill for SDK setup and API calls.

clawhub install cellcog

**Read the cellcog skill first** for SDK setup. This skill shows you what's possible.

**Quick pattern (v1.0+):**

# Fire-and-forget - returns immediately
result = client.create_chat(
    prompt="[your audio request]",
    notify_session_key="agent:main:main",
    task_label="audio-task",
    chat_mode="agent"  # Agent mode is optimal for all audio tasks
)
# Daemon notifies you when complete - do NOT poll

---

What Audio You Can Create

Text-to-Speech / Voiceover

Convert text to natural-sounding speech:

---

Available Voices

CellCog provides 8 high-quality voices with distinct characteristics:

| Voice | Gender | Best For | Characteristics |

|-------|--------|----------|-----------------|

| **cedar** | Male | Product videos, announcements | Warm, resonant, authoritative, trustworthy |

| **marin** | Female | Professional content, tutorials | Bright, articulate, emotionally agile |

| **ballad** | Male | Storytelling, flowing narratives | Smooth, melodic, musical quality |

| **coral** | Female | Energetic content, ads | Vibrant, lively, dynamic, spirited |

| **echo** | Male | Thoughtful content, documentaries | Calm, measured, deliberate |

| **sage** | Female | Educational, knowledge content | Wise, contemplative, reflective |

| **shimmer** | Female | Gentle content, wellness | Soft, gentle, soothing, approachable |

| **verse** | Male | Creative, artistic content | Poetic, rhythmic, expressive |

Voice Recommendations by Use Case

**For product videos and announcements:**

> Use **cedar** (male) or **marin** (female) - both project confidence and professionalism.

**For storytelling and audiobooks:**

> Use **ballad** (male) or **sage** (female) - designed for engaging, flowing narratives.

**For high-energy content:**

> Use **coral** (female) - vibrant and dynamic, perfect for ads and exciting announcements.

**For calm, educational content:**

> Use **echo** (male) or **shimmer** (female) - measured pacing ideal for learning.

Voice Style Customization

Beyond selecting a voice, you can fine-tune delivery with style instructions:

**Example with style instructions:**

> "Generate voiceover using cedar voice with a warm, conversational tone. Speak at medium pace with slight enthusiasm when mentioning features. American accent."

---

Music Generation

Create original background music and soundtracks:

Music Specifications

| Parameter | Options |

|-----------|---------|

| **Duration** | 15 seconds to 5+ minutes |

| **Genre** | Electronic, rock, classical, jazz, ambient, lo-fi, cinematic, pop, hip-hop |

| **Tempo** | 60 BPM (slow) to 180+ BPM (fast) |

| **Mood** | Upbeat, calm, dramatic, mysterious, inspiring, melancholic |

| **Instruments** | Piano, guitar, synth, strings, drums, brass, etc. |

Music Licensing

**All AI-generated music from CellCog is royalty-free and fully yours to use commercially.**

You have complete rights to use the generated music for:

No attribution required. No licensing fees. The music is generated uniquely for you.

---

Audio Output Formats

| Format | Best For |

|--------|----------|

| **MP3** | Standard audio delivery, voiceovers, music |

| Combined with video | Background music for video-cog outputs |

---

Chat Mode for Audio

**Use `chat_mode="agent"`** for all audio generation tasks.

Audio generation—whether voiceovers, music, or sound design—executes efficiently in agent mode. CellCog's audio capabilities don't require multi-angle deliberation; they require precise execution, which agent mode excels at.

There's no scenario where agent team mode provides meaningfully better audio output. Save agent team for research and complex creative work that benefits from multiple reasoning passes.

---

Example Audio Prompts

**Professional voiceover with specific voice:**

> "Generate a professional voiceover using the **marin** voice for this script:

>

> 'Introducing TaskFlow - the project management tool that actually works. With intelligent automation, seamless collaboration, and powerful analytics, TaskFlow helps teams do their best work.'

>

> Style: Confident and friendly, medium pace. Suitable for a product launch video."

**Podcast intro with voice selection:**

> "Create a podcast intro voiceover using **cedar** voice:

>

> 'Welcome to Future Forward, the podcast where we explore the technologies shaping tomorrow. I'm your host, and today we're diving into...'

>

> Style: Warm and engaging, conversational tone. Also generate a 10-second upbeat intro music bed to go underneath."

**Background music:**

> "Generate 2 minutes of calm, lo-fi hip-hop style background music. Should be chill and unobtrusive, good for studying or working. Include soft piano, mellow beats, and gentle vinyl crackle. 75 BPM."

**Audiobook narration:**

> "Create an audiobook-style narration using **ballad** voice for this passage:

>

> [passage text]

>

> Style: Warm storytelling quality, measured pace with appropriate pauses for drama."

**Cinematic music:**

> "Generate 90 seconds of cinematic orchestral music for a tech company's 'About Us' video. Start soft and inspiring, build to a confident crescendo, then resolve to a hopeful ending."

---

Multi-Language Support

CellCog can generate speech in 50+ languages:

Specify the language in your prompt:

> "Generate this text in Japanese with a native female speaker using shimmer voice: 'いらっしゃいませ...'"

---

Tips for Better Audio

1. **Choose the right voice**: Match the voice to your content type. Cedar/marin for professional, ballad/sage for storytelling, coral for energy.

2. **Provide the complete script**: Don't say "something about our product" - write out exactly what should be said.

3. **Include style instructions**: "Confident but warm", "slow and deliberate", "with slight excitement" helps shape delivery.

4. **For music**: Specify duration, tempo (BPM if you know it), mood, and genre.

5. **Pronunciation guidance**: For names or technical terms, add hints: "CellCog (pronounced SELL-kog)"

6. **Emotional beats**: For longer voiceovers, indicate tone shifts: "[excited] And now for the big reveal... [serious] But there's a catch."