QwenPaw: asistente personal local y extensible sobre AgentScope

Todo lo que hay que saber sobre agentscope-ai/QwenPaw: un asistente personal de código abierto que combina una consola web, terminal, canales de mensajería, memoria, skills, MCP y agentes múltiples para funcionar en una máquina propia o en la nube.

Qué es QwenPaw

QwenPaw es un asistente personal de IA de código abierto, construido por el equipo de AgentScope sobre AgentScope, AgentScope Runtime y ReMe. El repositorio lo presenta como una aplicación instalable en una computadora propia o desplegable en la nube, con soporte de varias aplicaciones de chat y capacidades extensibles.

No es un modelo Qwen ni un servicio de inferencia por sí mismo. Es una capa de producto y ejecución: conecta modelos configurados por el usuario con agentes, herramientas, memoria, tareas programadas y canales. Su nombre y su foco de integración con el ecosistema Qwen no deben interpretarse como una limitación técnica a esos modelos; la documentación lista proveedores y endpoints configurables, incluidos OpenAI compatibles.

El proyecto se llamó previamente CoPaw. El cambio de nombre a QwenPaw se explica en material comunitario como una integración más estrecha con el ecosistema Qwen; la evidencia recuperada acredita el cambio de marca, no una alteración completa del objetivo de asistente personal.

El origen: AgentScope convertido en asistente personal

QwenPaw parte del marco AgentScope, una plataforma para construir aplicaciones de agentes y sistemas multiagente que fue descrita en una publicación académica como una arquitectura centrada en el intercambio de mensajes. QwenPaw traduce esa infraestructura de desarrollador a una experiencia más directa: una consola local, una TUI, agentes configurables y conexiones con canales externos.

El resultado se sitúa entre un entorno de trabajo personal y un runtime de agentes. Puede mantener conversaciones, ejecutar tareas recurrentes, activar skills o MCP y administrar varios agentes desde la interfaz. La documentación también incluye prácticas de “equipo de agentes”, por lo que no debe entenderse como un chatbot de una sola función.

Filosofía y principios

Local primero. La guía propone instalarlo en macOS, Linux o Windows, ejecutarlo en Docker o probarlo en la plataforma AgentScope. El contenedor de ejemplo publica solo 127.0.0.1:8088.
Asistente que evoluciona. La documentación organiza funciones de memoria, memoria evolutiva/proactiva, heartbeat, cron y contexto como parte del control operativo del agente.
Múltiples superficies. Una misma instalación puede servirse desde consola web, terminal y aplicaciones de mensajería.
Extensibilidad explícita. Skills, MCP, herramientas incorporadas, plugins y agentes se exponen como componentes configurables en lugar de capacidades cerradas.
Configuración por usuario. El uso del propio modelo, proveedor y canal permite adaptar la instalación, pero también traslada las decisiones de credenciales, permisos y seguridad al operador.

Cómo funciona

La instalación local expone una consola HTTP en el puerto 8088. Su API principal para conversar es POST /api/console/chat; acepta un identificador de agente mediante X-Agent-Id, conserva una sesión a través de session_id y admite streaming SSE.

Usuario / canal → Console, TUI o API → QwenPaw Agent
                                         ├─ modelo configurado
                                         ├─ memoria y contexto
                                         ├─ skills, MCP y herramientas
                                         ├─ agentes múltiples
                                         └─ espacio de trabajo y tareas cron

La consola permite crear, editar, activar, desactivar o eliminar agentes. La API está basada en una extensión del protocolo de runtime de AgentScope y permite enviar mensajes, administrar instancias de agente e integrar canales.

Componentes principales

Console y TUI. La consola web es la superficie de administración y chat; la documentación también publica una interfaz terminal y comandos mágicos con prefijo / para controlar estado conversacional sin depender de la interpretación del modelo.

Agentes múltiples. Desde la versión 0.1.0 el sistema documenta soporte multiagente, con configuración de agentes y selección desde la interfaz.
Skills y MCP. Las skills aportan procedimientos; MCP y las herramientas integradas conectan servicios y acciones externas. La configuración determina qué queda habilitado.

Memoria, cron y heartbeat. QwenPaw documenta memoria, tareas cron y un mecanismo de heartbeat para trabajo periódico o proactivo.

