# Send Udio to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "udio",
    "name": "Udio",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/udio",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/udio",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/udio",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=udio",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "api.md",
      "browser.md",
      "lyrics.md",
      "memory-template.md",
      "prompts.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "udio",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T09:19:11.597Z",
      "expiresAt": "2026-05-17T09:19:11.597Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=udio",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=udio",
        "contentDisposition": "attachment; filename=\"udio-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "udio"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/udio"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/udio",
    "downloadUrl": "https://openagent3.xyz/downloads/udio",
    "agentUrl": "https://openagent3.xyz/skills/udio/agent",
    "manifestUrl": "https://openagent3.xyz/skills/udio/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/udio/agent.md"
  }
}
```
## Documentation

### 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

TopicFileSetupsetup.mdMemorymemory-template.mdAPI usageapi.mdBrowser automationbrowser.mdPrompt craftingprompts.mdStyle tagsstyles.mdLyrics guidelyrics.md

### 1. Choose the Right Approach

SituationMethodProgrammatic generation, batch jobsAPI wrapperUser wants to browse and listenBrowser automationJust need prompt helpPrompt engineering only

### 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:

Create initial clip with strong hook
Extend 2-3 times with consistent style
Add outro with ending indicators
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

### 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)

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

### Generate Music via UI

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

### By Genre

GenrePrompt PatternElectronicelectronic [subgenre] [mood] synth [texture] [era]Rock[sub]rock [energy] [guitars] [drums] [vocals] [decade]Hip Hophip hop [subgenre] [beat style] [sample type] [era]Jazzjazz [subgenre] [instruments] [setting] [mood]Classicalclassical [period] [ensemble] [mood] [dynamics]

### Mood Combinations

EnergyMood StackHigh + Positiveeuphoric energetic uplifting triumphantLow + Positivepeaceful calm serene contemplativeHigh + Negativeaggressive chaotic intense darkLow + Negativemelancholic somber mournful introspectiveComplexbittersweet nostalgic hopeful yearning

### 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

TrapProblemSolutionVague prompts"good music" = randomBe specific: genre, mood, instrumentsContradictions"upbeat sad" confuses modelPick consistent descriptorsToken expiry401 errorsRe-extract from browser cookiesToo many keywords20+ terms dilute focusUse 5-10 key descriptorsNo seed trackingCan't reproduce good resultsLog seeds for successful generationsAbrupt extensionsJarring transitionsMatch style/key in extend prompts

### Building Full Tracks

PhaseDurationPrompt AdditionsIntro0-30s"intro, building, atmospheric"Verse/Main30s-2mOriginal promptBridge2m-2:30"variation, bridge, key change"OutroFinal 30s"outro, ending, fade, resolution"

### 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

EndpointData SentPurposeapi.udio.comPrompts, lyricsMusic generation (via wrappers)udio.comBrowser sessionDirect platform access

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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T09:19:11.597Z
- Expires at: 2026-05-17T09:19:11.597Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/udio)
- [Send to Agent page](https://openagent3.xyz/skills/udio/agent)
- [JSON manifest](https://openagent3.xyz/skills/udio/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/udio/agent.md)
- [Download page](https://openagent3.xyz/downloads/udio)