timeless
Query and manage Timeless meetings, rooms, transcripts, and AI documents. Capture podcast episodes and YouTube videos into Timeless for transcription. Use when the user asks about their meetings, wants to search meetings, read transcripts, get summaries, list rooms, create rooms, add/remove conversations from rooms, resolve Timeless share links, upload recordings, chat with Timeless AI about meeting content, or capture podcasts/YouTube videos.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/eilonmore/timelessTimeless
Interact with Timeless meeting data: search meetings, read transcripts, get AI summaries, browse rooms, upload recordings, chat with the AI agent, and capture podcasts/YouTube videos for transcription.
API Reference
For full endpoint documentation with response schemas, status enums, and detailed examples, read api-reference.md (in this skill folder).
Prerequisites
TIMELESS_ACCESS_TOKENenv var (get token at my.timeless.day/api-token)yt-dlpfor YouTube downloads (install via package manager:apt install yt-dlp,brew install yt-dlp, orpip install yt-dlp. Alternatively setYTDLP_PATHto point to an existing binary.)
Set up in OpenClaw:
openclaw config patch env.vars.TIMELESS_ACCESS_TOKEN=<your_token>
Base URL
https://my.timeless.day
Authentication Header
All requests:
Authorization: Token $TIMELESS_ACCESS_TOKEN
Operations
1. List Meetings
GET /api/v1/spaces/meeting/
Required parameter: include must be owned or shared.
| Parameter | Type | Description |
|---|---|---|
include | string | Required. owned or shared |
search | string | Search by title or attendees |
start_date | string | From date (YYYY-MM-DD) |
end_date | string | To date (YYYY-MM-DD) |
status | string | COMPLETED, SCHEDULED, PROCESSING, FAILED |
page | integer | Page number (default: 1) |
per_page | integer | Results per page (default: 20) |
curl -s "https://my.timeless.day/api/v1/spaces/meeting/?include=owned&status=COMPLETED&per_page=50" \
-H "Authorization: Token $TIMELESS_ACCESS_TOKEN"
Response: { count, next, previous, results: [{ uuid, title, start_ts, end_ts, status, primary_conversation_uuid, host_user, conversation_source, created_at }] }
Key fields:
uuid= space UUID (for Get Space)primary_conversation_uuid= conversation UUID (for Get Transcript)
To get ALL meetings, make two calls:
include=ownedandinclude=shared, then merge.
2. List Rooms
GET /api/v1/spaces/room/
Same query parameters as List Meetings (except rooms don't have start_ts, end_ts, or status).
curl -s "https://my.timeless.day/api/v1/spaces/room/?include=owned" \
-H "Authorization: Token $TIMELESS_ACCESS_TOKEN"
Response: { count, next, previous, results: [{ uuid, title, host_user, created_at }] }
3. Get Space (Meeting or Room Details)
Spaces have three access levels. Try in order until one succeeds:
3a. Private Space (your own)
curl -s "https://my.timeless.day/api/v1/spaces/{uuid}/" \
-H "Authorization: Token $TIMELESS_ACCESS_TOKEN"
3b. Workspace Space (shared within team)
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-eilonmore-timeless": {
"enabled": true,
"auto_update": true
}
}
}