OpenClaw Machines

Exécutez autant d'agents OpenClaw isolés que nécessaire, sur votre propre matériel.

OpenClaw Machines est une plateforme open source pour exécuter OpenClaw dans des sandbox sécurisées pour l'IA sur votre propre infrastructure. Un plan de contrôle orchestre vos hôtes, et chaque agent s'exécute dans son propre Firecracker microVM sur ceux-ci — isolé au niveau matériel, sûr pour le code non fiable et généré par l'agent. Un plan de données Cloudflare sert de porte d'entrée : chaque machine obtient son propre sous-domaine derrière une authentification périphérique, accessible via un tunnel qui se termine à l'intérieur de la VM — aucun port hôte n'est exposé pour le trafic utilisateur-VM. Le plan de contrôle actuel nécessite toujours un accès privé ou restreint par pare-feu à l'API de contrôle authentifiée de chaque agent sur 9090. Voyez-le en fonctionnement sur openclawmachines.com.

Le noyau public sous licence Apache-2.0 fournit chaque élément de cette pile :

• un plan de contrôle minimal — API Go, comptes Postgres, machines et hôtes ; placement, cycle de vie des machines, inscription des hôtes, sauvegardes et workflows durables ;
• l'agent hôte (ocm-agent) — démarre, supervise et supprime les microVM Firecracker sur vos machines Linux inscrites, gérant le réseau bridge/TAP et la mise en place du système de fichiers racine ;
• un proxy LLM par hôte (LiteLLM) — un seul endroit pour les clés de modèle et la prise en charge BYO-key, avec un suivi d'utilisation par machine entre les fournisseurs (ou vos propres modèles servis localement) ;
• l'exécution OpenClaw — les éléments dans la VM : proxy d'authentification, passerelle de chat web, terminal en direct et le flux de mise en scène / mise à niveau piloté par artefact ;
• l'exécution navigateur — des VM de navigateur Chromium couplées avec routage CDP et une vue en direct regardable ;
• les intégrations d'espace de travail / MCP natif — GitHub, Google Workspace, OpenAPI, GraphQL et outils MCP distants connectés une fois par espace de travail et exposés aux machines via la façade MCP d'OCM ;

L'interface en ligne de commande ocm réside dans le dépôt Apache-2.0 séparé mathaix/ocm-cli.

Lien vidéo

Cliquez sur la capture d'écran pour regarder la démo de 43 secondes sur YouTube. Il s'agit d'une image liée, pas d'un lecteur intégré.

La démo couvre l'intégration d'un hôte, le démarrage d'un agent, le terminal de la VM Firecracker en cours d'exécution, les intégrations MCP de l'espace de travail, et un appel d'outil d'agent de bout en bout.

Pourquoi OpenClaw Machines

• Sécurité. Une véritable isolation, pas des conteneurs : une microVM Firecracker par agent, avec son propre noyau invité derrière une barrière matérielle KVM — et une authentification appliquée en périphérie et à nouveau à l'intérieur de chaque VM.
• Coût. Un coût de serveur fixe unique : louez une seule machine nue et exécutez autant d'agents isolés matériellement qu'elle peut en contenir — voir comment les options se comparent. La même architecture réduit également les dépenses en tokens : acheminez les agents vers des modèles open source fonctionnant sur votre propre GPU au lieu de payer des API par token.
• Souveraineté. Votre matériel, vos données, vos clés. Exécutez le plan de contrôle et les workers sur des machines que vous possédez, et acheminez le trafic des modèles via le proxy LLM par hôte vers n'importe quel fournisseur — ou vers des modèles servis sur vos propres GPU.
• Open source. Noyau public Apache-2.0 et ocm CLI compagnon, sous licence permissive pour adoption, intégration et contribution.
• Entreprise. Comptes multi-utilisateurs et équipes, gestion des hôtes restreinte aux administrateurs, secrets cryptés par machine et politiques de capacité/placement sur votre flotte.
• Écosystème. VM navigateur pour l'automatisation web, terminal en direct et chat web, routage par VM, intégrations MCP natives limitées à l'espace de travail, sauvegardes/instantanés, mémoire d'agent et observabilité avec traçage OpenTelemetry/Opik et suivi d'utilisation par machine.

Comment les options se comparent

Si vous exécutez OpenClaw aujourd'hui, vous avez quelques options :

1. Matériel local — exécutez-le sur votre propre ordinateur portable ou de bureau.
2. Un VPS (par ex. Hostinger, DigitalOcean) — louez un serveur virtuel et exécutez-le là-bas.
3. Un service géré (par ex. KiloClaw) — lancez une instance OpenClaw hébergée et payez par instance.

OpenClaw Machines est la quatrième option : louez un serveur nu (OVHcloud, Hetzner, …), pointez OpenClaw Machines dessus et lancez autant d'instances OpenClaw isolées matériellement que la machine peut en contenir. Un agent ou cinquante — le coût reste un serveur fixe unique.

En bref : la voie gérée est la plus simple mais facturée par agent ; local et VPS sont bon marché pour commencer mais n'isolent ou ne passent à l'échelle efficacement. OpenClaw Machines demande un peu plus de configuration pour les meilleures économies et la meilleure isolation une fois que vous exécutez plus de quelques agents — un serveur, de nombreux agents isolés matériellement, tout à vous.

Comment ça fonctionne

