Cómo Instalar IA en Moodle Paso a Paso

Publicado el 10 de agosto de 2026 · 12 min de lectura

Si administras un Moodle, probablemente te lo han preguntado ya: "¿cuándo vamos a tener ChatGPT en el campus?". Estudiantes, profesores y dirección quieren IA. El problema es que la mayoría de tutoriales para instalar IA en Moodle están en inglés, asumen conocimientos técnicos avanzados, y no cubren los errores que aparecen cuando lo despliegas en un servidor real.

Esta guía cubre todo el proceso, desde cero, en español. Al finalizar tendrás un asistente de IA funcionando en tu Moodle, respondiendo preguntas de estudiantes sobre notas, tareas, exámenes y cursos — en español y 24/7.

Requisitos del servidor

Antes de instalar nada, verifica que tu servidor cumple los requisitos mínimos. La mayoría de Moodles ya los cumplen, pero comprueba para evitar sorpresas:

• Moodle 4.1 o superior (4.4, 4.5 y 5.x compatibles). Campus Assistant funciona en todas las versiones desde 4.1.
• PHP 8.0 o superior con las extensiones cURL, JSON y mbstring activadas. Son extensiones estándar que vienen activas por defecto en casi todos los hosting.
• Acceso de administrador a Moodle. Necesitas la cuenta admin para instalar plugins.
• Conexión a internet saliente para que el plugin pueda llamar a la API del proveedor de IA (OpenAI, DeepSeek, Gemini o Claude).

No necesitas: acceso SSH, conocimientos de programación, ni un servidor dedicado. La instalación se hace enteramente desde el panel web de Moodle.

Para comprobar tu versión de Moodle y PHP: ve a Administración del sitio → Servidor → Información PHP. Verás la versión de Moodle en el pie de página del panel de administración.

Paso 1: Descargar el plugin

El plugin de IA para Moodle se distribuye como un archivo ZIP. Para obtenerlo:

1. Ve a campusassistant.app/es/pricing
2. Regístrate gratuitamente (nombre y email)
3. Desde el panel de control, descarga el plugin en versión gratuita (50 mensajes al mes) o introduce tu licencia comprada (499€/año, mensajes ilimitados)

El archivo se llamará algo como campus-assistant-v2.2.1.zip. Guárdalo en tu equipo, lo necesitarás en el siguiente paso.

¿Por qué registrarse antes de descargar? Porque así podemos llevar un control de instalaciones y ofrecerte soporte técnico si lo necesitas. Tus datos no se comparten con terceros.

Paso 2: Subir el plugin a Moodle

Inicia sesión en tu Moodle como administrador. Luego:

1. Ve a Administración del sitio → Plugins → Instalar plugins
2. Arrastra el archivo ZIP a la zona que dice "Arrastra y suelta el paquete ZIP aquí"
3. Moodle detectará automáticamente que es un plugin de tipo local_campusai
4. Haz clic en "Instalar plugin desde archivo ZIP"

Si tu Moodle está configurado para no permitir subidas por panel (algunos hosting restringen esto), tendrás que hacerlo por FTP/SFTP:

• Descomprime el ZIP localmente
• Sube la carpeta campusai a tu-moodle/local/ vía SFTP
• Ve a Administración del sitio → Notificaciones y Moodle detectará el plugin nuevo

En ambos casos, Moodle mostrará una pantalla con los detalles del plugin (nombre, tipo, versión). Haz clic en "Continuar".

Paso 3: Instalación de base de datos

Moodle ejecutará automáticamente el script de instalación que crea las tablas necesarias en tu base de datos. Verás una lista de sentencias SQL ejecutadas. No tienes que hacer nada — solo esperar.

Si todo va bien, verás el mensaje: "Éxito. El plugin local_campusai se ha instalado correctamente."

Si ves un error aquí, lo más probable es que sea un problema de permisos de base de datos. El usuario de MySQL/MariaDB de tu Moodle necesita permisos CREATE TABLE. La mayoría ya los tiene, pero si tu hosting los restringe, contacta con tu proveedor.

Paso 4: Conseguir una API key

El plugin necesita conectarse a un modelo de lenguaje (LLM) para procesar las preguntas. Tienes cuatro proveedores compatibles. Elige según tu presupuesto y necesidades:

Opción A: DeepSeek (recomendado — mejor calidad-precio)

• Ve a platform.deepseek.com y regístrate
• Recarga saldo (mínimo 5€). El modelo DeepSeek V3 cuesta aproximadamente 0,001€ por consulta
• En "API Keys", crea una nueva clave y cópiala
• Coste estimado: 2-8€/mes para un campus de 500 estudiantes

