Proveedor local o externo, sin exponer la clave
El plugin AI Chat usa Ollama local por defecto. Puedes apuntar a un servicio con clave propia desde la pantalla, sin tocar archivos ni reiniciar la plataforma.
En la pantalla (por bot)
Configuración → “Proveedor de IA”. Elige el servicio, el endpoint y el modelo, pega tu clave y pulsa “Probar conexión” antes de guardar: el botón muestra el motivo real del fallo (estado HTTP y lo que respondió el servicio), en vez de un “ok” genérico.
- Ollama local — sin clave, sin coste
- OpenAI, Groq, OpenRouter, DeepSeek, Together, LM Studio, vLLM, llama.cpp, LiteLLM
- Anthropic
- Google Gemini
- Servicio propio (custom)
- — La clave es write-only: entra y nunca vuelve. La pantalla solo muestra los últimos 4 caracteres.
- — Cambiar el endpoint con el campo de clave vacío conserva la clave ya guardada.
- — La configuración solo entra en vigor cuando el bot reinicia — el proveedor se resuelve al construir el plugin.
- — Solo el dueño del bot ve esta sección. La plataforma comprueba la propiedad en lectura y escritura.
- — Si la configuración es inválida, el bot arranca normal y solo la respuesta de IA queda desactivada.
En el servidor (global)
Vale para todos los bots y es lo que el plugin usa cuando un bot no tiene configuración propia. `external` sigue disponible para quien ya lo usaba: URL exacta + Bearer.
AI_PROVIDER=external
AI_ENDPOINT=https://tu-endpoint/v1/generate
AI_API_KEY=clave-write-only
AI_MODEL=modelo
AI_TIMEOUT_MS=15000
AI_RATE_LIMIT_PER_MINUTE=12
AI_ALLOWED_ACTIONS=follow,come,stop,collect,equipReglas de seguridad
- ✓ La clave nunca usa NEXT_PUBLIC_ ni vuelve al navegador — ni en la respuesta que confirma el guardado.
- ✓ Se queda en un archivo con permiso restringido (0600), no en la base de datos.
- ✓ Las respuestas pasan por schema y límites.
- ✓ attack y mine están bloqueados por defecto.
- ✓ Delay, onlyWhisper y rate limit por jugador se aplican.
Para Ollama local
AI_PROVIDER=ollama
OLLAMA_URL=http://127.0.0.1:11434
AI_MODEL=llama3.2:1bSi la IA no responde
El chat se traga el error a propósito (un fallo de IA no puede tumbar al bot), así que el silencio en el chat es el comportamiento normal cuando algo falla. Usa “Probar conexión”: muestra el estado y el detalle que devolvió el servicio. Si la prueba pasa y el chat no responde, comprueba que la acción pedida está en la allowlist.