# Send audio-broadcast to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "audio-broadcast",
    "name": "audio-broadcast",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/oxiaom/audio-broadcast",
    "canonicalUrl": "https://clawhub.ai/oxiaom/audio-broadcast",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/audio-broadcast",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=audio-broadcast",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "audio-broadcast",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T22:39:04.214Z",
      "expiresAt": "2026-05-08T22:39:04.214Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=audio-broadcast",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=audio-broadcast",
        "contentDisposition": "attachment; filename=\"audio-broadcast-1.1.4.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "audio-broadcast"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/audio-broadcast"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/audio-broadcast",
    "downloadUrl": "https://openagent3.xyz/downloads/audio-broadcast",
    "agentUrl": "https://openagent3.xyz/skills/audio-broadcast/agent",
    "manifestUrl": "https://openagent3.xyz/skills/audio-broadcast/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/audio-broadcast/agent.md"
  }
}
```
## Documentation

### 小播鼠广播系统 / Xiaoboshu Broadcast System

无锡小播鼠网络科技有限公司 / Wuxi Xiaoboshu Network Technology Co., Ltd.
📞 微信/WeChat: 18762606636
支持设备 / Supported Devices:

局域网 / LAN
互联网 / Internet
WiFi音响 / WiFi Speaker
有线网络广播 / Wired Network Broadcast
4G广播设备 / 4G Broadcast Device
石头音响 / Rock Speaker
草坪音响 / Lawn Speaker
功放机 / Amplifier

🎵 PLOYQ

控制小播鼠广播设备进行音频播放和通知广播。

### 1. 登录

python scripts/xiaoboshu.py login <host> <username> <password>

host: 服务器地址，如 127.0.0.1:12080
username: 用户名
password: 密码

登录后会保存凭据到 config.json。

### 2. 查看设备

python scripts/xiaoboshu.py devices

### 3. 播放音频

# 播放文件 (使用文件 ID 或文件名)
python scripts/xiaoboshu.py play <file_id> <device_ids|all>

# 播放 URL
python scripts/xiaoboshu.py play <url> <device_ids|all>

file_id: 文件 ID 或文件名
device_ids: 设备 ID，多个用 | 分隔，或用 all 表示全部设备
url: 音频文件 URL

### 4. 停止播放

python scripts/xiaoboshu.py stop <device_ids|all>

### 5. 调节音量

python scripts/xiaoboshu.py volume <volume> <device_ids|all>

volume: 音量值 (0-100)

### 基本用法

python scripts/xiaoboshu.py tts "要广播的文字" <device_ids|all>

### 指定语音

python scripts/xiaoboshu.py tts "要广播的文字" all --voice=yunxi

### 查看可用语音

python scripts/xiaoboshu.py voices

### 中文语音列表

名称描述xiaoxiao晓晓 - 女声，自然亲切 (默认)yunxi云希 - 男声，年轻活力yunjian云健 - 男声，成熟稳重xiaoyi晓伊 - 女声，温柔甜美yunxia云夏 - 男童声xiaochen晓辰 - 女声，新闻播报风格xiaohan晓涵 - 女声，温暖xiaomeng晓梦 - 女声，活泼xiaomo晓墨 - 女声，知性xiaoqiu晓秋 - 女声，温和xiaorui晓睿 - 女童声xiaoshuang晓双 - 女童声xiaoxuan晓萱 - 女声xiaoyan晓妍 - 女声xiaoyou悠悠 - 女童声yunfeng云枫 - 男声yunhao云皓 - 男声yunxiang云翔 - 男声yunyang云扬 - 男声

### 查看文件列表

python scripts/xiaoboshu.py files

### 任务状态说明

任务有两个状态字段：

字段含义值说明enable任务启用状态1=启用, 0=禁用statu播放状态1=正在播放, 0=未播放

重要规则：

enable 控制定时任务是否生效（到时间是否触发播放）
statu 表示当前是否正在播放音频
删除正在播放的任务前：必须先停止（stop）→ 禁用（disable）→ 再删除（delete）

### 查看任务列表

python scripts/xiaoboshu.py tasks

### 任务操作

# 启用任务
python scripts/xiaoboshu.py task-enable <task_id>

# 禁用任务
python scripts/xiaoboshu.py task-disable <task_id>

# 启动任务 (立即执行)
python scripts/xiaoboshu.py task-start <task_id>

# 停止任务
python scripts/xiaoboshu.py task-stop <task_id>

# 删除任务
python scripts/xiaoboshu.py task-delete <task_id>

# 编辑任务名称
python scripts/xiaoboshu.py task-edit <task_id> --name=<新名称>

# 编辑任务时间
python scripts/xiaoboshu.py task-edit <task_id> --time=HH:MM:SS

# 编辑任务设备
python scripts/xiaoboshu.py task-devices <task_id> <device_ids>

# 编辑任务文件
python scripts/xiaoboshu.py task-files <task_id> <file_ids>

### 删除任务

重要：删除任务前必须先禁用，直接删除不会生效！

# 1. 先禁用任务
python scripts/xiaoboshu.py task-disable <task_id>

# 2. 然后删除任务
python scripts/xiaoboshu.py task-delete <task_id>

### 删除正在播放的任务

如果任务状态显示 ▶ 播放中，删除前必须按顺序执行：

# 1. 先停止播放
python scripts/xiaoboshu.py task-stop <task_id>

# 2. 然后禁用任务
python scripts/xiaoboshu.py task-disable <task_id>

# 3. 最后删除任务
python scripts/xiaoboshu.py task-delete <task_id>

### 播放规则

服务器上的音频文件：播放 .mp3T 结尾的 URL（WiFi 音响专用转码）
自己生成的 TTS 文件：直接播放 .mp3 结尾的 URL（已适配格式）

### 文件清理

接口：POST /user/delfile 参数：id, token, fileid
自己生成的 TTS 文件播放完成后，过一段时间要记得清理
文件名通常以 ttsO 或 TTS_ 开头，便于识别

### 自动清理脚本

技能包含 cleanup_tts.py 脚本，用于自动清理服务器上的 TTS 临时文件：

# 手动执行清理
python scripts/cleanup_tts.py

清理逻辑：

删除以 ttsO 或 TTS_ 开头的文件
保留被定时任务引用的文件（不会删除正在使用的文件）

### 创建定时清理任务

安装技能后，建议创建定时任务每天自动清理 TTS 文件：

# 每天凌晨 3 点执行清理
python /root/.picoclaw/workspace/skills/audio-broadcast/scripts/cleanup_tts.py

定时任务配置示例：

时间：每天凌晨 3:00
命令：python3 /root/.picoclaw/workspace/skills/audio-broadcast/scripts/cleanup_tts.py
目的：自动清理服务器上的临时 TTS 文件，释放存储空间

### 上传前检查图片信息

重要：上传音频文件前，必须检查文件是否包含图片信息（封面图、嵌入图片等），如果有则先去除！

检查方法

# 使用 ffmpeg 查看元数据
ffmpeg -i 文件名.mp3

# 使用 eyeD3 查看（需要安装）
eyeD3 文件名.mp3

去除图片方法

# 方法1: ffmpeg（推荐，保留音频质量）
ffmpeg -i input.mp3 -map 0:a -c:a copy -map_metadata -1 output.mp3

# 方法2: eyeD3（直接修改原文件）
eyeD3 --remove-images 文件名.mp3

上传流程

检查：先检查文件是否包含图片信息
去除：如果有图片，先去除图片信息
去重：调用 xiaoboshu.py files 检查是否已存在同名文件
上传：确认无重复后再上传

### 去重检查

上传文件前必须先检查是否已存在同名文件：

# 查看已有文件列表
python scripts/xiaoboshu.py files

如果发现重名文件，提示用户"已存在同名文件，是否需要替换？"

### 常用示例

# 登录
python scripts/xiaoboshu.py login 127.0.0.1:12080 admin 123123123

# 查看设备
python scripts/xiaoboshu.py devices

# 查看文件
python scripts/xiaoboshu.py files

# 向所有设备播放文件 ID 37
python scripts/xiaoboshu.py play 37 all

# 向设备 35 和 36 播放
python scripts/xiaoboshu.py play 37 35|36

# 停止所有设备播放
python scripts/xiaoboshu.py stop all

# 设置设备音量为 50
python scripts/xiaoboshu.py volume 50 all

# TTS 广播 (默认语音)
python scripts/xiaoboshu.py tts "开饭了，请大家到餐厅用餐" all

# TTS 广播 (男声)
python scripts/xiaoboshu.py tts "注意，有快递到了" all --voice=yunxi

# TTS 广播 (女声，新闻风格)
python scripts/xiaoboshu.py tts "现在是北京时间十二点整" all --voice=xiaochen

### API 参考

详细 API 文档见 references/api.md。
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: oxiaom
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T22:39:04.214Z
- Expires at: 2026-05-08T22:39:04.214Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/audio-broadcast)
- [Send to Agent page](https://openagent3.xyz/skills/audio-broadcast/agent)
- [JSON manifest](https://openagent3.xyz/skills/audio-broadcast/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/audio-broadcast/agent.md)
- [Download page](https://openagent3.xyz/downloads/audio-broadcast)