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
- Store it securely:
CODEBLOCK0
- 3. Configure backend URL (defaults to https://api.omi.me):
CODEBLOCK1
Usage
Sync All Recordings
CODEBLOCK2
Sync Recent (Last 7 Days)
CODEBLOCK3
List Recordings
CODEBLOCK4
Get Recording Details
CODEBLOCK5
Process Webhook Payload
CODEBLOCK6
Storage
Recordings are stored in:
CODEBLOCK7
Webhook Setup
Configure your Omi app to send webhooks to your endpoint:
- 1. Open Omi app → Settings → Developer
- Create new webhook
- Enter your webhook URL
- Select events:
recording.created, INLINECODE1
The skill includes a handler (omi-webhook-handler) that processes real-time events.
Multi-Device Support
Recordings are automatically tagged by device:
CODEBLOCK8
API Endpoints
Base URL: https://api.omi.me/v1 (configurable)
- -
GET /recordings - List all recordings - INLINECODE5 - Get recording details
- INLINECODE6 - Get transcript
- INLINECODE7 - Get AI summary
- INLINECODE8 - Register webhook endpoint
Privacy
- - All data stored locally
- API key encrypted at rest
- Self-hosted backend supported
- No telemetry or tracking
- Webhook payloads logged for debugging (optional)
Cron Setup
Auto-sync every hour:
CODEBLOCK9
Or use Clawdbot cron for integrated scheduling.
Omi 集成
同步并管理来自 Omi AI 可穿戴设备（Omi、Limitless 挂坠等）的录音。
功能特性
- - 从 Omi 后端自动同步录音
- 支持 Webhook 实时获取转录文本
- 多设备支持（按设备标记）
- 本地存储并附带元数据
- 摘要和行动项提取
设置
- 1. 从 https://omi.me/developer 或自托管后端获取 Omi API 密钥
- 安全存储密钥：
bash
mkdir -p ~/.config/omi
echo 你的API密钥 > ~/.config/omi/api_key
chmod 600 ~/.config/omi/api_key
- 3. 配置后端 URL（默认为 https://api.omi.me）：
bash
echo https://api.omi.me > ~/.config/omi/backend_url
或自托管：
echo https://你的后端.com > ~/.config/omi/backend_url
使用方法
同步所有录音
bash
omi-sync
同步近期录音（最近7天）
bash
omi-sync --days 7
列出录音
bash
omi-list
获取录音详情
bash
omi-get <录音ID>
处理 Webhook 负载
bash
cat webhook-payload.json | omi-webhook-handler
存储
录音存储在：
~/omi_recordings/
├── YYYY-MM-DD/
│ ├── <录音ID>/
│ │ ├── metadata.json
│ │ ├── transcript.txt
│ │ ├── audio.wav（如有）
│ │ └── summary.md
└── index.json
Webhook 设置
配置 Omi 应用将 Webhook 发送到你的端点：
- 1. 打开 Omi 应用 → 设置 → 开发者
- 创建新的 Webhook
- 输入你的 Webhook URL
- 选择事件：recording.created、transcript.updated
该技能包含一个处理实时事件的处理器（omi-webhook-handler）。
多设备支持
录音会自动按设备标记：
json
{
recordingid: rec123,
device_id: limitless-001,
device_name: Limitless 挂坠,
device_type: 可穿戴设备,
context: 工作,
transcript: 会议记录...,
created_at: 2026-02-02T15:38:00Z
}
API 端点
基础 URL：https://api.omi.me/v1（可配置）
- - GET /recordings - 列出所有录音
- GET /recordings/:id - 获取录音详情
- GET /recordings/:id/transcript - 获取转录文本
- GET /recordings/:id/summary - 获取 AI 摘要
- POST /webhooks/register - 注册 Webhook 端点
隐私保护
- - 所有数据本地存储
- API 密钥静态加密
- 支持自托管后端
- 无遥测或追踪
- Webhook 负载可记录用于调试（可选）
Cron 定时任务设置
每小时自动同步：
bash
0 /path/to/omi-sync --days 1 >> ~/.local/share/omi/sync.log 2>&1
或使用 Clawdbot cron 进行集成调度。
