OpenClaw Machines

Esegui tutti gli agenti OpenClaw isolati di cui hai bisogno, su hardware di tua proprietà.

OpenClaw Machines è una piattaforma open-source per eseguire OpenClaw in sandbox AI sicure sulla tua infrastruttura. Un piano di controllo orchestra i tuoi host, e ogni agente viene eseguito nella propria microVM Firecracker su di essi — isolati dall'hardware, sicuri per codice non fidato e generato dall'agente. Un piano dati Cloudflare è la porta d'ingresso: ogni macchina ottiene il proprio sottodominio dietro autenticazione perimetrale, raggiunto attraverso un tunnel che termina all'interno della VM — nessuna porta dell'host è esposta per il traffico utente-VM. L'attuale piano di controllo necessita ancora di accesso privato o limitato da firewall all'API di controllo autenticata di ciascun agente sulla porta 9090. Vedilo in esecuzione su openclawmachines.com.

Il nucleo pubblico con licenza Apache-2.0 include ogni componente di quella pila:

• un piano di controllo minimale — API Go, account basati su Postgres, macchine e host; posizionamento, ciclo di vita delle macchine, registrazione degli host, backup e workflow durevoli;
• l'agente host (ocm-agent) — avvia, supervisiona e pulisce le microVM Firecracker sulle tue macchine Linux registrate, gestendo il networking bridge/TAP e la preparazione del rootfs;
• un proxy LLM per host (LiteLLM) — un unico punto per chiavi modello e supporto BYO-key, con tracciamento dell'utilizzo per macchina tra diversi provider (o i tuoi modelli serviti localmente);
• il runtime OpenClaw — i componenti all'interno della VM: proxy di autenticazione, gateway web-chat, terminale live e il flusso di staging/aggiornamento del runtime guidato dagli artefatti;
• il runtime browser — VM browser Chromium abbinate con routing CDP e una vista live osservabile;
• integrazioni workspace / MCP nativo — GitHub, Google Workspace, OpenAPI, GraphQL e strumenti MCP remoti connessi una volta per workspace ed esposti alle macchine tramite la facciata MCP di OCM;

La CLI ocm risiede nel repository separato mathaix/ocm-cli con licenza Apache-2.0.

Collegamento video

Clicca sullo screenshot per guardare la demo di 43 secondi su YouTube. Questa è un'immagine collegata, non un lettore incorporato.

La demo copre l'onboarding dell'host, l'avvio dell'agente, il terminale della VM Firecracker in esecuzione, le integrazioni MCP del workspace e una chiamata a strumento dell'agente end-to-end.

Perché OpenClaw Machines

• Sicurezza. Isolamento reale, non contenitori: una microVM Firecracker per agente, con il proprio kernel guest dietro un confine hardware KVM — e autenticazione applicata al perimetro e di nuovo all'interno di ogni VM.
• Costo. Un costo fisso per server: noleggia una singola macchina bare-metal ed esegui tutti gli agenti isolati dall'hardware che può contenere — vedi come si confrontano le opzioni. La stessa architettura taglia anche la spesa per i token: indirizza gli agenti a modelli open-source in esecuzione sulla tua GPU hardware invece di pagare API per token.
• Sovranità. Il tuo hardware, i tuoi dati, le tue chiavi. Esegui il piano di controllo e i worker su macchine di tua proprietà, e indirizza il traffico dei modelli attraverso il proxy LLM per host a qualsiasi provider — o a modelli serviti dalle tue GPU.
• Open source. Nucleo pubblico Apache-2.0 e CLI ocm di accompagnamento, con licenza permissiva per adozione, embedding e contribuzione.
• Enterprise. Account multi-utente e team, gestione host amministrata, segreti crittografati per macchina, e politiche di capacità/posizionamento nella tua flotta.
• Ecosistema. VM browser per automazione web, terminale live e chat web, routing per VM, integrazioni MCP native con ambito workspace, backup/snapshot, memoria agente, e osservabilità con tracing OpenTelemetry/Opik e tracciamento dell'utilizzo per macchina.

Come si confrontano le opzioni

Se oggi esegui OpenClaw, hai alcune opzioni:

1. Hardware locale — eseguilo sul tuo laptop o desktop.
2. Un VPS (es. Hostinger, DigitalOcean) — noleggia un server virtuale ed eseguilo lì.
3. Un servizio gestito (es. KiloClaw) — avvia un'istanza OpenClaw ospitata e paga per istanza.

OpenClaw Machines è la quarta opzione: noleggia un server bare-metal (OVHcloud, Hetzner, …), punta OpenClaw Machines su di esso, e avvia tutte le istanze OpenClaw isolate dall'hardware che il server può contenere. Un agente o cinquanta — il costo rimane un singolo server fisso.

In breve: la via gestita è la più semplice ma ha un costo per agente; locale e VPS sono economici all'inizio ma non isolano o scalano bene. OpenClaw Machines sacrifica un po' più di configurazione per la migliore economia e isolamento una volta che esegui più di un paio di agenti — un server, molti agenti isolati dall'hardware, tutti tuoi.

Come funziona

