ohyesai-music
Generate custom music tracks (vocal or instrumental) via OhYesAI asynchronously.
Best use case
ohyesai-music is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Generate custom music tracks (vocal or instrumental) via OhYesAI asynchronously.
Teams using ohyesai-music should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/ohyesai-music/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How ohyesai-music Compares
| Feature / Agent | ohyesai-music | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Generate custom music tracks (vocal or instrumental) via OhYesAI asynchronously.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
SKILL.md Source
# Music Skill
通过调用 OhYesAI API，直接在 Clawdbot 中生成自定义风格的歌曲（支持纯音乐或带人声）。
*注意：音乐生成耗时较长，本技能采用“提交任务 -> 轮询查询状态 -> 下载文件”的异步工作流。*
## Setup
1. 首次安装/使用时，请前往获取 API Key: https://ohyesai.com
2. 设置你的环境变量:
```bash
export OHEYSAI_API_KEY="your-api-key"
```
## Usage
使用此技能生成音乐时，必须与用户进行多轮对话以收集必要参数。完成生成、下载后，必须**将真实音频文件交付给用户**。
### 参数说明
在调用 API 前，请确认以下参数：
- `prompt` (必填)：用户提示词/歌曲的画面与情感描述，需与用户沟通获取。
- `styles` (必填)：歌曲风格（如“流行”、“动漫”、“摇滚”等），需与用户沟通获取。
- `instrumental` (必填)：布尔值。`true` 代表纯音乐（无歌词/无人声），`false` 代表有歌词的音乐，需与用户沟通获取。
- `title`：歌曲标题。**无需向用户询问**，请根据其他参数自动推理生成一个合适的歌名。
### 1. 提交任务 (Submit Task)
收集完参数后，使用 `curl` 调用 submit 接口提交任务：
```bash
curl -s --location --request POST "https://ohyesai.com/ohyesai-next/api/vio/skill/music-submit?apikey=$OHEYSAI_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"title": "晚安",
"prompt": "晚安风格的宁静歌曲",
"styles": "动漫",
"instrumental": true
}'
```
**返回值**：该接口会返回一个 `taskId`（任务ID），请务必将其提取并保存，用于后续查询。
### 2. 查询任务状态 (Query Status)
使用获取到的 `taskId` 通过 GET 请求不断轮询查询任务状态：
```bash
curl -s --location --request GET "https://ohyesai.com/ohyesai-next/api/vio/skill/music-query?apikey=$OHEYSAI_API_KEY&taskId=你的taskId"
```
**接口返回值有以下 3 种状态**：
1. `**音乐生成状态**: 进行中` -> 任务还在排队或生成中，**你需要 sleep 一段时间（如 10 秒）后继续重试**。
2. `**音乐生成状态**: 已完成` -> 任务完成，状态文本后会附加包含 MP3 音频链接的 Markdown 文本。
3. `**任务不存在**` -> 任务生成失败或 ID 错误，应终止轮询并告知用户。
### 3. 下载与交付 (Download and Deliver)
当状态变为**已完成**时，返回值示例：
```md
**音乐生成状态**: 已完成
[晚安_1](https://ohyesainext-test.tos-cn-beijing.volces.com/mv%2F202603%2F66d82e777e2544a89a6c3aedc9f60c93.mp3?...)
[晚安_2](https://ohyesainext-test.tos-cn-beijing.volces.com/mv%2F202603%2F66d82e777e2544a89a6c3ae706362o75.mp3?...)
```
**必须严格执行以下交付操作**：
1. 从上述返回值中提取出 `.mp3` 文件的 URL。
2. 使用 `curl -o "文件名.mp3" "音频URL"` 命令将音频文件下载到当前工作目录。
3. **⚠️ 致命注意（推送文件）：** 下载完成后，**绝对不能仅仅回复纯文本！** 你必须输出可供用户点击的本地文件链接，例如 `[点击下载 晚安_1.mp3](./晚安_1.mp3)` 或者调用系统内置的发文件工具将本地 MP3 推送给用户。
## Examples
这里提供了一个标准的 Bash 自动化脚本，它整合了**提交、轮询、提取、下载**的全流程，你（大语言模型）可以直接修改参数并执行此脚本来完成整个任务：
```bash
# 1. 提交任务并获取 Task ID
TASK_ID=$(curl -s --location --request POST "https://ohyesai.com/ohyesai-next/api/vio/skill/music-submit?apikey=$OHEYSAI_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"title": "安眠曲",
"prompt": "安静助眠的轻音乐",
"styles": "动漫",
"instrumental": true
}')
# 简单清理可能存在的引号或换行符
TASK_ID=$(echo "$TASK_ID" | tr -d '"' | tr -d '\n' | tr -d '\r')
echo "Task Submitted! Task ID: $TASK_ID"
echo "开始轮询等待音乐生成..."
# 2. 轮询状态
while true; do
RESULT=$(curl -s --location --request GET "https://ohyesai.com/ohyesai-next/api/vio/skill/music-query?apikey=$OHEYSAI_API_KEY&taskId=$TASK_ID")
if echo "$RESULT" | grep -q "已完成"; then
echo "音乐生成已完成！"
# 3. 提取 MP3 URL（正则提取 http...mp3... 括号内的内容）
MP3_URL=$(echo "$RESULT" | grep -o 'http[^)]*' | head -n 1)
if [ -n "$MP3_URL" ]; then
echo "正在下载音频..."
curl -s -o "安眠曲_1.mp3" "$MP3_URL"
echo "下载成功！文件已保存为 ./安眠曲_1.mp3"
else
echo "未能提取到有效的音频 URL"
fi
break
elif echo "$RESULT" | grep -q "任务不存在"; then
echo "查询失败：任务不存在或已失效。"
break
else
echo "生成中，等待 20 秒后重试..."
sleep 20
fi
done
```
### 完整工作流说明
1. 询问用户获取 `prompt`, `styles`, `instrumental`。
2. 自动生成 `title`，代入上述示例脚本并执行。
3. 脚本执行完毕并显示“下载成功”后，向用户回复：**"您的音乐已生成完毕，请点击此处收听/下载：[安眠曲_1.mp3](./安眠曲_1.mp3)"** (或者调用系统发文件的内置能力)。
### 联系客服
Related Skills
🎵 Play Music Skill
**Controlled music player with pause/resume/stop support**
home-music
Control whole-house music scenes combining Spotify playback with Airfoil speaker routing. Quick presets for morning, party, chill modes.
Music Playlist Generation (PlaylistGen)
LLM-powered playlist generation for your local music library that contains music audio files such as mp3, flac, m4a, etc. Integrate this skill with your Agents (e.g., OpenClaw) to enable natural language music discovery and playlist curation through conversation. Point it at your music folder, run the indexer once, and get a natural language playlist generator — accessible via web browser or API.
asmr-music
Provide professional ASMR music recommendations and playback services to help users achieve sleep aid, heart rate regulation, and focus enhancement through scientifically designed audio. Use when user wants to (1) relax, sleep, or fall asleep, (2) regulate heart rate or relieve anxiety, (3) improve focus and concentration for study or work, (4) find background white noise or ambient sounds, (5) practice meditation or deep breathing, (6) set up automatic daily reminders for ASMR listening. Keywords: sleep, relax, meditation, heart rate, anxiety, focus, concentration, white noise, ASMR, background music, calming, stress relief, daily reminder, nightly routine.
gequhai-music
搜索和下载歌曲海(gequhai.com)的音乐，支持搜索歌曲、获取下载链接（优先无损/高品质）， 并可一键下载到群晖NAS。当用户询问歌曲、搜索音乐、或想下载歌曲时使用此技能。
apple-music-dj
Ultimate personalization engine for Apple Music. Analyzes listening history, Apple Music Replay stats, library data, and taste patterns to create intelligent playlists directly in the user's Apple Music library via the MusicKit API. Supports deep cuts discovery, mood/activity playlists, trend scouting, constellation discovery ("surprise me"), playlist refresh/evolution, automated weekly curation via cron, taste DNA cards, compatibility scoring, listening insights, catalog gap analysis, album deep dives, artist rabbit holes, daily song drops, concert prep, and personalized new release radar. Use this skill whenever the user mentions Apple Music, playlists, music recommendations, listening habits, music taste, "what should I listen to", discovering new music, mood playlists, workout playlists, deep cuts, hidden gems, trending music, "surprise me", refreshing a playlist, or anything related to curating their music experience. Also trigger on: "DJ", "mix", "playlist for", "music for", "songs like", "similar to", "what's hot", "new releases for me", "taste DNA", "taste card", "compatibility", "how compatible", "year in review", "listening stats", "what have I missed", "album deep dive", "rabbit hole", "concert prep", "seeing [artist] live", "daily song", "what should I listen to right now", or OpenClaw in the context of music.
🎛️ CLAW.FM ACID TECHNO LIVE MUSICIAN
**Transform your OpenClaw AI agent into an autonomous acid techno producer crafting hyperpop-chaos bangers inspired by Le Wanski and Fred again...**
aimlapi-music
Generate high-quality music/songs via AIMLAPI. Supports Suno, Udio, Minimax, and ElevenLabs music models. Use when the user asks for music, songs, or soundtracks with specific lyrics or styles.
youtube-music-cast
Download music from YouTube/YouTube Music and stream to Chromecast via Home Assistant. Complete CLI toolset with web server integration, configuration wizard, and playback controls.
music-analysis
Analyze music/audio files locally without external APIs. Extract tempo, pocket/groove feel, pulse stability, swing proxy, section/repetition structure, key clarity, harmonic tension, timbre descriptors, temporal mood-energy journeys, and lyric-aware emotional reads where real Whisper lyrics can override the vibe when the words are clearly darker, warmer, or more intense than the arrangement alone suggests. Use when asked to 'listen to this', 'hear the music', audit tracks, compare mixes, inspect structure, or generate producer-facing notes from audio files.
desktop-music-launcher
检索本机已安装音乐软件，启动它，并根据用户需求推荐、搜索或播放歌曲；在 macOS 上可用 AppleScript 控制 Spotify 和 Apple Music，并为 Spotify 增加可选的精确点播链路。
music-manager
通用音乐下载管理器。支持从YouTube/Bilibili搜索下载音乐，自动转MP3，按分类存入本地音乐库