qq-agent-plus
Agente Linux para grupos de QQ basado en OneBot v11 y Node.js >=22. Gestiona memoria a largo plazo, envíos multi-parte y stickers nativos. Incluye herramientas de operaciones (ops.js) para auditoría y mantenimiento sin Docker.
Ficha actualizada 22 sept 2026, 16:42 · upstream 22 sept 2026, 16:39 · release v0.6.10
Qué es qq-agent-plus
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
QQ Agent Plus es un agente especializado para servidores Linux que conecta con el protocolo OneBot v11. Utiliza SQLite/WAL para gestionar el estado de las sesiones y mensajes, permitiendo memoria a largo plazo y recuperación tras fallos. La arquitectura procesa cada interacción como una sesión independiente vinculada a herramientas, sin depender de entornos Windows o Electron.
Ofrece capacidades avanzadas como un sistema de stickers automático, gestión activa de conversaciones con tiempos de espera configurables y comandos de mantenimiento integrados en src/ops.js. El despliegue es flexible: se puede instalar todo el stack (incluyendo SnowLuma) mediante scripts interactivos o solo el agente si ya existe un endpoint OneBot.
La seguridad se prioriza con tokens únicos, acceso local por defecto y gestión de credenciales rotativas. Los datos como claves y configuraciones están excluidos del control de versiones Git para proteger la integridad del despliegue en producción.
- Automatización de chat grupal en servidores Linux sin interfaz gráfica.
- Gestión de memoria persistente para bots de conversación a largo plazo.
- Auditoría y mantenimiento proactivo mediante herramientas CLI integradas.
- Integración con modelos OpenAI o compatibles vía API estándar.
- Migración de otros bridges manteniendo datos y configuración existente.
- Gestión de stickers y expresiones nativas del cliente QQ.
- Arquitectura basada en Node.js 22+ con soporte nativo para SQLite.
- Herramientas de operaciones (ops.js) para diagnóstico sin reinicio.
- Sistema de gestión de sesiones independiente por hilo de conversación.
- Integración opcional con SnowLuma para endpoint OneBot v11 completo.
- Scripts de despliegue seguros con validación de estado y rollback automático.
- Soporte para comandos de mantenimiento vía systemd user services.
- Requiere sistema operativo Linux (no Windows ni macOS nativo).
- Dependencia de Node.js versión 22 o superior instalada previamente.
- No incluye Dockerfile en el repositorio principal (despliegue manual o scripts).
- Endpoint OneBot v11 debe estar activo para la conexión WebSocket/HTTP.
- Configuración de modelos externos requiere credenciales y URL proporcionadas manualmente.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Utilizar deploy-all.sh para instalación completa con SnowLuma o deploy.sh solo para el agente. Los servicios se gestionan vía systemd user, no PM2 ni panel web. Por defecto, los puertos OneBot y WebSocket están en localhost; exponerlos requiere configuración de firewall explícita. Rotar credenciales con --rotate-credentials. Verificar compatibilidad de versiones antes de actualizar código para evitar pérdida de estado.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.