# ElizaOS Development Report – 2025-02-18 ## ElizaOS: Plugin Development, Deployment, and Technical Issues ### Technical Discussions & Decisions - **Plugin Contribution & Installation**: Requires a separate repository, PR submission to `index.json`, and approval. - **Docker Deployment Issues**: Missing dependencies and incorrect paths; use `pnpm docker` for builds. - **Multi-Agent System**: Discussed shared memory for specialized tasks. - **RAG Knowledge Integration**: `.md` files work, but `.pdf` files do not. - **Twitter & Discord Plugin Issues**: Redundant posts, shadowbanning, and connection issues. - **Local AI Models**: Use `plugin-local-ai` for DeepSeek and Ollama. - **Tech-Support Bot**: Proposed bot for JavaScript, Bitcoin, and GitHub support. - **Web3 Narrative Automation**: Using ElizaOS and Langchain for content automation. ### Concrete Solutions & Implementations - **Fixing Twitter Plugin Issues**: Adjust `modelConfig` settings. - **Fixing Telegram IPv6 Issues**: Modify Telegram client to force IPv4. - **Fixing Docker Issues**: Adjust Dockerfile for correct paths and dependencies. - **Fixing SQLite Issues**: Run `pnpm add better-sqlite3@latest --force` and `npm rebuild better-sqlite3`. - **Fixing Plugin Installation Failures**: Exclude `plugin-trustdb`. ### FAQ 1. **How do I add a plugin?** Submit a PR to the plugin registry. 2. **Does ElizaOS support Twitter DMs?** No, due to API limitations. 3. **How do I install the Discord client in v2?** Add it as a plugin. 4. **How do I fix SQLite module errors?** Run `pnpm add better-sqlite3@latest --force` and `npm rebuild better-sqlite3`. 5. **How do I use a local AI model?** Use `plugin-local-ai` and configure `OLLAMA_SERVER_URL`. 6. **How do I prevent Twitter post duplication?** Ensure the plugin is set as a provider, not an action. 7. **How do I run multiple agents with different Twitter accounts?** Use namespaced environment variables. 8. **How do I contribute to documentation?** PRs are welcome; documentation is in the main repo. 9. **How do I fix Docker build issues?** Adjust Dockerfile for correct paths and dependencies. 10. **How do I use RAG knowledge?** Place documents in the knowledge directory. ### Action Items #### Technical Tasks 1. Fix Docker build issues. 2. Fix Twitter plugin redundancy issues. 3. Fix Discord client installation in v2. 4. Fix SQLite module errors. 5. Fix Telegram IPv6 issues. 6. Fix RAG knowledge directory issues. 7. Fix Twitter post duplication. 8. Fix OpenRouter API key retrieval. 9. Fix Plugin Registry issues. 10. Fix Ollama plugin installation. #### Documentation Needs 11. Update Plugin Installation Guide. 12. Update RAG Knowledge Documentation. 13. Update Docker Deployment Guide. 14. Update Multi-Agent Setup Guide. 15. Update Twitter Plugin Configuration Guide. 16. Add REST API Documentation. #### Feature Requests 17. Add Memory Deletion Feature. 18. Add Auto-Migration Tool for v2 Plugins. 19. Add MCP Client Plugin. 20. Improve Plugin Registry Search & Filtering. --- ## Dependency Management Improvements ### Key Updates - **Stricter Dependency Management**: `pnpm` now enforces explicit dependencies, preventing unintended cross-dependencies. - **Community Discussion**: `lefrog_dont_code` and `dtb0x` agreed this results in a cleaner structure. - **Character Plugin Loading Fixes**: PR submitted for review. - **Documentation Updates**: Suggested to clarify the new approach. --- ## ElizaOS: Technical Discussions, Issues, and Solutions ### Technical Discussions & Decisions - **Cloudflare AI Gateway**: Requires a bearer token even for unauthenticated requests. - **Eliza.gg Replacement**: Community working on a new version. - **Eliza Starter vs. Eliza**: Starter is lightweight but lacks a web interface. - **Hosting Eliza Agents**: AWS with SST and Docker is a common setup. - **Multi-Agent System**: Discussed unified memory store for task delegation. - **Plugin Registry Issues**: Duplicate or inconsistent plugin names. - **Twitter Client Issues**: Problems with latest integration. - **Docker Deployment Issues**: Path-related issues preventing execution. - **Ollama API Support**: `plugin-local-ai` supports Ollama but is not listed in the registry. - **V2 Migration**: Requires changes; an auto-migration tool is planned. ### Concrete Solutions & Implementations - **Fix for Twitter Double Messaging**: Issue with action vs. provider setup. - **Discord Client Installation**: Needs to be added as a plugin. - **Fix for SQLite Issues**: Run `pnpm add better-sqlite3@latest --force` and `npm rebuild better-sqlite3`. - **Docker Fixes**: Adjusted Dockerfile for correct paths and dependencies. - **Plugin Metadata Fix**: Moving descriptions and images to `package.json`. - **New Documentation Site**: `eliza.how` launched. ### Common Issues & Fixes - **Twitter Client Connection Issues**: Users mistakenly used `plugin-twitter` instead of `@elizaos-plugins/client-twitter`. - **Docker Build Errors**: Resolved by using `pnpm docker`. - **RAG Knowledge System**: `.md` files work, but `.pdf` files do not. - **Plugin Installation Issues**: `plugin-trustdb` caused failures; removing it resolved the issue. - **Telegram Client Setup**: Requires `npx elizaos plugins install @elizaos-plugins/client-telegram` and a token from BotFather. - **Custom Plugin Development**: Requires defining providers in `packages/core/src/providers.ts`. - **DeFi Data Integration**: Requires collecting, storing, and defining actions for real-time data. - **Client vs. Plugin Confusion**: Clients should be listed under `plugins`. ### Action Items #### Technical Tasks 1. Fix Docker Deployment Issues. 2. Resolve Twitter Client Bugs. 3. Improve Plugin Registry Organization. 4. Fix SQLite Installation Issues. 5. Ensure Ollama Plugin is Public. 6. Fix REST API Authentication. 7. Improve Multi-Agent Setup Documentation. 8. Fix Twitter Double Messaging Issue. 9. Improve Embedding Error Handling. 10. Fix Discord Client Installation Process. #### Documentation Needs 11. Update Plugin Installation Guide. 12. Clarify Multi-Agent Setup. 13. Improve REST API Documentation. 14. Add Ollama API Setup Guide. 15. Fix Twitter Client Documentation. 16. Improve Docker Setup Guide. #### Feature Requests 17. Add Auto-Migration Tool for V2. 18. Improve Plugin Metadata Handling. 19. Enhance Twitter Client to Avoid Duplicates. 20. Add Admin Controls for Memory Deletion. --- ## ElizaOS Development Updates and Technical Discussions ### Technical Discussions & Decisions - **ElizaOS Twitter DM Support**: Not supported due to API limitations. - **Agent Registry & Communication Protocol**: Proposal for AI16Z token and PGP signatures. - **Plugin System & Registry**: Developers must submit PRs to add plugins. - **Cloudflare AI Gateway**: Requires a bearer token. - **Eliza.gg Replacement**: Being developed due to poor knowledge retention. - **Eliza Starter vs. Main Repo**: Starter is for quick setup but lacks a web interface. - **Docker Deployment Issues**: Missing dependencies and incorrect paths. - **Multi-Agent System**: Discussion on shared memory. - **RAG Knowledge Integration**: Some confusion around storage and retrieval. - **Twitter Plugin Issues**: Redundant posts and shadowbanning. - **Discord Client Issues**: Requires adding as a plugin. - **Ollama & Local AI Models**: `plugin-local-ai` is the correct plugin. ### Concrete Solutions & Implementations - **Plugin Installation**: Use `npx elizaos plugins install `. - **Fixing Twitter Plugin Issues**: Adjust `modelConfig` settings. - **Fixing Telegram IPv6 Issues**: Modify Telegram client to force IPv4. - **Fixing Docker Issues**: Adjust Dockerfile. - **Multi-Agent Setup**: Use namespaced environment variables. - **Fixing SQLite Issues**: Run `pnpm add better-sqlite3@latest --force` and `npm rebuild better-sqlite3`. ### Bug Fixes & Feature Enhancements - **Fix for Twitter Double Messaging**: Issue with action vs. provider setup. - **Fix for SQLite Issues**: Resolved installation problems. - **Docker Fixes**: Adjusted Dockerfile. - **New Documentation Site**: `eliza.how` launched. - **New Features**: Added `postProcessors`, plugin install checking, and Mem0 as a provider.