← 返回 Skills 市场
icecat2005

RoomSound

作者 icecat2005 · GitHub ↗ · v0.1.5
cross-platform ✓ 安全检测通过
555
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install roomsound
功能描述
RoomSound gives your agent the skill to play audio to your speakers. Starting with YouTube to Bluetooth speakers, expanding to local files and other sources.
安全使用建议
RoomSound appears coherent for its purpose, but before installing or initializing it you should: 1) Be prepared to approve package installations (sudo apt install) and verify packages come from your distro's repos; 2) Expect the agent to enumerate Bluetooth devices and store MAC addresses as alias mappings—if you are privacy-conscious, decide whether you want those stored and where; 3) Confirm any automatic changes to audio sinks or default devices (wpctl/pactl) are acceptable; 4) If you prefer tighter control, run the apt installs and create the yt-dlp config yourself and only grant the agent permission to execute the playback commands; 5) If you are uncomfortable with autonomous agent actions, restrict the skill to user-invoked only or disable autonomous invocation in your agent configuration.
功能分析
Type: OpenClaw Skill Name: roomsound Version: 0.1.5 The skill bundle is designed for audio playback and Bluetooth speaker control, utilizing standard tools like `yt-dlp`, `mpv`, and `bluetoothctl`. All commands executed are directly aligned with the stated purpose, and there is no evidence of data exfiltration, persistence mechanisms, or unauthorized network activity. Crucially, the `SKILL.md` file explicitly instructs the AI agent to perform input sanitization using `tr -d` on user-supplied text before interpolating it into shell commands, demonstrating a clear intent to prevent command injection vulnerabilities. File system modifications are limited to creating a user-specific `yt-dlp` configuration file, which is a standard and non-malicious operation.
能力评估
Purpose & Capability
The skill's name/description (play audio to speakers, starting with YouTube/Bluetooth) matches the declared binaries (yt-dlp, mpv, bluetoothctl) and the apt packages suggested (yt-dlp, mpv, bluez, pulseaudio-utils). There are no unrelated credentials, binaries, or config paths requested.
Instruction Scope
SKILL.md instructs the agent to run local system commands (bluetoothctl, wpctl/pactl, yt-dlp, mpv), build queues, and persist speaker alias → MAC mappings and a small yt-dlp config (~/.config/yt-dlp/config). These actions are within the skill's domain, but they do involve enumerating Bluetooth devices (MAC addresses) and writing user config/agent memory—both are privacy-relevant and worth informing the user about.
Install Mechanism
This is an instruction-only skill with no external installers. The only install instruction is to use the system package manager (apt) for well-known packages; no downloads from untrusted URLs or archive extraction are specified.
Credentials
No environment variables or external credentials are requested. The only persisted data is local aliases and a yt-dlp config; those are proportional to the feature set but contain device identifiers (MACs), which are sensitive.
Persistence & Privilege
The skill will write a yt-dlp config (~/.config/yt-dlp/config) and persist alias→MAC mappings in agent memory/config, and may run apt install (requires elevated privileges). These behaviors are reasonable for speaker control, but installing packages and changing default sinks are privileged actions — the user should expect install prompts and confirm before allowing them.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install roomsound
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /roomsound 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.5
**Summary:** This version improves playback queue logic and introduces input sanitisation for safer command execution. - Added input sanitisation before running any shell commands to prevent command injection. - Enhanced YouTube search output to include track duration, improving user selection and queue management. - Introduced queue-first playback: user requests now build an audio queue by default unless an explicit list/order is given.
v0.1.3
- Removed bluetoothctl trust <MAC>
v0.1.1
- Now describes YouTube search-to-play as a two-step approach: first get the audio stream URL, then play it with mpv. - Reducing vulnerability surface
v0.1.0
Initial release of RoomSound — home audio control for agents: - Enables speaker discovery, switching, and YouTube audio playback through simple commands. - Supports Bluetooth speaker management using aliases for easy device switching. - Handles YouTube search/playback via `yt-dlp` and `mpv` with natural-language prompts for ambiguous actions. - Automatically installs and verifies required dependencies on first use. - Provides clear user feedback and confirmation before changing audio outputs. - Summarizes current speakers and sinks for quick device status checks.
元数据
Slug roomsound
版本 0.1.5
许可证
累计安装 0
当前安装数 0
历史版本数 4
常见问题

RoomSound 是什么?

RoomSound gives your agent the skill to play audio to your speakers. Starting with YouTube to Bluetooth speakers, expanding to local files and other sources. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 555 次。

如何安装 RoomSound?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install roomsound」即可一键安装,无需额外配置。

RoomSound 是免费的吗?

是的,RoomSound 完全免费(开源免费),可自由下载、安装和使用。

RoomSound 支持哪些平台?

RoomSound 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 RoomSound?

由 icecat2005(@icecat2005)开发并维护,当前版本 v0.1.5。

💬 留言讨论