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 (Zeabur AI Hub 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 Zeabur AI Hub es openai/claude-sonnet-4-5, con OpenRouter es openrouter/anthropic/claude-sonnet-4. 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
Zeabur AI Hub	zeabur.com/ai-hub	"openai": {"api_key":"...","api_base":"https://hnd1.aihub.zeabur.ai/v1"}	openai/claude-sonnet-4-5
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.