ClawHub

天谱乐音乐生成大师

v1.0.0

使用天谱乐 AI 生成纯音乐、歌曲（含人声演唱）或歌词，将结果保存到本地。当用户提到"天谱乐""天璞悦""Tianpuyue""Tempolor""AI 作曲""AI 音乐""生成音乐""生成歌曲""生成歌词""BGM""背景音乐"时引用；当用户需要为视频、游戏或内容创作配乐时引用；当用户需要纯音乐（无人声）时引...

⭐ 0· 92·0 current·0 all-time
by王新平（Wang-Xin-ping）@showtimewalker

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for showtimewalker/tianpuyue-music.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "天谱乐音乐生成大师" (showtimewalker/tianpuyue-music) from ClawHub.
Skill page: https://clawhub.ai/showtimewalker/tianpuyue-music
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Required env vars: TIANPUYUE_API_KEY, OUTPUT_ROOT
Required binaries: uv
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install tianpuyue-music

ClawHub CLI

Package manager switcher

npx clawhub@latest install tianpuyue-music
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
Name/description match the code and SKILL.md. The skill needs an API key (TIANPUYUE_API_KEY) and an output root for saving files (OUTPUT_ROOT), which are appropriate for a remote music-generation provider that returns downloadable audio/lyrics.
ℹ
Instruction Scope
The SKILL.md and scripts explicitly limit behavior to: create tasks, poll status, download result files, and write local logs/outputs. Scripts log events (including user prompts) to local log files under OUTPUT_ROOT and call network endpoints only at BASE_URL (api.tianpuyue.cn) and the returned audio URLs. One minor inconsistency: script headers demand Python >=3.14, which may not match typical environments and could cause runtime problems if not available.
✓
Install Mechanism
There is no install spec (instruction-only with shipped scripts). The skill does not download arbitrary code at install time. It does require the 'uv' runner binary (used to invoke the scripts) — this is reasonable for the provided invocation examples but you should ensure 'uv' is a trusted runner in your environment.
✓
Credentials
Only TIANPUYUE_API_KEY (primary credential) and OUTPUT_ROOT are required, with an optional TIANPUYUE_CALLBACK_URL. These are proportionate to the skill's function. The API key will be sent to the provider in an Authorization header; users should ensure the key's scope and trust in the provider.
✓
Persistence & Privilege
always is false and the skill is user-invocable; it does not request permanent platform presence or modify other skills. It writes logs and outputs under OUTPUT_ROOT but does not alter system-wide agent settings.
Assessment
This skill appears to do what it says: call Tianpuyue endpoints to generate music/songs/lyrics, poll job status, download resulting audio/lyrics, and save logs and outputs under OUTPUT_ROOT. Before installing, confirm: (1) you trust the Tianpuyue provider because your API key (TIANPUYUE_API_KEY) will be sent in requests; (2) the 'uv' runner used to launch scripts is acceptable in your environment; (3) your environment has a compatible Python version (scripts declare requires-python >=3.14, which may be unrealistic); (4) generated prompts and metadata are logged locally under OUTPUT_ROOT — avoid sending sensitive data in prompts if you do not want it persisted; (5) the skill does not upload outputs or publish shareable links (you must handle sharing separately). If any of these points are concerning, do not install or review/modify the scripts (common.py) to meet your security policies.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

Binsuv
Any binpython, python3, py
EnvTIANPUYUE_API_KEY, OUTPUT_ROOT
Primary envTIANPUYUE_API_KEY
latestvk974zbsrntqbn0hc0y3j5gz3pd846zqb
92downloads
0stars
1versions
Updated 3w ago
v1.0.0
MIT-0
王新平（Wang-Xin-ping）@showtimewalker
latest
Download

天谱乐音乐生成

这个 skill 是纯内容生成能力，负责天谱乐的纯音乐/歌曲/歌词任务创建、状态查询和本地下载，不负责对象存储上传或分享链接生成。

适用场景：

  • 用户明确指定使用天谱乐生成纯音乐、歌曲或歌词
  • 多媒体工作流需要一个音乐生成供应商
  • 已有 item_id，只需要查询进度或下载本地结果

使用脚本

脚本位于 skill 目录内的 scripts/，运行时始终使用绝对路径。

设 TP_SKILL_DIR 为 .claude/skills/tianpuyue_music 的绝对路径：

  • 纯音乐生成（完整流程）：uv run --python python $TP_SKILL_DIR/scripts/generate_music.py --prompt "..." --name "忧伤钢琴曲"
  • 歌曲生成（完整流程）：uv run --python python $TP_SKILL_DIR/scripts/generate_song.py --prompt "..." --name "夏日海边"
  • 歌词生成（完整流程）：uv run --python python $TP_SKILL_DIR/scripts/generate_lyrics.py --prompt "..." --name "青春离别"
  • 纯音乐状态查询：uv run --python python $TP_SKILL_DIR/scripts/query_music_status.py --item-id <ID>
  • 歌曲状态查询：uv run --python python $TP_SKILL_DIR/scripts/query_song_status.py --item-id <ID>
  • 歌词状态查询：uv run --python python $TP_SKILL_DIR/scripts/query_lyrics_status.py --item-id <ID>

脚本参数

纯音乐生成

参数必需说明
--prompt是音乐描述提示词，可包含节奏、调性、和弦、时长等
--name否文件名描述，不超过 10 个中文字
--model否模型名称，默认 TemPolor i3.5
--poll-interval否轮询间隔秒数，默认 15
--timeout否超时秒数，默认 900

歌曲生成

参数必需说明
--prompt是音乐描述提示词
--name否文件名描述，不超过 10 个中文字
--model否模型名称，默认 TemPolor v4.5
--lyrics否自定义歌词（为空时自动生成）
--voice-id否演唱声音 ID，参考 references/voice_id_map.md
--poll-interval否轮询间隔秒数，默认 15
--timeout否超时秒数，默认 900

歌词生成

参数必需说明
--prompt是歌词生成的提示文本
--name否文件名描述，不超过 10 个中文字
--song-model否适配的歌曲模型名称，默认 TemPolor v4.5
--poll-interval否轮询间隔秒数，默认 10
--timeout否超时秒数，默认 300

输出约定

  • 本地输出目录（相对于 OUTPUT_ROOT，默认为项目根目录）：
    • outputs/tianpuyue/music/
    • outputs/tianpuyue/songs/
    • outputs/tianpuyue/lyrics/
  • 纯音乐/歌曲输出 JSON 至少包含：
    • type — music / song
    • provider — tianpuyue
    • item_id
    • local_path
    • source_url
  • 歌词输出 JSON 至少包含：
    • type — lyrics
    • provider — tianpuyue
    • item_id
    • local_path
    • title
    • lyric

配置

  • 环境变量：TIANPUYUE_API_KEY（必需，未设置时直接报错）
  • 环境变量：TIANPUYUE_CALLBACK_URL（可选，轮询模式下使用占位值即可）
  • 环境变量：OUTPUT_ROOT（可选，输出根目录，支持 ~ 展开，默认为用户主目录）

协作方式

  • 如果用户只要求生成并得到本地文件，本 skill 可直接完成
  • 如果用户还需要可访问链接，应由后续的交付环节继续处理
  • 当用户未指定供应商时，是否使用天谱乐由多媒体内容生成 Agent 的预设策略决定

Comments

Loading comments...