✓ Verified 💻 Development ✓ Enhanced Data

Percept Listen

Ambient audio capture and transcription for OpenClaw agents via wearable devices.

Rating
4.9 (387 reviews)
Downloads
7,181 downloads
Version
1.0.0

Overview

Ambient audio capture and transcription for OpenClaw agents via wearable devices.

Complete Documentation

View Source →

percept-listen

Ambient audio capture and transcription for OpenClaw agents via wearable devices.

What it does

Connects a wearable microphone (Omi pendant or Apple Watch) to your OpenClaw agent. Audio is transcribed locally and streamed as structured conversation data — speaker-tagged, timestamped, and searchable.

When to use

  • User wants their agent to hear ambient conversations
  • User asks to "start listening" or "turn on the mic"
  • User mentions Omi pendant, wearable, or ambient audio

Requirements

  • Percept server running locally (pip install getpercept && percept start)
  • Omi pendant paired via phone, OR Apple Watch with Percept app
  • Webhook configured: Omi app → Settings → Webhooks → https:///webhook/transcript

Setup

bash
# Install Percept
pip install getpercept

# Start the receiver (default port 8900)
percept start

# Or run directly
PYTHONPATH=. python -m uvicorn src.receiver:app --host 0.0.0.0 --port 8900

Configure a tunnel (Cloudflare, ngrok, Tailscale) so Omi can reach your local server.

How it works

  • Omi pendant captures audio → phone does STT → sends transcript segments via webhook
  • Percept receiver processes segments into conversations
  • Conversations are stored in local SQLite with FTS5 full-text search
  • All processing stays local — no audio leaves your machine

Data locations

  • SQLite DB: percept/data/percept.db
  • Live transcript: /tmp/percept-live.txt
  • Conversations: percept/data/conversations/

Configuration

Wake words, speaker names, and all settings are managed via the Percept dashboard (port 8960) or directly in the SQLite database.

Links

  • GitHub: https://github.com/GetPercept/percept
  • Docs: https://github.com/GetPercept/percept/docs

Installation

Terminal bash

openclaw install percept-listen
    
Copied!

💻Code Examples

example.sh
# Install Percept
pip install getpercept

# Start the receiver (default port 8900)
percept start

# Or run directly
PYTHONPATH=. python -m uvicorn src.receiver:app --host 0.0.0.0 --port 8900

Tags

#coding_agents-and-ides #script

Quick Info

Category Development
Model Claude 3.5
Complexity Multi-Agent
Author jarvis563
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install percept-listen