# Send Percept Listen 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": "percept-listen",
    "name": "Percept Listen",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/jarvis563/percept-listen",
    "canonicalUrl": "https://clawhub.ai/jarvis563/percept-listen",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/percept-listen",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=percept-listen",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "percept-listen",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T00:41:18.839Z",
      "expiresAt": "2026-05-14T00:41:18.839Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=percept-listen",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=percept-listen",
        "contentDisposition": "attachment; filename=\"percept-listen-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "percept-listen"
      },
      "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/percept-listen"
    },
    "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/percept-listen",
    "downloadUrl": "https://openagent3.xyz/downloads/percept-listen",
    "agentUrl": "https://openagent3.xyz/skills/percept-listen/agent",
    "manifestUrl": "https://openagent3.xyz/skills/percept-listen/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/percept-listen/agent.md"
  }
}
```
## Documentation

### 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://<your-tunnel>/webhook/transcript

### Setup

# 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jarvis563
- Version: 1.0.0
## 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-07T00:41:18.839Z
- Expires at: 2026-05-14T00:41:18.839Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/percept-listen)
- [Send to Agent page](https://openagent3.xyz/skills/percept-listen/agent)
- [JSON manifest](https://openagent3.xyz/skills/percept-listen/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/percept-listen/agent.md)
- [Download page](https://openagent3.xyz/downloads/percept-listen)