🦞 Give OpenClaw superpowered memory with one command
Install Skill
All Integrations

OpenAI

The AI Engine Behind Onelist

OpenAI powers multiple Onelist agents with GPT models for content analysis, embeddings for semantic search, vision for image understanding, and Whisper for audio transcription.

4
Model Types
1536
Embedding Dimensions
~$0.15
Per 1M Input Tokens
99
Languages Supported
# Configure in your environment
export OPENAI_API_KEY=sk-...

GPT Models

Reader Agent - Content Analysis & Memory Extraction

The Reader agent uses GPT-4o-mini to extract atomic memories from content, suggest tags, generate summaries, and classify relationships between memories.

Capabilities

  • Memory Extraction: Extract atomic facts with confidence scoring
  • Tag Suggestions: Intelligent tagging with preference for existing tags
  • Summarization: Concise, detailed, or bullet-point summaries
  • Relationship Classification: Supersedes, refines, or unrelated
  • Entity Extraction: People, places, organizations, dates

Configuration

Model
gpt-4o-mini
Temperature
0.3 (deterministic)
Timeout
60 seconds
Response Format
JSON mode
# Memory extraction example output
{
  "memories": [
    {
      "content": "User prefers PostgreSQL for JSONB support",
      "confidence": 0.95,
      "memory_type": "preference",
      "entities": {
        "technologies": ["PostgreSQL", "JSONB"]
      }
    }
  ],
  "token_usage": {"input": 156, "output": 89},
  "cost_cents": 0.0077
}

Embeddings

Searcher Agent - Semantic Search

The Searcher agent uses text-embedding-3-small to generate 1536-dimensional vectors for semantic search. Find content by meaning, not just keywords.

Features

  • Single Embedding: Generate vector for any text
  • Batch Processing: Up to 2048 texts per request
  • Automatic Chunking: 100-item batches for reliability
  • pgvector Compatible: Store in PostgreSQL

Specifications

Model text-embedding-3-small
Dimensions 1536
Max Batch Size 2048 texts
Version 2024-01

How Semantic Search Works

When you search for "authentication problems", the Searcher finds entries about "login issues", "JWT errors", and "session expiry" because the vector representations capture semantic similarity, not just keyword matches.

Vision

Asset Enrichment Agent - Image Understanding

The Asset Enrichment agent uses GPT-4o to analyze images, generate descriptions, and extract text through OCR. Make your image library searchable.

Image Description

Generates detailed descriptions including:

  • - Main subject and objects
  • - People and their actions
  • - Setting and background
  • - Visible text elements
  • - Colors, mood, visual style
Max tokens: 500

Text Extraction (OCR)

Extracts text from:

  • - Documents and PDFs
  • - Screenshots and UI
  • - Signs and labels
  • - Handwritten notes
  • - Structured tables
Max tokens: 1000

Supported Formats

.jpg .jpeg .png .gif .webp

Whisper

Asset Enrichment Agent - Audio Transcription

Whisper transcribes audio files with automatic language detection and segment-level timing. Perfect for podcasts, voice memos, and meeting recordings.

Features

  • Auto Language Detection: 99+ languages
  • Segment Timing: Start/end times for each segment
  • Long Audio: 5 minute timeout for large files
  • Searchable: Transcripts indexed for search

Output Format

{
  "text": "Full transcription...",
  "language": "en",
  "duration": 145.5,
  "segments": [
    {
      "id": 0,
      "start": 0.0,
      "end": 4.2,
      "text": "Hello and welcome..."
    }
  ]
}

Pricing

Pay-as-you-go pricing. All costs tracked per request.

Service Model Input Cost Output Cost
GPT (Reader) gpt-4o-mini $0.15 / 1M tokens $0.60 / 1M tokens
Embeddings (Searcher) text-embedding-3-small $0.02 / 1M tokens -
Vision gpt-4o-mini ~$0.005-0.02 / image
Whisper whisper-1 $0.006 / minute

Cost Tracking

Onelist tracks token usage and calculates costs for every API call. Monitor your spending in real-time through the dashboard or API responses.

Quick Setup

1

Get an API Key

Create an account at platform.openai.com and generate an API key.

2

Configure Onelist

# Add to your .env file
OPENAI_API_KEY=sk-...
3

Restart Onelist

docker-compose restart

Power Your Knowledge Base with OpenAI

Self-host Onelist with Docker and connect your OpenAI API key.