OpenClaw Machines trasforma i tuoi server Linux in un pool di sandbox sicure e on-demand. Ogni sandbox è una vera microVM Firecracker (kernel proprio, isolata dall'hardware tramite KVM) che esegue un agente AI. La piattaforma è il piano di controllo che crea quelle VM, le tiene traccia, instrada il traffico verso di esse e le abbatte — così puoi eseguire molti agenti non fidati in sicurezza su infrastruttura di tua proprietà. Pensa: una mini-cloud per agenti AI, che ospiti tu stesso.

1. Piano di controllo (backend Go) — il cervello. Account, macchine, host e configurazione; l'API che UI/CLI chiamano; orchestrazione del posizionamento e del ciclo di vita.
2. Host + agenti worker — i tuoi box Linux. Registra un host con uno script di installazione; il suo agente worker avvia e ferma le microVM Firecracker quando gli viene detto.
3. Macchine — una microVM isolata per agente. All'interno: l'agente OpenClaw, un gateway web chat e un terminale live.
4. VM browser — microVM separate che eseguono Chromium con interfaccia grafica con una vista live, guidate dall'agente tramite CDP per automazione browser.
5. Routing / piano dati — ogni VM in esecuzione ottiene il proprio sottodominio e un tunnel Cloudflare che termina all'interno della VM, con autenticazione applicata al perimetro e di nuovo nella VM.
6. Integrazioni workspace (MCP nativo) — connetti strumenti esterni una volta per workspace (GitHub, Google Workspace o qualsiasi endpoint OpenAPI / GraphQL / MCP remoto); il piano di controllo li espone all'agente di ogni macchina attraverso un singolo server MCP integrato, così l'agente li scopre e li chiama con ocm.search_tools / ocm.call_tool invece di cablaggi per integrazione.

flowchart TB
    U["tu — browser / CLI ocm"] --> EDGE["Edge Cloudflare<br/>Autenticazione Access · Ricerca route Worker (KV)"]
    EDGE -->|dashboard / API| CP["Piano di controllo (Go)<br/>account · macchine · host<br/>posizionamento · ciclo di vita · backup"]
    CP --- DB[("Postgres")]
    CP -->|registra · heartbeat · avvia/ferma :9090| H1["Host 1 — tuo box Linux<br/>ocm-agent · proxy LLM · proxy CDP"]
    CP -->|…| HN["Host N"]
    EDGE -->|tunnel per VM, termina dentro la VM| VM1
    subgraph H1X["MicroVM dell'Host 1"]
        VM1["Macchina — microVM Firecracker<br/>Agente OpenClaw · web chat · terminale<br/>authproxy + cloudflared dentro"]
        BVM["VM Browser<br/>Chromium con interfaccia · vista live"]
        VM1 -->|CDP| BVM
    end
    H1 --- H1X

Il design completo — piano dati, routing, tunnel, ciclo di vita, configurazione e il flusso di build/rilascio — si trova in docs/architecture.md e la pila a cinque livelli (UI React → Edge Cloudflare → Piano di controllo Go → Agenti host → Sandbox Firecracker) è in docs/tech-stack.md.

Requisiti

OpenClaw Machines esegue microVM Firecracker, che richiedono KVM. Hai bisogno di un host Linux con KVM abilitato: bare metal, o una VM cloud con virtualizzazione annidata abilitata. Non funziona su macOS, Windows/WSL o una VM cloud standard senza virtualizzazione annidata.

Controlla il tuo host:

make preflight

Per iniziare

La guida Per iniziare è composta da tre fasi, ciascuna conclude con qualcosa che funziona:

Usi un agente di codifica? Puntalo su docs/getting-started.md e chiedigli di seguire la guida dalla Fase 1.

1. Valutazione locale — l'intera pila + una vera macchina Firecracker su un singolo box Linux con KVM. Nessun Cloudflare o dominio pubblico richiesto; usa un host KVM esistente o l'esempio di provisioning GCP opzionale.
2. Cloudflare + un host dedicato — il deployment con forma di produzione: dominio, tunnel, autenticazione perimetrale e un host cloud o bare-metal registrato.
3. Il flusso di lavoro completo — crea e usa macchine (chat, terminale, VM browser), ciclo di vita, backup, aggiornamenti del runtime.

Documentazione del progetto

• Per iniziare — la guida a tre fasi sopra
• Guida utente — usare una macchina giorno per giorno (modello, chat, terminale, VM browser, file, log, tracce, backup)
• Integrazioni workspace / MCP nativo — connetti GitHub, Google Workspace, OpenAPI, GraphQL e strumenti MCP remoti una volta per workspace
• Architettura — piano dati, routing, tunnel, ciclo di vita, integrazioni workspace / MCP nativo
• Pila tecnologica — i cinque livelli, dal client alla sandbox
• Configurazione locale e BYO-host
• Profili di deployment del piano di controllo
• Prerequisiti per piano di controllo self-hosted
• Runbook operatore LLM
• Inventario documentazione pubblica
• Contribuire · Politica di sicurezza · Codice di condotta
• Progetto CLI ocm

Community e supporto

• Discussioni GitHub — domande, idee, mostra e racconta
• Problemi — bug e richieste di funzionalità
• Roadmap — il tracker di prontezza open-source: cosa è fatto, cosa c'è dopo
• Hai trovato una vulnerabilità? Vedi la politica di sicurezza.

Contribuire

Vedi CONTRIBUTING.md e il codice di condotta.

Licenza

Apache-2.0