OpenClaw Machines transforme vos propres serveurs Linux en un pool de sandbox sécurisées à la demande. Chaque sandbox est une véritable microVM Firecracker (son propre noyau, isolée matériellement via KVM) qui exécute un agent IA. La plateforme est le plan de contrôle qui crée ces VM, les suit, achemine le trafic vers elles et les détruit — afin que vous puissiez exécuter de nombreux agents non fiables en toute sécurité sur une infrastructure que vous possédez. Pensez à un mini-cloud pour les agents IA, que vous auto-hébergez.

1. Plan de contrôle (backend Go) — le cerveau. Comptes, machines, hôtes et configuration ; l'API que l'interface utilisateur / CLI appellent ; orchestration du placement et du cycle de vie.
2. Hôtes + agents workers — vos machines Linux. Inscrivez un hôte avec un script d'installation ; son agent worker démarre et arrête les microVM Firecracker lorsque cela lui est demandé.
3. Machines — une microVM isolée par agent. À l'intérieur : l'agent OpenClaw, une passerelle de chat web et un terminal en direct.
4. VM navigateur — des microVM séparées exécutant Chromium avec une vue en direct, piloté par l'agent via CDP pour l'automatisation du navigateur.
5. Routage / plan de données — chaque VM en cours d'exécution obtient son propre sous-domaine et un Tunnel Cloudflare qui se termine à l'intérieur de la VM, avec authentification appliquée en périphérie et à nouveau dans la VM.
6. Intégrations d'espace de travail (MCP natif) — connectez des outils externes une fois par espace de travail (GitHub, Google Workspace, ou tout endpoint OpenAPI / GraphQL / MCP distant) ; le plan de contrôle les expose à l'agent de chaque machine via un seul serveur MCP intégré, afin que l'agent les découvre et les appelle avec ocm.search_tools / ocm.call_tool au lieu d'un câblage par intégration.

flowchart TB
    U["you — browser / ocm CLI"] --> EDGE["Cloudflare edge<br/>Access auth · Worker route lookup (KV)"]
    EDGE -->|dashboard / API| CP["Control plane (Go)<br/>accounts · machines · hosts<br/>placement · lifecycle · backups"]
    CP --- DB[("Postgres")]
    CP -->|enroll · heartbeat · boot/stop :9090| H1["Host 1 — your Linux box<br/>ocm-agent · LLM proxy · CDP proxy"]
    CP -->|…| HN["Host N"]
    EDGE -->|per-VM tunnel, terminates inside the VM| VM1
    subgraph H1X["Host 1's microVMs"]
        VM1["Machine — Firecracker microVM<br/>OpenClaw agent · web chat · terminal<br/>authproxy + cloudflared inside"]
        BVM["Browser VM<br/>headful Chromium · live view"]
        VM1 -->|CDP| BVM
    end
    H1 --- H1X

La conception complète — plan de données, routage, tunnels, cycle de vie, configuration et le flux de build / publication — se trouve dans docs/architecture.md, et la pile à cinq couches (interface React → périphérie Cloudflare → plan de contrôle Go → agents hôtes → sandbox Firecracker) se trouve dans docs/tech-stack.md.

Prérequis

OpenClaw Machines exécute des microVM Firecracker, qui nécessitent KVM. Vous avez besoin d'un hôte Linux compatible KVM : machine nue, ou une VM cloud avec virtualisation imbriquée activée. Cela ne fonctionne pas sur macOS, Windows/WSL, ou une VM cloud standard sans virtualisation imbriquée.

Vérifiez votre hôte :

make preflight

Pour commencer

Le guide de démarrage comporte trois étapes, chacune se terminant par quelque chose qui fonctionne :

Vous utilisez un agent de codage ? Pointez-le vers docs/getting-started.md et demandez-lui de suivre le guide à partir de l'étape 1.

1. Évaluation locale — la pile complète + une vraie machine Firecracker sur un seul boîtier Linux compatible KVM. Aucun Cloudflare ou domaine public requis ; utilisez un hôte KVM existant ou l'exemple d'approvisionnement GCP optionnel.
2. Cloudflare + un hôte dédié — le déploiement en forme de production : domaine, tunnels, authentification périphérique et un hôte cloud ou nu inscrit.
3. Le workflow complet — créez et utilisez des machines (chat, terminal, VM navigateur), cycle de vie, sauvegardes, mises à niveau d'exécution.

Documentation du projet

• Pour commencer — le guide en trois étapes ci-dessus
• Guide utilisateur — utiliser une machine au quotidien (modèle, chat, terminal, VM navigateur, fichiers, journaux, traces, sauvegardes)
• Intégrations d'espace de travail / MCP natif — connectez GitHub, Google Workspace, OpenAPI, GraphQL et outils MCP distants une fois par espace de travail
• Architecture — plan de données, routage, tunnels, cycle de vie, intégrations d'espace de travail / MCP natif
• Pile technique — les cinq couches, du client à la sandbox
• Configuration locale et BYO-host
• Profils de déploiement du plan de contrôle
• Prérequis du plan de contrôle auto-hébergé
• Runbook de l'opérateur LLM
• Inventaire de la documentation publique
• Contribuer · Politique de sécurité · Code de conduite
• Projet ocm CLI

Communauté et support

• Discussions GitHub — questions, idées, présentations
• Problèmes — bogues et demandes de fonctionnalités
• Feuille de route — le suivi de préparation open source : ce qui est fait, ce qui vient
• Vous avez trouvé une vulnérabilité ? Consultez la politique de sécurité.

Contribuer

Voir CONTRIBUTING.md et le code de conduite.

Licence

Apache-2.0