"OpenAI API key is not configured"
Using local.config.php: confirm chatbot.openai_api_key is present and the file is valid PHP
Using DB storage: re-enter the key in settings and save (leaving the field blank preserves the existing saved value)
Indexing jobs are queued but never run
Omeka S background jobs require a queue worker. Run it manually:
php /path/to/omeka/application/data/scripts/queue.php
Answers reference outdated or deleted items
- Run a full re-index after bulk content changes
- Check Chatbot → View Logs for embedding failures
- Use Chatbot → Diagnostics → Run Test Search to inspect what the vector index currently contains
Changed embedding model or dimensions
The vector table is automatically recreated if dimensions change, but all existing vectors are invalidated. Run a full re-index after changing the model or dimensions.
Turso connection failing
- Verify the URL format:
libsql://your-db-name.turso.io(orhttps://— both are accepted) - Check that the auth token is still valid (tokens can be revoked in the Turso dashboard)
- Use Chatbot → Diagnostics to test connectivity; it reports connection status and current chunk count
Users hitting rate limits
The public chat API allows 10 requests per 60 seconds per IP address. Encourage users to ask broader questions rather than sending rapid short queries.
Chat widget not appearing on public pages
- Confirm "Enable global chat widget" is checked and settings have been saved
- The widget only appears on public site pages, not admin pages
- Check the browser console for JavaScript errors