pi-speaker

Installation
SKILL.md

Pi speaker (local audio output)

Play text-to-speech or an audio file on the gateway host default audio output. Typical use: OpenClaw gateway on a Raspberry Pi with a Bluetooth speaker set as default sink; you ask for an announcement, alarm, or news summary and want to hear it on that speaker.

When to use

  • User asks to "play X on the Pi speaker," "announce X," "alarm at ... with message Y," or "give me a news summary and play it on the speaker."
  • Gateway is running on the Pi (or another host with local audio); default sink is already set (e.g. Bluetooth speaker). See Raspberry Pi audio for setup.

Quick procedure (do this in two tool calls)

There is no openclaw skill pi-speaker CLI. Use tts then exec only.

  1. Call the tts tool with the announcement text. Keep announcement text short (e.g. one sentence) to avoid long TTS generation and request timeouts.
  2. From the tool result, get the audio file path (e.g. details.audioPath or content like MEDIA:/path/to/file). Strip any MEDIA: prefix to get the real path on the host.
  3. Call the exec tool with exactly one of: pw-play <path>, paplay <path>, or $HOME/bin/openclaw-speaker-play.sh <path>. Do not invent a CLI like openclaw skill pi-speaker --text "..."; there is no such command.

Only after exec returns success (exit 0), tell the user the phrase was played on the Pi speaker.

Installs
1
First Seen
Apr 23, 2026