Usuario
Nombre de usuario: nanobot
El servicio de gateway se ejecuta bajo nanobot usuario.
Puedes acceder al sistema de dos formas.
1. SSH directamente como nanobot
ssh nanobot@<SERVER_IP>
Contraseña:
cat /root/.cloudzy-creds
2. Inicia sesión como root y cambia de usuario
ssh root@<SERVER_IP>
su - nanobot
Uso
0. SSH al servidor
Conéctate a tu servidor como root:
ssh root@<SERVER_IP>
Inicia sesión con tu contraseña.
1. Cambia al usuario de la aplicación
su - nanobot
Nanobot no puede ejecutarse como usuario root.
2. Configuración
Edita el archivo de configuración: /home/nanobot/.nanobot/config.json
Configura estas dos secciones en tu archivo de configuración (el resto de opciones tienen valores por defecto).
Añade o combina los siguientes bloques en tu configuración existente en lugar de reemplazar el archivo completo.
Bloque de proveedores (clave API)
Establece tu clave API (p. ej. OpenRouter, recomendado para usuarios globales):
{
"providers": {
"openrouter": {
"apiKey": "sk-or-v1-xxx"
}
}
}
Bloque de agentes (modelo)
Configura tu modelo (opcionalmente fija un proveedor; por defecto se detecta automáticamente):
{
"agents": {
"defaults": {
"provider": "openrouter",
"model": "anthropic/claude-opus-4-6"
}
}
}
3. Reiniciar el gateway
Una vez completada la configuración, reinicia el servicio gateway para aplicar los cambios y habilitar la conectividad con aplicaciones de chat como Telegram:
sudo systemctl restart nanobot-gateway
nanobot contraseña de usuario: almacenada en /root/.cloudzy-creds
4. Chat
Iniciar chat interactivo:
nanobot agent
Enviar un único mensaje:
nanobot agent -m "Hello!"
Integración con Telegram
1. Crear bot
Abre Telegram:
- Busca: @BotFather
- Ejecuta
/newbot - Copia el token del bot
2. Configurar nanobot
Edita la configuración: /home/nanobot/.nanobot/config.json
Añade o combina los siguientes bloques en tu configuración existente en lugar de reemplazar el archivo completo.
{
"channels": {
"telegram": {
"enabled": true,
"token": "YOUR_BOT_TOKEN",
"allowFrom": ["YOUR_USER_ID"]
}
}
}
Establece enabled a true.
YOUR_BOT_TOKEN es el token que recibes de BotFather al crear el bot de Telegram.
YOUR_USER_ID es tu ID de usuario de Telegram. Puedes encontrarlo en los ajustes de Telegram. Aparece como @yourUserId. Copia este valor sin el @ símbolo y pégalo en el archivo de configuración.
4. Reiniciar el servicio
sudo systemctl restart nanobot-gateway
Archivos y directorios importantes
- Directorio del usuario:
/home/nanobot - Datos de la app:
/home/nanobot/.nanobot - Archivo de configuración:
/home/nanobot/.nanobot/config.json - Binario de CLI:
/home/nanobot/.local/bin/nanobot - Servicio systemd:
/etc/systemd/system/nanobot-gateway.service - Archivo de credenciales:
/root/.cloudzy-creds
Notas
- Tras cualquier cambio de configuración:
systemctl restart nanobot-gateway - El servicio se inicia automáticamente al arrancar
- Usa
systemctlyjournalctlpara la gestión - Restablecer
nanobotcontraseña de usuario (como root):passwd nanobot