nanobot

Utente

Nome utente: nanobot

Il servizio gateway viene eseguito con l'utente nanobot utente

Puoi accedere al sistema in due modi.

1. SSH direttamente come nanobot

ssh nanobot@<SERVER_IP>

Password:

cat /root/.cloudzy-creds

2. Accedi come root e cambia utente

ssh root@<SERVER_IP>
su - nanobot

Utilizzo

0. SSH nel server

Connettiti al server come root:

ssh root@<SERVER_IP>

Accedi con la tua password.

1. Passa all'utente dell'applicazione

su -  nanobot

Nanobot non può essere eseguito come utente root.

2. Configurazione

Modifica il file di configurazione: /home/nanobot/.nanobot/config.json

Configura queste due sezioni nel file di configurazione (le altre opzioni hanno valori predefiniti).

Aggiungi o unisci i seguenti blocchi alla configurazione esistente, senza sostituire l'intero file.

Blocco providers (chiave API)

Imposta la tua chiave API (es. OpenRouter, consigliato per gli utenti globali):

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-xxx"
    }
  }
}

Blocco agents (model)

Imposta il tuo model (facoltativamente specifica un provider; altrimenti viene rilevato automaticamente):

{
  "agents": {
    "defaults": {
      "provider": "openrouter",
      "model": "anthropic/claude-opus-4-6"
    }
  }
}

3. Riavvia gateway

Al termine della configurazione, riavvia il servizio gateway per applicare le modifiche e abilitare la connettività con applicazioni di chat come Telegram:

sudo systemctl restart nanobot-gateway

nanobot password utente: salvata in /root/.cloudzy-creds

4. Chat

Avvia la chat interattiva:

nanobot agent

Invia un singolo prompt:

nanobot agent -m "Hello!"

Integrazione Telegram

1. Crea bot

Apri Telegram:

• Cerca: @BotFather
• Esegui /newbot
• Copia il token del bot

2. Configura nanobot

Modifica configurazione: /home/nanobot/.nanobot/config.json

Aggiungi o unisci i seguenti blocchi alla configurazione esistente, senza sostituire l'intero file.

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allowFrom": ["YOUR_USER_ID"]
    }
  }
}

Imposta enabled a true.

YOUR_BOT_TOKEN è il token che ricevi da BotFather quando crei il bot Telegram.

YOUR_USER_ID è il tuo ID utente Telegram. Lo trovi nelle impostazioni di Telegram, visualizzato come @yourUserId. Copia questo valore senza il simbolo @ e incollalo nel file di configurazione.

4. Riavviare il servizio

sudo systemctl restart nanobot-gateway

File e directory importanti

• Home utente: /home/nanobot
• Dati app: /home/nanobot/.nanobot
• File di configurazione: /home/nanobot/.nanobot/config.json
• Binario CLI: /home/nanobot/.local/bin/nanobot
• Servizio Systemd: /etc/systemd/system/nanobot-gateway.service
• File di credenziali: /root/.cloudzy-creds

Note

• Dopo qualsiasi modifica alla configurazione: systemctl restart nanobot-gateway
• Il servizio si avvia automaticamente all'avvio del sistema
• Usa systemctl e i piani journalctl per la gestione
• Ripristina nanobot password utente (come root): passwd nanobot