omi

# Omi Integration

Sync and manage recordings from Omi AI wearables (Omi, Limitless pendant, etc.).

## Features

- Auto-sync recordings from Omi backend
- Webhook support for real-time transcripts
- Multi-device support (tag by device)
- Local storage with metadata
- Summary and action item extraction

## Setup

1. Get your Omi API key from https://omi.me/developer or your self-hosted backend
2. Store it securely:
```bash
mkdir -p ~/.config/omi
echo "YOUR_API_KEY" > ~/.config/omi/api_key
chmod 600 ~/.config/omi/api_key
```

3. Configure backend URL (defaults to https://api.omi.me):
```bash
echo "https://api.omi.me" > ~/.config/omi/backend_url
# Or for self-hosted:
echo "https://your-backend.com" > ~/.config/omi/backend_url
```

## Usage

### Sync All Recordings
```bash
omi-sync
```

### Sync Recent (Last 7 Days)
```bash
omi-sync --days 7
```

### List Recordings
```bash
omi-list
```

### Get Recording Details
```bash
omi-get <recording-id>
```

### Process Webhook Payload
```bash
cat webhook-payload.json | omi-webhook-handler
```

## Storage

Recordings are stored in:
```
~/omi_recordings/
├── YYYY-MM-DD/
│   ├── <recording-id>/
│   │   ├── metadata.json
│   │   ├── transcript.txt
│   │   ├── audio.wav (if available)
│   │   └── summary.md
└── index.json
```

## Webhook Setup

Configure your Omi app to send webhooks to your endpoint:
1. Open Omi app → Settings → Developer
2. Create new webhook
3. Enter your webhook URL
4. Select events: `recording.created`, `transcript.updated`

The skill includes a handler (`omi-webhook-handler`) that processes real-time events.

## Multi-Device Support

Recordings are automatically tagged by device:
```json
{
  "recording_id": "rec_123",
  "device_id": "limitless-001",
  "device_name": "Limitless Pendant",
  "device_type": "wearable",
  "context": "work",
  "transcript": "Meeting notes...",
  "created_at": "2026-02-02T15:38:00Z"
}
```

## API Endpoints

Base URL: `https://api.omi.me/v1` (configurable)

- `GET /recordings` - List...

# Omi Integration for Clawdbot

Auto-sync and manage recordings from Omi AI wearables (Omi, Limitless pendant, etc.)

## ✅ Task 1: Omi Integration Skill - COMPLETE

**Status:** Ready to use!

### What's Included

1. **`omi-sync.sh`** - Sync recordings from Omi API
2. **`omi-webhook-handler.sh`** - Process real-time webhook events
3. **`omi-list.sh`** - List and preview recordings
4. **`SKILL.md`** - Full documentation

### Quick Start

**Step 1: Get your Omi API key**
- Go to https://omi.me/developer (or your self-hosted backend)
- Create API key
- Store it:
```bash
mkdir -p ~/.config/omi
echo "YOUR_API_KEY" > ~/.config/omi/api_key
chmod 600 ~/.config/omi/api_key
```

**Step 2: Sync your recordings**
```bash
cd /home/doc/clawd-opencode/omi-integration
./omi-sync.sh --days 7
```

**Step 3: View recordings**
```bash
./omi-list.sh --days 7
```

### Storage Location

All recordings are stored in:
```
~/omi_recordings/
├── 2026-02-02/
│   ├── rec_abc123/
│   │   ├── metadata.json
│   │   ├── transcript.txt
│   │   └── summary.md
└── index.json
```

### Features

✅ **Multi-device support** - Works with Omi, Limitless, and other compatible wearables
✅ **Real-time sync** - Webhook support for instant transcripts
✅ **Local storage** - All data stored privately on your machine
✅ **Metadata rich** - Device info, timestamps, summaries
✅ **Easy to use** - Simple bash scripts, no dependencies beyond curl/jq

## ✅ Task 2: Webhook Endpoint Setup - COMPLETE

**Status:** Ready to deploy!

### What's Included

1. **`webhook-server.py`** - Python HTTP server for receiving Omi webhooks
2. **`start-webhook-server.sh`** - Start the webhook server
3. **`stop-webhook-server.sh`** - Stop the webhook server
4. **`setup-ngrok.sh`** - Expose webhook to internet via ngrok

### Quick Start (Webhook)

**Step 1: Start the webhook server**
```bash
./start-webhook-server.sh
```

**Step 2: Expose to internet with ngrok**
```bash
./setup-ngrok.sh
```

**Step 3: Configure in Omi app**
- Open Omi...