Suno Create Skill

Overview

Create songs on Suno.com by filling the form with lyrics + style and triggering generation. Download songs and send to Telegram.

Workflow

Step 1: Ensure Suno Login

Browser must be logged into Suno. If not logged in:

Navigate to suno.com
Click "Sign in" → Google OAuth login
Verify logged in (account name + credits visible in sidebar)

Step 2: Navigate to Create Page

browser(action=navigate, url="https://suno.com/create")
sleep 5

Step 3: Search for Correct Lyrics

If user provides lyrics → use provided lyrics.

If user provides song name → search online for correct lyrics:

Try: duckduckgo.com search → find lyrics from mojigeci.com, kkbox.com, lyrics.com.tw
Use browser to navigate to lyrics page, extract text content

Search URLs:

https://html.duckduckgo.com/html/?q={song_name}+歌词+{artist}
https://html.duckduckgo.com/html/?q={song_name}+lyrics+{artist}

Step 4: Prepare Lyrics + Style

Lyrics format for Suno - Use clean text without formatting tags:

[Verse]
歌词内容...

[Chorus]
副歌内容...

G.E.M. 邓紫棋 style prompt (reference: references/gem_style.md):

G.E.M.邓紫棋风格, 强大的 belting 声乐, 沙哑音色, R&B 流行, 宽广音域, 情感化中文演唱, 呼吸感副歌, 灵魂情歌, 2000s-2020s 华语天后气质, 怀旧浪漫

Step 5: Fill Form via Browser Evaluate

Use React-compatible input method (Suno uses React - plain fill/type won't work):

// Fill lyrics
const LYRICS = `...`; // multi-line lyrics string

// Fill style
const STYLE = `G.E.M.邓紫棋风格, 强大的 belting 声乐...`;

browser(action=act, targetId="<current_targetId>", kind=evaluate, fn=r'''() => {
  const LYRICS = `...`;
  const STYLE = `...`;

  // Fill lyrics textarea
  const textareas = document.querySelectorAll('textarea');
  for (const ta of textareas) {
    const ph = ta.placeholder || '';
    if (ph.includes('lyrics') || ph.includes('Write some')) {
      Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value').set.call(ta, LYRICS);
      ta.dispatchEvent(new Event('input', {bubbles: true}));
      ta.dispatchEvent(new Event('change', {bubbles: true}));
    }
  }

  // Fill style textarea (find by placeholder "Meditative" or existing "moody" value)
  for (const ta of textareas) {
    const ph = ta.placeholder || '';
    const val = ta.value || '';
    if (ph.includes('Meditative') || (val.includes('moody') && !val.includes('G.E.M.'))) {
      Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value').set.call(ta, STYLE);
      ta.dispatchEvent(new Event('input', {bubbles: true}));
      ta.dispatchEvent(new Event('change', {bubbles: true}));
    }
  }

  // Click Create
  setTimeout(() => {
    const buttons = Array.from(document.querySelectorAll('button'));
    for (const btn of buttons) {
      const txt = btn.textContent.trim();
      if (txt === 'Create' || txt === 'Create song') {
        if (!btn.disabled) { btn.click(); }
        break;
      }
    }
  }, 500);

  return 'Done';
}''')

Step 6: Wait for Generation

Wait 30-40 seconds, then take screenshot to verify:

sleep 35
browser(action=screenshot, targetId="<targetId>", fullPage=true)

New songs appear in right sidebar workspace.

Step 7: Extract Song IDs

// Get song IDs and titles from page
browser(action=act, kind=evaluate, fn=r'''() => {
  const songs = Array.from(document.querySelectorAll('a[href*="/song/"]')).map(a => {
    const match = a.href.match(/\/song\/([^\/]+)/);
    return match ? { title: a.textContent.trim(), id: match[1] } : null;
  }).filter(s => s);
  return JSON.stringify(songs.slice(0, 10));
}''')

Step 8: Download Songs

Song audio URL pattern: https://cdn1.suno.ai/{song_id}.mp3

# Download song
curl -sL -o "/tmp/song_{id}.mp3" "https://cdn1.suno.ai/{song_id}.mp3"

# Copy to workspace for Telegram
cp "/tmp/song_{id}.mp3" "/home/aa/.openclaw/workspace-content/song_{id}.mp3"

Step 9: Send to Telegram

# Via message tool
message(action=send, channel="telegram", target="<chat_id>", 
        filePath="/home/aa/.openclaw/workspace-content/song_{id}.mp3",
        caption="🎵 {song_title}")

Or send links:

message(action=send, channel="telegram", target="<chat_id>",
        message=f"🎵 {song_title}\n🎧 https://suno.com/song/{song_id}\n📥 https://cdn1.suno.ai/{song_id}.mp3")

Key Notes

React synthetic events: Suno's form inputs require nativeInputValueSetter + input event with bubbles: true to update React state
Credit cost: Each Create = 10 credits (generates 2 versions)
Song IDs: Each generated song has unique UUID, extract after page update
Download URL: Always https://cdn1.suno.ai/{id}.mp3 (verified working)
Browser stability: If browser times out, restart with browser(action=start) then retry

Troubleshooting

Form not filling: Suno uses React - must use evaluate with nativeInputValueSetter
Create button disabled: Check if lyrics textarea has content (may need proper line breaks)
Browser timeout: Restart browser, re-navigate to suno.com/create
Wrong lyrics: Always search for official lyrics first (song may have multiple versions)

suno-create