← 返回 Skills 市场
AI-Music-Stream
作者
Ju-Chiang Wang
· GitHub ↗
· v1.0.4
· MIT-0
125
总下载
0
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install musestream
功能描述
Generate AI music from text prompts and stream continuously in-browser with a shareable player URL; all tracks are saved locally in a library.
安全使用建议
Before installing: (1) Understand the missing declaration — the code requires a Sonauto API key (SONAUTO_API_KEY) via config.json or env, but the skill metadata lists none; do not share keys publicly or commit them to source control. (2) Review the musestream_server.py and restart script locally before running; the server will save generated audio and a log file in your chosen directory. (3) Do NOT expose the server to the internet without protections: add token-based auth, TLS reverse proxy, IP firewall rules, and rate-limiting as suggested in the README. (4) Be cautious about providing sensitive context (location, traffic) to the agent; limit context to what you consent to share. (5) If you plan messenger integration, expect to provide additional bot tokens — verify where and how those tokens are stored. (6) Ask the skill owner/registry to update the declared required env/credentials to reflect SONAUTO_API_KEY and any other secrets the code actually needs. If you are uncomfortable with these mismatches or exposing a local server, run the skill in an isolated environment (VM/container) or decline installation.
功能分析
Type: OpenClaw Skill
Name: musestream
Version: 1.0.4
MuseStream is a legitimate AI music generation and streaming tool that integrates with the Sonauto API. The skill includes a Flask server (musestream_server.py) for managing generation tasks, proxying audio streams, and serving a local music library, with security measures like path traversal protection in the file-serving logic. While the server binds to all interfaces (0.0.0.0) and lacks built-in authentication, these risks are explicitly documented in the README.md along with instructions for users to secure their setup using firewalls or reverse proxies. No evidence of malicious intent, data exfiltration, or unauthorized persistence was found in the code or the agent instructions.
能力评估
Purpose & Capability
The skill's description and SKILL.md describe a Sonauto-backed music generator and local streaming server. However the registry metadata lists no required environment variables or primary credential, while the code and SKILL.md clearly require a Sonauto API key (SONAUTO_API_KEY) and a config.json. This discrepancy between what is declared and what is actually required is incoherent and should be corrected.
Instruction Scope
Most runtime instructions stay within the stated purpose (start server, call /start, save files). However the docs explicitly encourage replacing 'localhost' with an external IP or using tunnels/reverse proxies to expose the service and recommend the agent perform substitutions — this increases the risk of unwanted external exposure. The SKILL.md also tells the agent to collect contextual info (time, weather, location, traffic, mood) to craft prompts; collecting location/traffic data is privacy-sensitive and should be limited to what the user consents to. Overall the instruction set gives broad discretion to expose the server externally and to collect contextual data, which is beyond a minimal local music-generator scope.
Install Mechanism
This is an instruction-and-code skill (no packaged install). It requires pip installing two common packages (flask, requests) from PyPI and running the included Python script. There are no downloads from unknown hosts, no archive extraction, and the restart script simply runs the included Python program via nohup — install risk is moderate-to-low but you should still review code before running.
Credentials
The code expects and uses SONAUTO_API_KEY (and optional MUSESTREAM_* config values stored in config.json) but the skill metadata declares no required env vars or primary credential. The server will persist logs (log.jsonl) and save generated audio to a user-specified directory. The messenger-bot integration mentioned in docs would likely require additional tokens, but no bot tokens are requested or declared. Requiring an API key and writing files is reasonable for this functionality, but the omission from declared requirements and lack of explicit guidance for secure secret storage is concerning.
Persistence & Privilege
The skill does not request elevated platform privileges and is not always-enabled. It runs a local Flask server, writes saved audio and a JSONL log to the selected output directory, and starts itself via a simple restart script. The biggest persistence/privilege risk is network exposure: the README/SKILL.md encourage exposing the local server (substituting external IP or using tunnels) which materially increases blast radius if done without authentication and TLS. The skill itself does not automatically modify other agent/system configs.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install musestream - 安装完成后,直接呼叫该 Skill 的名称或使用
/musestream触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.4
MuseStream 1.0.4
- Default server port changed from 5000 to 5001.
- Environment variable setup instructions updated: `MUSESTREAM_PORT` now highlighted, and agents are prompted for preferred port; default paths/ports clarified.
- `restart_musestream.sh` now loads `.env` automatically; no need to source manually.
- All example requests and documentation updated to use port 5001.
- Improves clarity and flexibility for setup, especially around configuration of output directory and port.
v1.0.3
MuseStream Skill 1.0.3
- Improved setup instructions: now prompts user for preferred output directory and documents how to set `MUSESTREAM_OUTPUT_DIR` in `.env`.
- Default library location (`~/Music/MuseStream`) is now clearly stated and user-selectable during setup.
- No code changes detected; SKILL.md documentation updated for better clarity on configuring music output paths.
- All core features, endpoints, and provider setup remain unchanged.
v1.0.2
Major documentation overhaul clarifying agent workflow, provider support, and music prompt handling.
- Revised and expanded feature overview: clearer on core features, auto-queue behavior, and stream sharing.
- Stronger emphasis on agent role: agent must interpret/refine user prompts with its own LLM; server no longer rewrites prompts.
- Setup and environment sections streamlined for Sonauto as default, with guidance for adding new providers moved to the end.
- New and improved examples for prompt rewriting, context handling, and endpoint use.
- Messenger bot integration and security cautions highlighted.
- Mobile UI, library management, and all API endpoints updated and grouped for quick reference.
v1.0.1
- Initial release of the MuseStream skill as a standalone server package.
- Added main server script (`musestream_server.py`) for music generation, streaming, and local library management.
- Included startup automation (`restart_musestream.sh`) and dependency management (`requirements.txt`).
- Added comprehensive documentation (`README.md`) covering setup, API usage, and provider integration.
v1.0.0
MuseStream 1.0.0
- Initial release: AI music generation and seamless streaming with shareable player URLs.
- Songs are generated from natural language prompts or user context and saved locally.
- Features a browser-based player, library management, and mobile-friendly interface.
- Supports Sonauto as the default provider, with optional context prompt integration via MiniMax or Anthropic.
- Comprehensive REST API for starting, stopping, browsing, and streaming music sessions.
元数据
常见问题
AI-Music-Stream 是什么?
Generate AI music from text prompts and stream continuously in-browser with a shareable player URL; all tracks are saved locally in a library. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 125 次。
如何安装 AI-Music-Stream?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install musestream」即可一键安装,无需额外配置。
AI-Music-Stream 是免费的吗?
是的,AI-Music-Stream 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
AI-Music-Stream 支持哪些平台?
AI-Music-Stream 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 AI-Music-Stream?
由 Ju-Chiang Wang(@asriverwang)开发并维护,当前版本 v1.0.4。
推荐 Skills