Opción B: OpenAI (el más popular)

• Ve a platform.openai.com y regístrate
• Recarga saldo (mínimo 10$). GPT-4o-mini cuesta aproximadamente 0,005$ por consulta
• En "API Keys", crea una nueva clave
• Coste estimado: 10-40€/mes para 500 estudiantes

Opción C: Google Gemini

• Ve a aistudio.google.com y regístrate con tu cuenta de Google
• Gemini Flash tiene una capa gratuita generosa (15 consultas/minuto gratis)
• Crea una API key en "Get API key"
• Coste estimado: 0-15€/mes (depende del uso de la capa gratuita)

Opción D: Anthropic Claude

• Ve a console.anthropic.com y regístrate
• Recarga saldo (mínimo 5$). Claude Haiku cuesta aproximadamente 0,003$ por consulta
• En "API Keys", crea una nueva clave
• Coste estimado: 5-20€/mes para 500 estudiantes

Nuestra recomendación: DeepSeek para la mayoría de instituciones (mejor relación calidad-precio). OpenAI si quieres la máxima compatibilidad y ya tienes cuenta. Gemini si quieres empezar gratis.

Paso 5: Configurar el plugin

Después de instalar, ve a:

Administración del sitio → Plugins → Plugins locales → Campus Assistant

Verás un panel de configuración con estos campos:

Datos de licencia

• Licencia: pega tu clave de licencia (si tienes plan de pago). Si usas la versión gratuita, deja el campo vacío.
• Dominio autorizado: la URL de tu Moodle. La licencia se vincula a este dominio.

Configuración de IA

• Proveedor: elige DeepSeek, OpenAI, Gemini o Claude
• API Key: pega la clave que obtuviste en el paso anterior
• Modelo: el plugin te ofrece los modelos recomendados para cada proveedor
• Temperatura: 0.7 por defecto (equilibrio entre precisión y creatividad). Para respuestas más conservadoras, baja a 0.3. Para conversación más natural, sube a 0.9.

Personalización

• Idioma por defecto: Español
• Nombre del asistente: el que prefieras ("Asistente Campus", "Tutor Virtual", "Campus Bot"…)
• Color del botón: personalízalo con el color de tu institución
• Logo: sube el logo de tu universidad o academia (PNG, máx. 512x512px)
• Posición del botón: esquina inferior derecha (por defecto) o izquierda

Permisos por rol

Por defecto, el asistente está disponible para todos los usuarios autenticados. Puedes restringirlo:

• Estudiantes: acceso a 20 funciones (consultar notas, tareas, calendario, progreso…)
• Profesores: acceso a 12 funciones adicionales (listar pendientes de corregir, detectar estudiantes en riesgo, progreso de la clase…)
• Administradores: acceso a 16 funciones de gestión (estadísticas del campus, cursos inactivos, uso de almacenamiento…)
• Puedes activar/desactivar funciones individuales desde el panel

Guarda los cambios con el botón "Guardar cambios" al final de la página.

Paso 6: Probar el asistente

La forma más rápida de comprobar que todo funciona:

1. Cierra sesión como admin e inicia sesión como estudiante (o usa la opción "Iniciar sesión como" desde el perfil de un alumno)
2. Ve a cualquier página de tu Moodle
3. Verás el botón del asistente en la esquina inferior derecha. Haz clic.
4. Escribe una pregunta y espera la respuesta:

Preguntas de prueba recomendadas:

• "¿Qué tareas tengo pendientes esta semana?"
• "¿Cuál es mi nota media?"
• "¿Cuándo es mi próximo examen?"
• "¿En qué cursos estoy matriculado?"

Si el asistente responde correctamente, ¡enhorabuena! Ya tienes IA funcionando en tu Moodle.

Errores comunes y cómo solucionarlos

Error: "No se pudo conectar con el proveedor de IA"

Causa: tu servidor no puede hacer peticiones salientes a la API del proveedor.

Solución: verifica que la extensión cURL de PHP está activa. Si tu hosting tiene firewall (como csf, iptables), asegúrate de que permite conexiones salientes a los dominios de la API (api.openai.com, api.deepseek.com, etc.). Si usas un proxy, configura $CFG->proxyhost en Moodle.

Error: "API key inválida"

Causa: la clave introducida es incorrecta, ha expirado, o no tiene saldo.

