A robust tool for capturing, transcribing, and summarizing live or archived X/Twitter Spaces using advanced AI models.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install spaces-listener
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install spaces-listener using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is spaces-listener?
The spaces-listener skill provides a seamless way to archive and analyze audio content from X/Twitter. By leveraging yt-dlp for high-quality recording and OpenAI Whisper for local transcription, this skill allows users to convert long-form audio into searchable text and concise summaries. It is designed to run in the background as part of your Openclaw Skills library, making it ideal for monitoring multiple concurrent events without interrupting your primary developer workflow.
This skill automates the entire lifecycle of audio content management, from the initial stream capture to the final AI-generated summary. It ensures that valuable insights shared in ephemeral social audio spaces are preserved and made accessible for research, content creation, or record-keeping.
spaces-listener Use Cases
- Archive live X/Twitter Spaces for later reference or regulatory compliance.
- Generate searchable text transcripts of industry discussions for deep research.
- Produce AI-powered summaries of multi-hour audio sessions to quickly extract key takeaways.
- Monitor and record multiple concurrent X Spaces simultaneously using managed background processes.
How spaces-listener Works
- Initialize a recording by providing a Space URL, which triggers a background process assigned a unique ID.
- Monitor the recording status through CLI commands to verify connectivity and progress.
- Upon completion, the audio file is automatically transferred from a temporary staging area to a dedicated output directory.
- Execute transcription using preferred Whisper models, choosing between speed and high-fidelity accuracy.
- Generate an AI-driven summary from the resulting transcript to highlight speakers and important discussion points.
spaces-listener Setup
To get started with this component of your Openclaw Skills, install the necessary system dependencies via Homebrew:
brew install yt-dlp ffmpeg openai-whisper
To enable the AI summarization feature, ensure your OPENAI_API_KEY is configured in your environment variables. Transcription will remain functional even without an API key using local Whisper models.
spaces-listener Data Schema & Taxonomy
The skill organizes all output into structured subdirectories located at ~/Dropbox/ClawdBox/XSpaces/ for easy synchronization and access.
| File | Description |
|---|---|
| recording.m4a | The raw audio file captured from the X/Twitter Space. |
| recording.log | Detailed progress logs tracking the download and recording session. |
| transcript.txt | The full text transcription generated by the Whisper model. |
| summary.txt | The AI-generated summary capturing the essence of the conversation. |
spaces-listener Advanced Features
- Support for concurrent background recordings with dedicated ID management.
- Multi-model Whisper integration allowing selection between tiny, base, small, medium, and large models.
- Automated staging in a local temporary directory to prevent file-syncing locks during long recordings.
- Built-in status tracking and cleanup tools for managing active and stale recording processes.
- Optimized for agentic workflows using cron jobs to poll recording status and trigger post-processing.
SKILL.md
Loading
Related Openclaw Skills
Konteks
A persistent context layer that connects your AI agent to Konteks for shared memory, task management, and project organization.
Grab
A multi-platform content downloader and archiver that preserves videos, transcripts, and AI-generated summaries from social media.
fastclaw-relay
Bridges your local OpenClaw Gateway to the FastClaw iOS app via Convex real-time cloud synchronization.
Context - Location Analysis
A powerful location intelligence skill that provides deep situational awareness, including nearby venues, area descriptions, and weather data.
Stranger-Danger
A challenge-response identity verification skill that adds a human-in-the-loop security layer before your AI agent performs sensitive operations.
AHC-Automator: Alan Harper Composites Workflow Automation
A specialized automation suite that synchronizes email communication, ClickUp project management, and Pipedrive CRM for composite manufacturing workflows.
METADATA
Featured*
