Loki Agent 𖤍
September 11, 2026 · View on GitHub
Loki Agent 𖤍
El agente de IA con mejora continua creado por WunderCorp, Inc.. Es el único agente con un bucle de aprendizaje integrado: crea habilidades a partir de la experiencia, las mejora durante el uso, se impulsa a sí mismo a persistir el conocimiento, busca en sus propias conversaciones pasadas y construye un modelo cada vez más profundo de quién eres a lo largo de las sesiones. Ejecútalo en un VPS de $5, un clúster de GPUs o infraestructura sin servidor que cuesta casi nada cuando está inactivo. No está atado a tu laptop — habla con él desde Telegram mientras trabaja en una VM en la nube.
Usa cualquier modelo que quieras — WunderCorp Portal, OpenRouter (más de 200 modelos), NovitaAI, NVIDIA NIM (Nemotron), Xiaomi MiMo, z.ai/GLM, Kimi/Moonshot, MiniMax, Hugging Face, OpenAI, o tu propio endpoint. Cambia con loki model — sin cambios de código, sin dependencias.
| Una interfaz de terminal real | TUI completa con edición multilínea, autocompletado de comandos, historial de conversaciones, interrupción y redirección, y salida de herramientas en streaming. |
| Vive donde tú vives | Telegram, Discord, Slack, WhatsApp, Signal y CLI — todo desde un único proceso gateway. Transcripción de notas de voz, continuidad de conversación entre plataformas. |
| Un bucle de aprendizaje cerrado | Memoria curada por el agente con recordatorios periódicos. Creación autónoma de habilidades tras tareas complejas. Las habilidades mejoran solas durante el uso. Búsqueda FTS5 de sesiones con resumención por LLM para recuperación entre sesiones. Modelado de usuario dialéctico Honcho. Compatible con el estándar abierto de agentskills.io. |
| Automatizaciones programadas | Planificador cron integrado con entrega a cualquier plataforma. Informes diarios, copias de seguridad nocturnas, auditorías semanales — todo en lenguaje natural, ejecutándose de forma autónoma. |
| Delega y paraleliza | Lanza subagentes aislados para flujos de trabajo paralelos. Escribe scripts de Python que llaman a herramientas vía RPC, convirtiendo pipelines de múltiples pasos en turnos de coste cero de contexto. |
| Funciona en cualquier lugar, no solo en tu laptop | Seis backends de terminal — local, Docker, SSH, Singularity, Modal y Daytona. Daytona y Modal ofrecen persistencia sin servidor — el entorno de tu agente hiberna cuando está inactivo y se activa bajo demanda, costando casi nada entre sesiones. Ejecútalo en un VPS de \$5 o un clúster de GPUs. |
| Listo para investigación | Generación de trayectorias en lote, compresión de trayectorias para entrenar la próxima generación de modelos de llamadas a herramientas. |
Instalación rápida
Linux, macOS, WSL2, Termux
curl -fsSL https://loki.computer/install.sh | bash
Windows (nativo, PowerShell)
Nota: En Windows nativo, Loki funciona sin WSL — la CLI, el gateway, la TUI y las herramientas funcionan de forma nativa. Si prefieres usar WSL2, el comando de Linux/macOS de arriba también funciona allí. ¿Encontraste un error? Por favor crea un issue.
Ejecuta esto en PowerShell:
iex (irm https://loki.computer/install.ps1)
El instalador se encarga de todo: uv, Python 3.11, Node.js, ripgrep, ffmpeg, y un Git Bash portátil (MinGit, descomprimido en %LOCALAPPDATA%\loki\git — no requiere administrador, completamente aislado de cualquier instalación de Git del sistema). Loki usa este Git Bash incluido para ejecutar comandos de shell.
Si ya tienes Git instalado, el instalador lo detecta y lo usa en su lugar. De lo contrario, una descarga de ~45MB de MinGit es todo lo que necesitas — no tocará ni interferirá con ningún Git del sistema.
Android / Termux: La ruta manual probada está documentada en la guía de Termux. En Termux, Loki instala el extra
.[termux]curado porque el extra completo.[all]actualmente incluye dependencias de voz incompatibles con Android.Windows: Windows nativo es totalmente compatible — el comando de PowerShell de arriba instala todo. Si prefieres usar WSL2, el comando de Linux también funciona allí. La instalación nativa de Windows se encuentra en
%LOCALAPPDATA%\loki; WSL2 instala en~/.lokicomo en Linux.
Después de la instalación:
source ~/.bashrc # recargar shell (o: source ~/.zshrc)
loki # ¡empieza a chatear!
Primeros pasos
loki # CLI interactiva — inicia una conversación
loki model # Elige tu proveedor y modelo LLM
loki tools # Configura qué herramientas están habilitadas
loki config set # Establece valores de configuración individuales
loki gateway # Inicia el gateway de mensajería (Telegram, Discord, etc.)
loki setup # Ejecuta el asistente de configuración completo
loki claw migrate # Migra desde OpenClaw (si vienes de OpenClaw)
loki update # Actualiza a la última versión
loki doctor # Diagnostica cualquier problema
Evita la colección de claves API — WunderCorp Portal
Loki funciona con cualquier proveedor que quieras — eso no cambiará. Pero si prefieres no recopilar cinco claves API separadas para el modelo, búsqueda web, generación de imágenes, TTS y un navegador en la nube, WunderCorp Portal las cubre todas bajo una sola suscripción:
- Más de 300 modelos — elige cualquiera con
/model <nombre> - Tool Gateway — búsqueda web (Firecrawl), generación de imágenes (FAL), texto a voz (OpenAI), navegador en la nube (Browser Use), todo enrutado a través de tu suscripción. Sin cuentas adicionales.
Un comando desde una instalación nueva:
loki setup --portal
Esto te autentica vía OAuth, establece WunderCorp como tu proveedor y activa el Tool Gateway. Comprueba qué está conectado en cualquier momento con loki portal info. Detalles completos en la página de documentación del Tool Gateway.
Puedes seguir usando tus propias claves por herramienta cuando quieras — el gateway es por backend, no todo o nada.
Referencia rápida: CLI vs Mensajería
Loki tiene dos puntos de entrada: inicia la interfaz de terminal con loki, o ejecuta el gateway y habla con él desde Telegram, Discord, Slack, WhatsApp, Signal o Email. Una vez en una conversación, muchos comandos de barra son compartidos entre ambas interfaces.
| Acción | CLI | Plataformas de mensajería |
|---|---|---|
| Empezar a chatear | loki | Ejecuta loki gateway setup + loki gateway start, luego envía un mensaje al bot |
| Nueva conversación | /new o /reset | /new o /reset |
| Cambiar modelo | /model [proveedor:modelo] | /model [proveedor:modelo] |
| Establecer personalidad | /personality [nombre] | /personality [nombre] |
| Reintentar o deshacer último turno | /retry, /undo | /retry, /undo |
| Comprimir contexto / ver uso | /compress, /usage, /insights [--days N] | /compress, /usage, /insights [days] |
| Explorar habilidades | /skills o /<nombre-habilidad> | /<nombre-habilidad> |
| Interrumpir trabajo actual | Ctrl+C o enviar un nuevo mensaje | /stop o enviar un nuevo mensaje |
| Estado específico de plataforma | /platforms | /status, /sethome |
Para las listas de comandos completas, consulta la guía de CLI y la guía del Gateway de Mensajería.
Documentación
Toda la documentación está en doku.sh:
| Sección | Contenido |
|---|---|
| Inicio rápido | Instalar → configurar → primera conversación en 2 minutos |
| Uso de CLI | Comandos, atajos de teclado, personalidades, sesiones |
| Configuración | Archivo de configuración, proveedores, modelos, todas las opciones |
| Gateway de Mensajería | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| Seguridad | Aprobación de comandos, emparejamiento por DM, aislamiento en contenedor |
| Herramientas y Toolsets | Más de 40 herramientas, sistema de toolsets, backends de terminal |
| Sistema de Habilidades | Memoria procedimental, Skills Hub, creación de habilidades |
| Memoria | Memoria persistente, perfiles de usuario, mejores prácticas |
| Integración MCP | Conecta cualquier servidor MCP para capacidades extendidas |
| Programación Cron | Tareas programadas con entrega a plataforma |
| Archivos de Contexto | Contexto de proyecto que da forma a cada conversación |
| Arquitectura | Estructura del proyecto, bucle del agente, clases principales |
| Contribuir | Configuración de desarrollo, proceso de PR, estilo de código |
| Referencia de CLI | Todos los comandos y flags |
| Variables de Entorno | Referencia completa de variables de entorno |
Migración desde OpenClaw
Si vienes de OpenClaw, Loki puede importar automáticamente tu configuración, memorias, habilidades y claves API.
Durante la configuración inicial: El asistente de configuración (loki setup) detecta automáticamente ~/.openclaw y ofrece migrar antes de que comience la configuración.
En cualquier momento después de instalar:
loki claw migrate # Migración interactiva (preset completo)
loki claw migrate --dry-run # Vista previa de qué se migraría
loki claw migrate --preset user-data # Migrar sin secretos
loki claw migrate --overwrite # Sobreescribir conflictos existentes
Qué se importa:
- SOUL.md — archivo de personalidad
- Memorias — entradas de MEMORY.md y USER.md
- Habilidades — habilidades creadas por el usuario →
~/.loki/skills/openclaw-imports/ - Lista de comandos permitidos — patrones de aprobación
- Configuración de mensajería — configuración de plataformas, usuarios permitidos, directorio de trabajo
- Claves API — secretos en lista de permitidos (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
- Assets de TTS — archivos de audio del espacio de trabajo
- Instrucciones del espacio de trabajo — AGENTS.md (con
--workspace-target)
Consulta loki claw migrate --help para todas las opciones, o usa la habilidad openclaw-migration para una migración guiada interactiva por el agente con vistas previas de dry-run.
Contribuir
¡Las contribuciones son bienvenidas! Consulta la Guía de Contribución para la configuración del desarrollo, el estilo de código y el proceso de PR.
Inicio rápido para colaboradores — clona y comienza con setup-loki.sh:
git clone https://github.com/wundercorp/loki.git
cd loki-agent
./setup-loki.sh # instala uv, crea venv, instala .[all], enlaza ~/.local/bin/loki
./loki # detecta automáticamente el venv, no necesitas hacer `source` primero
Ruta manual (equivalente a lo anterior):
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv .venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh
Comunidad
- 💬 Discord
- 📚 Skills Hub
- 🐛 Issues
- 🔌 computer-use-linux — Servidor MCP de control de escritorio Linux para Loki y otros hosts MCP, con árboles de accesibilidad AT-SPI, entrada Wayland/X11, capturas de pantalla y targeting de ventanas del compositor.
Licencia
MIT — ver LICENSE.
Creado por WunderCorp, Inc..