Canales. La sección de canales concentra las integraciones con apps de chat; cada conexión necesita las credenciales y permisos del proveedor correspondiente.

El ecosistema

La instalación puede hacerse mediante script, aplicación de escritorio, Docker o AgentScope Platform. Docker Hub publica la imagen agentscope/qwenpaw; la guía también enlaza una imagen ACR de Alibaba Cloud para usuarios en China.

El repositorio mantiene documentación para seguridad, respaldo y restauración, CLI, plugins, migración de plugins, API REST, integración ACP, contribución y hoja de ruta. Esa amplitud muestra que el proyecto cubre operación además del chat, aunque no prueba automáticamente madurez empresarial en todos esos frentes.

Existe una integración comunitaria para Home Assistant, seoeaa/ha-qwenpaw, citada en una discusión de QwenPaw. Es un proyecto de la comunidad, no una extensión oficial ni una garantía de soporte del equipo de AgentScope.

Números del repo

Medición: 23 de agosto de 2026, API de GitHub. El artículo fuente de este repositorio no incluyó una tabla de métricas propia; estas cifras se verificaron directamente contra la API pública de GitHub al momento de la publicación.

Métrica	Valor
Estrellas	34.358
Bifurcaciones	3.020
Suscriptores reales	106

watchers_count replica las estrellas en la respuesta general de GitHub; por eso se informa subscribers_count como suscriptores reales.

Guía rápida de uso

Instalación y primer arranque

La documentación describe varias rutas. Para Docker:

docker pull agentscope/qwenpaw:latest
docker run -p 127.0.0.1:8088:8088 \
  -v qwenpaw-data:/app/working \
  -v qwenpaw-secrets:/app/working.secret \
  -v qwenpaw-backups:/app/working.backups \
  agentscope/qwenpaw:latest

Después se abre http://127.0.0.1:8088/. La guía separa los volúmenes: configuración, memoria y skills en qwenpaw-data; modelos y claves API en qwenpaw-secrets; copias de respaldo en qwenpaw-backups.

En macOS y Linux, el sitio ofrece un instalador de shell; además hay una aplicación de escritorio para Windows y macOS. La primera apertura puede tardar mientras inicializa el entorno Python y dependencias.

Flujos de trabajo habituales

Asistente personal local: iniciar la consola, configurar un proveedor y conversar con el agente seleccionado.
Varios agentes: crear o editar agentes desde Console y llamar a uno concreto mediante X-Agent-Id en la API.
Automatización: usar cron y heartbeat para lanzar tareas recurrentes, atendiendo a que el proceso o servicio debe seguir ejecutándose.
Extensión: habilitar una skill o MCP revisado para conectar herramientas o servicios externos.
Integración propia: utilizar /api/console/chat con session_id para conservar una conversación y recibir eventos por streaming.

Configuración esencial

Modelo y proveedor: se eligen desde la configuración/console; los endpoints OpenAI compatibles se contemplan en la documentación.
Agente: X-Agent-Id identifica el agente llamado por la API; default es el valor predeterminado.
Sesión: reutilizar session_id permite conversaciones de varios turnos.
Secretos: claves de API y configuraciones de modelo se almacenan en el volumen o espacio separado de secretos en el despliegue Docker recomendado.
Autenticación web: QWENPAW_AUTH_ENABLED=true habilita el token de acceso para solicitudes remotas.

Trampas frecuentes y soluciones

Publicar la consola sin login. La API advierte que una instancia pública sin autenticación permite a terceros acceder y controlar agentes. Activar autenticación web antes de exponerla.
Confiar en el bypass local desde otra máquina. Solo localhost (127.0.0.1 o ::1) omite el token; una llamada remota necesita Authorization: Bearer … cuando el login está activo.
Usar una contraseña de ejemplo. La guía muestra admin123 únicamente como ejemplo de API; debe sustituirse por una credencial única y robusta.
Perder el estado en Docker. No eliminar ni omitir los volúmenes si se quiere conservar memoria, skills, claves y respaldos.
Esperar que cron funcione con la aplicación cerrada. Una discusión comunitaria sobre la bandeja de sistema señala precisamente que las tareas de larga duración requieren que el runtime permanezca disponible; es una observación de un participante, no una especificación oficial.