Solución: vuelve a la plataforma del proveedor, copia la API key completa (suelen ser cadenas largas que empiezan por sk-...), y verifica que tienes saldo. Si copiaste con espacios al inicio/final, vuelve a pegarla.

Error: "El plugin no aparece tras instalar"

Causa: la caché de Moodle no se ha actualizado.

Solución: ve a Administración del sitio → Desarrollo → Purgar todas las cachés. También puedes hacerlo desde la línea de comandos con php admin/cli/purge_caches.php.

Error: "Los estudiantes no ven el botón"

Causa: el tema (theme) de Moodle que usas no incluye el hook estándar before_standard_html_head o standard_after_main_html.

Solución: la mayoría de themes oficiales de Moodle lo incluyen. Si usas un theme comercial (Edumy, Fordson, Moove), verifica que estás en la última versión. Como workaround, puedes inyectar el código manualmente desde Administración del sitio → Apariencia → HTML adicional, pegando el include en "Dentro del head" o "Antes de cerrar body".

Error: pantalla en blanco tras instalar

Causa: la versión de PHP es inferior a 8.0, o falta la extensión cURL.

Solución: contacta con tu hosting para que actualicen PHP a 8.0+ y activen la extensión cURL. Si administras tu propio servidor: apt install php-curl && systemctl restart apache2 (o el servidor web que uses).

Optimización: ajustes recomendados

Una vez instalado y funcionando, estos ajustes mejoran la experiencia:

Rate limiting (limitar consultas por usuario)

Desde la configuración del plugin puedes establecer un límite de consultas por usuario al día. Recomendado: 50/día para estudiantes (suficiente para uso real, evita abuso y controla costes de API).

Registrar conversaciones para analítica

El plugin puede guardar un log de las conversaciones (anonimizado o con identificador de usuario). Esto te permite ver qué preguntan más los estudiantes y detectar problemas comunes en el campus.

Mensaje de bienvenida personalizado

Configura un mensaje inicial que verá el usuario al abrir el asistente. Ejemplo: "¡Hola! Soy el asistente del Campus. Puedo ayudarte con tus notas, tareas, exámenes y cursos. ¿Qué necesitas?"

Contexto institucional

Puedes añadir instrucciones personalizadas (system prompt) para que el asistente conozca detalles de tu institución: nombre, normativa académica, fechas de matrícula, contactos de soporte, etc.

¿Cuánto cuesta mantener IA en Moodle?

El coste total tiene dos partes:

1. Licencia del plugin

• Versión gratuita: 0€ — 50 mensajes al mes para probar
• Licencia anual: 499€/año — mensajes ilimitados, todas las funciones

2. API del proveedor de IA

• DeepSeek: ~2-8€/mes (500 estudiantes activos)
• OpenAI GPT-4o-mini: ~10-40€/mes (500 estudiantes)
• Google Gemini: 0-15€/mes (con capa gratuita)
• Claude Haiku: ~5-20€/mes (500 estudiantes)

Coste total estimado: 499€/año + 24-480€/año de API = 523-979€/año para un campus entero. Comparado con alternativas SaaS que cobran por usuario (39-449$/mes = 470-5.400€/año), el ahorro es significativo.

¿Qué pasa si cambio de proveedor de IA?

Nada. Campus Assistant está diseñado para ser agnóstico: puedes cambiar de DeepSeek a OpenAI, de OpenAI a Gemini, o de Gemini a Claude en cualquier momento desde el panel de configuración. Solo necesitas la nueva API key. Las conversaciones anteriores se conservan.

Esto significa que no estás atado a un proveedor. Si mañana sale un modelo mejor y más barato, lo cambias en 30 segundos sin reinstalar nada.

Resumen

Instalar IA en Moodle es un proceso de 5-10 minutos que no requiere programación:

1. Descargar el plugin de campusassistant.app
2. Subir el ZIP desde el panel de administración de Moodle
3. Conseguir una API key (DeepSeek, OpenAI, Gemini o Claude)
4. Configurar proveedor, idioma y personalización
5. Probar con una pregunta como estudiante

Si te encuentras con problemas, la mayoría se resuelven verificando la versión de PHP (8.0+), la extensión cURL, y que la API key es correcta y tiene saldo.

El resultado: un asistente de IA que responde en español, 24/7, consultando los datos reales de tu Moodle. Tus estudiantes dejan de preguntar las mismas cosas una y otra vez. Tus profesores tienen herramientas para detectar estudiantes en riesgo. Y tu equipo de TI deja de recibir tickets por consultas repetitivas.