Costruisci la tua infrastruttura AI personale

Prima di iniziare: Comprendere cosa stai costruendo

Most AI installation guides treat software as a black box: download, install, forget. clawbot is different because you're not installing an app—you're establishing infrastructure . Think of this as setting up your own private email server, except instead of managing messages, you're orchestrating an AI that can genuinely control your digital environment.

This guide explains what each step does and why it matters. Understanding the architecture makes troubleshooting intuitive and customization straightforward.

Prerequisiti: Cosa ti serve realmente

Prima di scaricare qualsiasi cosa, verifica che il tuo sistema soddisfi questi requisiti. Ognuno di essi serve uno scopo specifico:

Requisiti hardware

• Operating System: macOS 11+, Linux (Ubuntu 20.04+, Debian 11+), or Windows 10+ with WSL2
• RAM: Minimum 2GB available (4GB recommended for smoother operation)
• Disk Space: 500MB for core installation plus space for AI model caching
• Network: Stable internet connection for AI API calls (unless using local Ollama)

Dipendenze software

clawbot requires Node.js 22 or higher. Why this specific version? Newer Node.js versions include critical performance improvements and security patches that clawbot's real-time communication relies on. The installer typically handles this, but manual installations require it pre-installed.

Accesso ai modelli AI (scegli uno)

Passo 1: Scarica il pacchetto giusto per la tua piattaforma

clawbot distributes platform-specific installers that bundle everything needed. Why multiple formats? Different operating systems handle background services differently—the installer configures these correctly.

Passo 2: Installa e avvia il Gateway

The Gateway is clawbot's core—a persistent service that manages all communication between messaging platforms, AI models, and your system. Think of it as the central nervous system : channels send messages to the Gateway, which routes them to the appropriate AI model, receives responses, and delivers them back.

Passo 3: Collega il tuo cervello AI

Con il Gateway in esecuzione, necessita di un modello AI per generare risposte. Questo passaggio configura quali modelli utilizzerai e autentica l'accesso API.

{
  "aiProviders": {
    "anthropic": {
      "apiKey": "sk-ant-your-api-key-here",
      "model": "claude-3-5-sonnet-20250219",
      "enabled": true
    }
  },
  "defaultProvider": "anthropic"
}

{
  "aiProviders": {
    "ollama": {
      "baseURL": "http://localhost:11434",
      "model": "llama3.1:8b",
      "enabled": true
    }
  },
  "defaultProvider": "ollama"
}

Passo 4: Collega i tuoi canali di comunicazione

Channels are how you interact with your AI—WhatsApp for mobile, Telegram for desktop, Discord for team collaboration. Each channel connects independently to the Gateway, and clawbot maintains a unified conversation history across all of them .

Canali alternativi

Ogni canale ha requisiti di configurazione unici. Opzioni popolari:

Passo 5: Esegui il tuo primo task autonomo

Con tutto configurato, verifichiamo che clawbot possa effettivamente controllare il tuo sistema, non solo rispondere con testo.

Cosa costruire dopo

La tua infrastruttura AI è operativa. Ecco come espandere le sue capacità:

1. Installa Skill da ClawdHub

Le Skill sono moduli di automazione predefiniti. Sfoglia il marketplace:

Skill di avvio popolari:

• google-calendar : Natural language calendar management
• home-assistant : Smart home control integration
• github-assistant : Repository management and PR reviews
• daily-briefing : Morning summary of calendar, weather, news

2. Crea automazione personalizzata

Skills are just folders with a SKILL.md file. Create your own:

Full guide: docs.clawd.bot/skills/creating

3. Configura comportamenti proattivi

Unlike traditional AI, clawbot can initiate contact. Enable heartbeat monitoring:

Ora clawbot ti invierà proattivamente un riepilogo mattutino senza che tu lo chieda.

4. Esegui il deployment nel cloud (Opzionale)

Eseguire clawbot sul tuo laptop funziona, ma il deployment nel cloud garantisce disponibilità 24/7. Guide disponibili per:

• DigitalOcean Droplets ($6/month)
• AWS EC2 Free Tier (12 months free)
• Hetzner Cloud (€4/month)
• Home Raspberry Pi (one-time hardware cost)

Problemi comuni e soluzioni

Ora stai eseguendo la tua infrastruttura AI

What you've built isn't just a chatbot—it's a personal automation platform that combines the intelligence of frontier AI models with the capability of local system control. Unlike cloud services that constrain what AI can do, your clawbot installation has the same access to your digital environment that you do.

Questo potere comporta responsabilità: clawbot può eseguire qualsiasi comando tu approvi. Il sistema di sandboxing e permessi protegge da danni accidentali, ma in definitiva stai concedendo a un'AI un controllo significativo. Inizia con automazioni semplici, comprendi come vengono prese le decisioni e amplia gradualmente le capacità man mano che costruisci fiducia.