Seguridad y modelo de confianza

El mensaje de seguridad central es claro: habilitar autenticación web si la instancia queda expuesta a Internet. QwenPaw funciona en modo de usuario único: el registro inicial crea una cuenta de administrador y el endpoint de registro solo puede utilizarse una vez.

Para el acceso remoto, se recomienda transportar el token en el encabezado Authorization; las solicitudes locales pueden omitirlo deliberadamente para facilitar el uso de CLI y desarrollo. El operador debe considerar ese bypass al decidir la interfaz de red y los reenvíos de proxy.

Además de la autenticación, una instalación responsable debe restringir las skills, MCP y canales habilitados, proteger volúmenes de secretos, operar detrás de HTTPS y limitar la exposición de red. Estas últimas son prácticas operativas inferidas de la superficie de herramientas y credenciales documentada; no sustituyen un modelo oficial de despliegue corporativo.

Cómo lo recibió la comunidad

La evidencia externa recuperable es heterogénea y en buena parte comunitaria. En GitHub hay discusiones para seguimiento de errores de una prepublicación 2.0.0, solicitudes de contribución y reuniones de comunidad; esto acredita actividad, no calidad medida.

Un hilo de Reddit sobre el cambio de CoPaw a QwenPaw repite la explicación de una mayor integración con Qwen. Otro hilo en r/LocalLLM registró una consulta de adopción local con tres votos; una señal pequeña de curiosidad, no una reseña.

En Linux.do, un participante comparó QwenPaw con OpenClaw y Hermes y criticó la frecuencia de llamadas a herramientas. Es una experiencia individual que puede depender de modelo y configuración, por lo que no se usa como medición de rendimiento.

Una página de investigación independiente observó escasez de reseñas anglófonas y especuló con que la tracción provenía más del ecosistema chino/AgentScope. Es una inferencia de ese autor, no una conclusión demostrada por los datos públicos.

QwenPaw frente a otras propuestas

Propuesta	Coincidencia verificable	Diferencia verificable
Agente de chat local	Ambos permiten usar un modelo desde una interfaz propia.	QwenPaw añade agentes configurables, canales, cron, heartbeat, skills, MCP y API de sesiones.
AgentScope	QwenPaw está construido sobre AgentScope y su runtime.	AgentScope es la plataforma de desarrollo multiagente; QwenPaw es el producto de asistente personal que la utiliza.
CoPaw	Es el nombre anterior del proyecto.	QwenPaw es la denominación actual; el material comunitario vincula el cambio a un foco mayor en el ecosistema Qwen.
Home Assistant + `ha-qwenpaw`	Ambos pueden formar parte de una automatización doméstica.	`ha-qwenpaw` es una integración comunitaria citada en una discusión, no una capacidad garantizada del núcleo.

Casos de uso y a quién puede ayudar este repositorio

Personas que quieren un asistente propio con consola local, modelos configurables y estado persistente.
Desarrolladores que integran agentes en una app interna mediante API REST, sesiones y streaming SSE.
Usuarios que necesitan automatizaciones personales con tareas recurrentes, memoria y varios canales, y pueden mantener el servicio en ejecución.
Equipos técnicos que prototipan un grupo de agentes sobre AgentScope y necesitan una interfaz y configuración de producto ya preparadas.

No es adecuado exponerlo directamente a Internet o conectar herramientas y canales con privilegios amplios sin habilitar autenticación, limitar la red y revisar cuidadosamente credenciales y capacidades.

Recursos

Repositorio: https://github.com/agentscope-ai/QwenPaw
Sitio y documentación: https://qwenpaw.agentscope.io/docs/
Inicio rápido: https://qwenpaw.agentscope.io/docs/quickstart/
API REST: https://qwenpaw.agentscope.io/docs/api-tutorial/
Comunidad: https://qwenpaw.agentscope.io/docs/community/
Discusiones: https://github.com/agentscope-ai/QwenPaw/discussions
Paper de AgentScope: https://arxiv.org/abs/2402.14034

Nota: artículo elaborado con el repositorio, documentación del proyecto, paper de AgentScope y conversaciones públicas recuperadas el 17 de agosto de 2026. Las funciones, compatibilidades y actividad comunitaria pueden cambiar con el tiempo.