Frequently Asked Questions
What is Eliza?
Eliza is an extensible open-source framework for building autonomous AI agents that can engage in natural conversations, learn from interactions, and maintain consistent personalities across platforms like Twitter, Discord, and Telegram.
What's the difference between v1 and v2?
V2 is a major upgrade that makes Eliza more powerful and easier to use. The main changes are:
- Plugin store for easy extensions
- Unified messaging across platforms
- One wallet for all blockchains
- Smarter, learning characters
- Better planning capabilities
For a detailed comparison, see our V2 announcement blog post.
Installation and Setup
What are the system requirements for running Eliza?
- Node.js version 23+ (specifically 23.3.0 is recommended)
- At least 4GB RAM
- For Windows users: WSL2 (Windows Subsystem for Linux)
How do I fix common installation issues?
If you encounter build failures or dependency errors:
- Ensure you're using Node.js v23.3.0:
nvm install 23.3.0 && nvm use 23.3.0
- Clean your environment:
bun clean
- Install dependencies:
bun install --no-frozen-lockfile
- Rebuild:
bun build
- If issues persist, try checking out the latest release:
git checkout $(git describe --tags --abbrev=0)
How do I use local models with Eliza?
Use Ollama for local models. Install Ollama, download the desired model (e.g., llama3.1
), set modelProvider
to "ollama"
in the character file, and configure OLLAMA
settings in .env
.
How do I update Eliza to the latest version?
For CLI projects:
npm update -g @elizaos/cli
For monorepo development:
git pull
bun clean
bun install --no-frozen-lockfile
bun build
Running Multiple Agents
npx @elizaos/cli@beta start --characters="characters/agent1.json,characters/agent2.json"
- Create separate projects for each agent with their own configurations
- For production, use separate Docker containers for each agent
Can I run multiple agents on one machine?
Yes, but consider:
- Each agent needs its own port configuration
- Separate the .env files or use character-specific secrets
- Monitor memory usage (2-4GB RAM per agent recommended)
Twitter/X Integration
How do I prevent my agent from spamming or posting duplicates?
Configure your .env file:
ENABLE_ACTION_PROCESSING=false
POST_INTERVAL_MIN=900 # 15 minutes minimum
POST_INTERVAL_MAX=1200 # 20 minutes maximum
TWITTER_DRY_RUN=true # Test mode
How do I control which tweets my agent responds to?
- Configure target users in .env:
TWITTER_TARGET_USERS="user1,user2,user3"
- Control specific actions:
TWITTER_LIKES_ENABLE=false
TWITTER_RETWEETS_ENABLE=false
TWITTER_REPLY_ENABLE=true
TWITTER_FOLLOW_ENABLE=false
How do I fix Twitter authentication issues?
- Mark your account as "Automated" in Twitter settings
- Ensure proper credentials in .env file
- Consider using a residential IP or VPN as Twitter may block cloud IPs
- Set up proper rate limiting to avoid suspensions
How do I prevent unwanted Twitter interactions?
To better control what tweets your agent responds to, configure TWITTER_TARGET_USERS
in .env
and set specific action flags like TWITTER_LIKES_ENABLE=false
to control interaction types.
How do I troubleshoot Twitter authentication issues?
Ensure correct credentials in .env
, mark account as "Automated" in Twitter settings, and consider using a residential IP to avoid blocks.
How do I make my agent respond to Twitter replies?
Set ENABLE_ACTION_PROCESSING=true
and configure TWITTER_POLL_INTERVAL
. Target specific users for guaranteed responses.
How do I avoid Twitter bot suspensions?
- Mark account as automated in Twitter settings
- Space out posts (15-20 minutes between interactions)
- Avoid using proxies
How do I fix Twitter authentication issues?
- Ensure correct credentials in .env file
- Use valid TWITTER_COOKIES format
- Turn on "Automated" in Twitter profile settings
Model Configuration
How do I switch between different AI models?
In your character.json file:
{
"modelProvider": "openai", // or "anthropic", "deepseek", etc.
"settings": {
"model": "gpt-4",
"maxInputTokens": 200000,
"maxOutputTokens": 8192
}
}
How do I manage API keys and secrets?
Two options:
- Global .env file for shared settings
- Character-specific secrets in character.json:
{
"settings": {
"secrets": {
"OPENAI_API_KEY": "your-key-here"
}
}
}
Memory and Knowledge Management
How does memory management work in ElizaOS?
ElizaOS uses RAG (Retrieval-Augmented Generation) to convert prompts into vector embeddings for efficient context retrieval and memory storage.
How do I fix "Cannot generate embedding: Memory content is empty"?
Check your database for null memory entries and ensure proper content formatting when storing new memories.
How do I manage my agent's memory?
- To reset memory: Delete the db.sqlite file and restart
- To add documents: Specify path to file / folder in the characterfile
- For large datasets: Consider using a vector database
How much does it cost to run an agent?
- OpenAI API: Approximately 500 simple replies for $1
- Server hosting: $5-20/month depending on provider
- Optional: Twitter API costs if using premium features
- Local deployment can reduce costs but requires 24/7 uptime
How do I clear or reset my agent's memory?
Using the CLI:
npx @elizaos/cli@beta agent reset-memory
Or manually:
- Delete the db.sqlite file in the agent/data directory
- Restart your agent
How do I add custom knowledge or use RAG with my agent?
- Convert documents to txt/md format
- Use the folder2knowledge tool
- Add to the knowledge section in your character file, see docs via
"ragKnowledge": true
Plugins and Extensions
How do I add plugins to my agent?
Using the CLI:
npx @elizaos/cli@beta project add-plugin @elizaos/plugin-name
Or manually:
- Add the plugin to your character.json:
{
"plugins": ["@elizaos/plugin-name"]
} - Install the plugin:
bun install @elizaos/plugin-name
- Rebuild:
bun build
- Configure any required plugin settings in .env or character file
How do I create custom plugins?
- Use the CLI to scaffold a plugin:
- Implement required interfaces (actions, providers, evaluators)
- Publish with
elizaos plugin publish
Production Deployment
What's the recommended way to deploy Eliza?
- Use a VPS or cloud provider (DigitalOcean, AWS, Hetzner)
- Requirements:
- Minimum 2GB RAM
- 20GB storage
- Ubuntu or Debian recommended
- Use PM2 or Docker for process management
- Consider using residential IPs for Twitter bots
How do I ensure my agent runs continuously?
- Use a process manager like PM2:
npm install -g pm2
pm2 start "elizaos start" --name eliza
pm2 save - Set up monitoring and automatic restarts
- Use proper error handling and logging
Troubleshooting
How do I fix database connection issues?
- For SQLite:
- Delete db.sqlite and restart
- Check file permissions
- For PostgreSQL:
- Verify connection string
- Check database exists
- Ensure proper credentials
How do I debug when my agent isn't responding?
- Enable debug logging in .env:
DEBUG=eliza:*
- Check the database for saved messages
- Verify API keys and model provider status
- Check client-specific settings (Twitter, Discord, etc.)
How do I resolve embedding dimension mismatch errors?
- Set
USE_OPENAI_EMBEDDING=true
in .env - Reset your agent's memory with
elizaos agent reset-memory
- Ensure consistent embedding models across your setup
Why does my agent post in JSON format sometimes?
This usually happens due to incorrect output formatting or template issues. Check your character file's templates and ensure the text formatting is correct without raw JSON objects.
How do I make my agent only respond to mentions?
Add a mention filter to your character's configuration and set ENABLE_ACTION_PROCESSING=false
in your .env file.
How can I contribute?
Eliza welcomes contributions from individuals with a wide range of skills:
- Participate in community discussions: Share your insights, propose new ideas, and engage with other community members
- Contribute to the development: https://github.com/elizaOS/eliza
- Extend the ecosystem: Create plugins, clients, and tools
Technical Contributions
- Develop new plugins: Create new functionality using the plugin system
- Improve the core: Enhance the ElizaOS core functionality
- Fine-tune models: Optimize models for specific personalities and use cases
- Enhance clients: Improve platform integrations for Twitter, Discord, etc.
Non-Technical Contributions
- Community Management: Onboard new members, organize events, and foster a welcoming community
- Content Creation: Create tutorials, documentation, and videos
- Translation: Help make ElizaOS accessible to a global audience
- Domain Expertise: Provide insights for specific applications of ElizaOS