OpenAI Plugin

The OpenAI plugin provides access to GPT models and supports all model types: text generation, embeddings, and object generation.

​

Features

• Full model support - Text, embeddings, and objects
• Multiple models - GPT-4, GPT-3.5, and embedding models
• Streaming support - Real-time response generation
• Function calling - Structured output generation

​

Installation

elizaos plugins add @elizaos/plugin-openai

​

Configuration

​

Environment Variables

# Required
OPENAI_API_KEY=sk-...

# Optional model configuration
# You can use any available OpenAI model
OPENAI_SMALL_MODEL=gpt-4o-mini        # Default: gpt-4o-mini
OPENAI_LARGE_MODEL=gpt-4o             # Default: gpt-4o
OPENAI_EMBEDDING_MODEL=text-embedding-3-small  # Default: text-embedding-3-small

# Examples of other available models:
# OPENAI_SMALL_MODEL=gpt-3.5-turbo
# OPENAI_LARGE_MODEL=gpt-4-turbo
# OPENAI_LARGE_MODEL=gpt-4o-2024-11-20
# OPENAI_EMBEDDING_MODEL=text-embedding-3-large
# OPENAI_EMBEDDING_MODEL=text-embedding-ada-002

​

Character Configuration

{
  "name": "MyAgent",
  "plugins": ["@elizaos/plugin-openai"],
  "settings": {
    "secrets": {
      "OPENAI_API_KEY": "sk-..."
    }
  }
}

​

Supported Operations

​

Model Configuration

The plugin uses two model categories:

• SMALL_MODEL: Used for simpler tasks, faster responses
• LARGE_MODEL: Used for complex reasoning, better quality

You can configure any available OpenAI model in these slots based on your needs and budget.

​

Usage Example

The plugin automatically registers with the runtime:

// No manual initialization needed
// Just include in plugins array

​

Cost Considerations

• GPT-4 is more expensive than GPT-3.5
• Use text-embedding-3-small for cheaper embeddings
• Monitor usage via OpenAI dashboard

​

External Resources

• Plugin Source
• OpenAI API Documentation
• Pricing