Nanobot

⚠️ Esta plantilla requiere un Dedicated Server en Zeabur y no puede ejecutarse en clusters compartidos.

Recursos recomendados: 1 vCPU / 2 GB RAM (minimo: 0.5 vCPU / 256 MB RAM)

Nanobot es un framework de asistente personal de IA ultraligero (~4K lineas de codigo de agente central) de HKUDS. Soporta multiples proveedores de LLM y se conecta a varias plataformas de mensajeria a traves de una arquitectura Gateway unificada.

Documentacion oficial: github.com/HKUDS/nanobot

Plataformas de Chat Soportadas

Telegram, Discord, WhatsApp, Slack, DingTalk, Feishu, QQ y correo electronico.

Inicio Rapido

1. Despues del despliegue, la puerta de enlace de Nanobot se inicia automaticamente
2. Si ingreso una clave API durante el despliegue (su propio proveedor compatible con OpenAI u OpenRouter), el modelo de chat ya esta configurado
3. Si ingreso un token de bot de Telegram, el bot esta listo — envie un mensaje para comenzar
4. Para agregar mas plataformas o cambiar configuracion, edite /root/.nanobot/config.json en la pestana Files

Omitio un campo durante el despliegue? Puede agregarlo despues editando /root/.nanobot/config.json en la pestana Files, o agregando la variable de entorno correspondiente en el panel de Zeabur y reiniciando el servicio.

Modelo predeterminado: Con su propio proveedor compatible con OpenAI es el Modelo de LLM que configure (p. ej. gpt-4o-mini), con OpenRouter es openrouter/anthropic/claude-sonnet-4, sin clave es anthropic/claude-opus-4-5. Puede cambiarlo en el archivo de configuracion en cualquier momento.

Proveedores de LLM

Nanobot soporta multiples proveedores. Puede cambiar en cualquier momento editando /root/.nanobot/config.json en la pestana Files y reiniciando el servicio.

Proveedor	Obtener clave API	Configuracion providers	Ejemplo de Model ID
Compatible con OpenAI (propio)	el panel de su proveedor	"openai": {"api_key":"...","api_base":"https://api.openai.com/v1"}	gpt-4o-mini
OpenRouter	openrouter.ai/keys	"openrouter": {"api_key":"sk-or-..."}	openrouter/anthropic/claude-sonnet-4
Anthropic	console.anthropic.com	"anthropic": {"api_key":"sk-ant-..."}	anthropic/claude-sonnet-4-5
OpenAI	platform.openai.com	"openai": {"api_key":"sk-..."}	openai/gpt-4o
DeepSeek	platform.deepseek.com	"deepseek": {"api_key":"..."}	deepseek/deepseek-chat

Para cambiar de proveedor:

1. Abra /root/.nanobot/config.json en la pestana Files
2. Agregue o modifique la configuracion del proveedor en "providers"
3. Cambie "agents" > "defaults" > "model" al nuevo Model ID
4. Reinicie el servicio para aplicar los cambios

Plataformas de Chat

Soportadas: Telegram, Discord, WhatsApp, Slack, DingTalk, Feishu, QQ y correo electronico. Consulte la documentacion oficial para guias completas de configuracion.

Configuracion de Telegram:

1. Busque @BotFather en Telegram y envie /newbot
2. Siga las instrucciones para configurar el nombre y username del bot
3. Copie el token del bot que reciba
4. Ingreselo durante el despliegue o agreguelo al config despues

Si ingreso el token del bot durante el despliegue, ya esta activo. De lo contrario, agregue en config:

"channels": {
  "telegram": { "enabled": true, "token": "BOT_TOKEN", "allow_from": [] }
}

Otras plataformas — agregue el canal correspondiente en config y reinicie:

"channels": {
  "discord": { "enabled": true, "token": "BOT_TOKEN", "allow_from": [] }
}

allow_from — controla quien puede hablar con el bot. Lista vacia [] = cualquiera puede usarlo. Para restringir acceso, agregue IDs de usuario (en Telegram, envie un mensaje a @userinfobot para obtener su ID):

"allow_from": ["123456789", "987654321"]

Reinicie el servicio despues de cambios en la configuracion.

Persistencia de Datos

Todos los datos se almacenan en /root/.nanobot (montado como volumen persistente).

Se recomienda usar la funcion de respaldo de Zeabur para respaldar sus datos regularmente.

Mas informacion: Consulte la documentacion oficial.