Setup

On first use, read setup.md for integration guidelines.

When to Use

User wants to generate music with Udio. Agent can use API wrappers for programmatic generation, browser automation for direct platform interaction, or guide prompt engineering.

Architecture

Memory at ~/udio/. See memory-template.md for structure.

~/udio/
├── [memory.md]       # Created on first use: preferences, auth token location
├── [projects/]       # Per-project song tracking
└── [songs/]          # Downloaded audio files

Quick Reference

Core Rules

1. Choose the Right Approach

2. API Requires Auth Token

Udio has no official public API. Community wrappers use the internal API:

• Token: sb-api-auth-token cookie from udio.com
• Token expires: refresh if 401 errors occur
• See api.md for setup instructions

3. Structure Prompts in Layers

[genre] [subgenre] [mood] [instruments] [voice] [era/influence]

Example: "indie folk melancholic acoustic guitar female vocals 90s"

4. Extend Songs Strategically

Udio generates ~30 second clips. Build full songs:

1. Create initial clip with strong hook
2. Extend 2-3 times with consistent style
3. Add outro with ending indicators
4. Target 2-4 minutes total

5. Save Successful Seeds

Same prompt + different seed = different result. When close to desired output:

• Note the seed number
• Try adjacent seeds (seed +/- 1)
• Document working combinations

API Integration

Python Wrapper (Recommended)

pip install udio_wrapper

from udio_wrapper import UdioWrapper

# Initialize with auth token
udio = UdioWrapper("your-sb-api-auth-token")

# Create a song
song = udio.create_song(
    prompt="electronic ambient downtempo dreamy synth pads",
    seed=-1,  # -1 for random
    custom_lyrics="Optional lyrics here"
)

# Extend the song
extended = udio.extend(
    prompt="add drums and bass, building energy",
    audio_conditioning_path=song['song_path'],
    audio_conditioning_song_id=song['id']
)

# Add outro
outro = udio.add_outro(
    prompt="gentle fade out, conclusion",
    audio_conditioning_path=extended['song_path'],
    audio_conditioning_song_id=extended['id']
)

TypeScript/Node Wrapper

npm install udio-wrapper

import { createUdioWrapper } from 'udio-wrapper';

const client = await createUdioWrapper('your-auth-token');

const song = await client.createSong({
    prompt: 'indie rock upbeat energetic guitar',
    seed: 12345,
    customLyrics: 'Optional lyrics'
});

const completed = await client.waitForCompletion(song.id);
console.log('Download URL:', completed.url);

Complete Song Sequence

# Generate intro + extensions + outro in one call
complete = udio.create_complete_song(
    short_prompt="peaceful acoustic guitar melody",
    extend_prompts=[
        "add piano and soft strings",
        "introduce light percussion, building"
    ],
    outro_prompt="gentle resolution, fading",
    num_extensions=2,
    custom_lyrics_short="Opening verse...",
    custom_lyrics_extend=["Middle section...", "Bridge..."],
    custom_lyrics_outro="Final words..."
)

Browser Automation

When API isn't available or user prefers visual interaction:

Navigate to Udio

browser action=open targetUrl="https://www.udio.com" profile=openclaw

Get Auth Token (for API use)

1. Open DevTools: Cmd+Option+I (Mac) or F12 (Windows)
2. Go to Application tab > Cookies > udio.com
3. Find sb-api-auth-token
4. Copy the value

Generate Music via UI

1. Navigate to create page
2. Enter prompt in text field
3. Adjust settings (instrumental, duration)
4. Click generate
5. Wait for completion (~30-60 seconds)
6. Download or extend

Prompt Patterns

By Genre

Mood Combinations

Voice Control

# Female vocals
female vocals ethereal soprano breathy

# Male vocals  
male vocals deep baritone raspy emotional

# Choir
choir harmonies gospel powerful anthemic

# No vocals
instrumental only no singing no vocals

Common Traps

Extension Strategy

Building Full Tracks

Ending Indicators

Add to final extend/outro:

• "fade out" / "fading"
• "song ending" / "conclusion"
• "final chorus" / "last verse"
• "resolution" / "outro"

Data Storage

This skill creates ~/udio/ on first use:

• memory file — Preferences, successful prompts, token location reference
• projects folder — Per-project tracking with seeds and URLs
• songs folder — Downloaded audio files (optional)

All data stays local. Auth tokens should be stored in system keychain, not plain text.

Scope

This skill does:

• Generate music via community API wrappers (requires auth token)
• Navigate udio.com with browser automation (user must be logged in)
• Craft optimized prompts for Udio's model (no token needed)
• Track projects, seeds, and successful patterns locally
• Download generated audio files to ~/udio/songs/

This skill does NOT:

• Store auth tokens in plain text (must use keychain/credential manager)
• Bypass Udio's rate limits or terms of service
• Access files outside ~/udio/
• Auto-extract tokens without user guidance

Security Notes

Auth Token: The sb-api-auth-token cookie grants API access to your Udio account. Handle it like a password:

• Store in system keychain, never in plain text
• Token expires after ~7 days of inactivity
• Re-extract if you get 401 errors

Community Wrappers: The Python and Node wrappers are community-maintained (not official Udio software). Review their source code before installing:

• Python: github.com/flowese/UdioWrapper
• Node: github.com/josephgodwinkimani/udio-wrapper

Prompt-Only Mode: If you prefer not to use API or share tokens, this skill works in prompt-only mode — just help with crafting effective prompts without any API calls.

External Endpoints

Auth token is sent with API requests. No other data leaves the machine.

Trust

By using this skill with API wrappers, prompts and lyrics are sent to Udio's servers for music generation. Only use if you trust Udio with your creative content. Review Udio's terms of service at udio.com/terms.

Related Skills

Install with clawhub install <slug> if user confirms:

• audio — Audio processing and editing
• video — Combine music with video content
• ffmpeg — Audio format conversion

Feedback

• If useful: clawhub star udio
• Stay updated: clawhub sync