OpenClaw Machines

Execute quantos agentes OpenClaw isolados você precisar, em hardware que você possui.

OpenClaw Machines é uma plataforma de código aberto para executar OpenClaw em sandboxes de IA seguras em sua própria infraestrutura. Um plano de controle orquestra seus hosts, e cada agente é executado em sua própria microVM Firecracker neles — isolada por hardware, segura para código não confiável e gerado por agentes. Um plano de dados do Cloudflare é a porta de entrada: cada máquina obtém seu próprio subdomínio por trás da autenticação de borda, acessado através de um túnel que termina dentro da VM — nenhuma porta do host é exposta para o tráfego do usuário para a VM. O plano de controle atual ainda precisa de acesso privado ou restrito por firewall à API de controle autenticada de cada agente na porta 9090. Veja em execução em openclawmachines.com.

O núcleo público Apache-2.0 inclui cada peça dessa pilha:

• um plano de controle mínimo — API Go, contas, máquinas e hosts baseados em Postgres; alocação, ciclo de vida da máquina, inscrição de host, backups e fluxos de trabalho duráveis;
• o agente host (ocm-agent) — inicializa, supervisiona e encerra microVMs Firecracker em seus servidores Linux inscritos, gerenciando rede bridge/TAP e preparação de rootfs;
• um proxy LLM por host (LiteLLM) — um único local para chaves de modelo e suporte BYO-key, com rastreamento de uso por máquina entre provedores (ou seus próprios modelos servidos localmente);
• o runtime OpenClaw — as peças dentro da VM: proxy de autenticação, gateway de chat web, terminal ao vivo e o fluxo de preparação/atualização do runtime orientado a artefatos;
• o runtime do navegador — VMs de navegador Chromium emparelhadas com roteamento CDP e uma visualização ao vivo assistível;
• integrações de workspace / MCP nativo — ferramentas GitHub, Google Workspace, OpenAPI, GraphQL e MCP remoto conectadas uma vez por workspace e expostas às máquinas através da fachada MCP do OCM;

O CLI ocm reside no repositório separado mathaix/ocm-cli sob licença Apache-2.0.

Link do vídeo

Clique na captura de tela para assistir à demonstração de 43 segundos no YouTube. Esta é uma imagem com link, não um player incorporado.

A demonstração cobre a integração do host, a inicialização do agente, o terminal da VM Firecracker em execução, as integrações MCP do workspace e uma chamada de ferramenta do agente de ponta a ponta.

Por que OpenClaw Machines

• Segurança. Isolamento real, não contêineres: uma microVM Firecracker por agente, com seu próprio kernel convidado por trás de uma fronteira de hardware KVM — e autenticação aplicada na borda e novamente dentro de cada VM.
• Custo. Um custo fixo de servidor: alugue um único servidor bare-metal e execute quantos agentes isolados por hardware couberem — veja como as opções se comparam. A mesma arquitetura também reduz gastos com tokens: direcione agentes para modelos de código aberto em execução em seu próprio hardware GPU em vez de pagar APIs por token.
• Soberania. Seu hardware, seus dados, suas chaves. Execute o plano de controle e os workers em máquinas que você possui e direcione o tráfego de modelo através do proxy LLM por host para qualquer provedor — ou para modelos servidos em suas próprias GPUs.
• Código aberto. Núcleo público Apache-2.0 e o ocm CLI complementar, licenciados de forma permissiva para adoção, incorporação e contribuição.
• Empresarial. Contas multiusuário e equipes, gerenciamento de host com controle de administrador, segredos criptografados por máquina e políticas de capacidade/alocação em toda a sua frota.
• Ecossistema. VMs de navegador para automação web, terminal ao vivo e chat web, roteamento por VM, integrações MCP nativas no escopo do workspace, backups/snapshots, memória do agente e observabilidade com rastreamento OpenTelemetry/Opik e rastreamento de uso por máquina.

Como as opções se comparam

Se você executa OpenClaw hoje, tem algumas opções:

1. Hardware local — execute em seu próprio laptop ou desktop.
2. Um VPS (ex.: Hostinger, DigitalOcean) — alugue um servidor virtual e execute lá.
3. Um serviço gerenciado (ex.: KiloClaw) — inicie uma instância OpenClaw hospedada e pague por instância.

OpenClaw Machines é a quarta opção: alugue um servidor bare-metal (OVHcloud, Hetzner, …), aponte o OpenClaw Machines para ele e inicie quantas instâncias isoladas por hardware do OpenClaw o servidor suportar. Um agente ou cinquenta — o custo permanece um único servidor fixo.

Em resumo: a rota gerenciada é a mais fácil, mas com preço por agente; local e VPS são baratos para começar, mas não isolam ou escalam bem. OpenClaw Machines troca um pouco mais de configuração pela melhor economia e isolamento assim que você estiver executando mais do que alguns agentes — um servidor, muitos agentes isolados por hardware, todos seus.

Como funciona

OpenClaw Machines transforma seus próprios servidores Linux em um pool de sandboxes seguras e sob demanda. Cada sandbox é uma microVM Firecracker real (seu próprio kernel, isolada por hardware via KVM) que executa um agente de IA. A plataforma é o plano de controle que cria essas VMs, as rastreia, roteia tráfego para elas e as derruba — para que você possa executar muitos agentes não confiáveis com segurança em infraestrutura que você possui. Pense: uma mini-nuvem para agentes de IA, que você auto-hospeda.

1. Plano de controle (backend Go) — o cérebro. Contas, máquinas, hosts e configuração; a API que a UI/CLI chama; orquestração de alocação e ciclo de vida.
2. Hosts + agentes worker — seus servidores Linux. Inscreva um host com um script de instalação; seu agente worker inicializa e para microVMs Firecracker quando solicitado.
3. Máquinas — uma microVM isolada por agente. Dentro: o agente OpenClaw, um gateway de chat web e um terminal ao vivo.
4. VMs de navegador — microVMs separadas executando Chromium com interface gráfica e visualização ao vivo, dirigidas pelo agente via CDP para automação de navegador.
5. Roteamento / plano de dados — cada VM em execução obtém seu próprio subdomínio e um Tunnel do Cloudflare que termina dentro da VM, com autenticação aplicada na borda e novamente dentro da VM.
6. Integrações de workspace (MCP nativo) — conecte ferramentas externas uma vez por workspace (GitHub, Google Workspace ou qualquer endpoint OpenAPI / GraphQL / MCP remoto); o plano de controle as expõe ao agente de cada máquina através de um único servidor MCP integrado, para que o agente as descubra e chame com ocm.search_tools / ocm.call_tool em vez de configuração por integração.

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

O design completo — plano de dados, roteamento, túneis, ciclo de vida, configuração e fluxo de build/release — está em docs/architecture.md, e a pilha de cinco camadas (React UI → borda Cloudflare → plano de controle Go → agentes host → sandboxes Firecracker) está em docs/tech-stack.md.

Requisitos

OpenClaw Machines executa microVMs Firecracker, que exigem KVM. Você precisa de um host Linux com KVM habilitado: bare metal ou uma VM na nuvem com virtualização aninhada habilitada. Não funciona em macOS, Windows/WSL ou uma VM padrão na nuvem sem virtualização aninhada.

Verifique seu host:

make preflight

Primeiros passos

O guia de primeiros passos tem três etapas, cada uma terminando com algo funcionando:

Usando um agente de codificação? Aponte-o para docs/getting-started.md e peça para seguir o guia a partir da Etapa 1.

1. Avaliação local — a pilha completa + uma máquina Firecracker real em um servidor Linux com capacidade KVM. Nenhum Cloudflare ou domínio público é necessário; use um host KVM existente ou o exemplo opcional de provisionamento no GCP.
2. Cloudflare + um host dedicado — a implantação em formato de produção: domínio, túneis, autenticação de borda e um host inscrito na nuvem ou bare-metal.
3. O fluxo completo — crie e use máquinas (chat, terminal, VMs de navegador), ciclo de vida, backups, atualizações de runtime.

Documentação do projeto

• Primeiros passos — o guia de três etapas acima
• Guia do usuário — usando uma máquina no dia a dia (modelo, chat, terminal, VM de navegador, arquivos, logs, rastreamentos, backups)
• Integrações de workspace / MCP nativo — conecte ferramentas GitHub, Google Workspace, OpenAPI, GraphQL e MCP remoto uma vez por workspace
• Arquitetura — plano de dados, roteamento, túneis, ciclo de vida, integrações de workspace / MCP nativo
• Pilha tecnológica — as cinco camadas, do cliente à sandbox
• Configuração local e com host próprio
• Perfis de implantação do plano de controle
• Pré-requisitos para plano de controle auto-hospedado
• Manual do operador LLM
• Inventário de documentação pública
• Contribuindo · Política de segurança · Código de conduta
• Projeto CLI ocm

Comunidade e suporte

• Discussões no GitHub — perguntas, ideias, mostre e conte
• Issues — bugs e solicitações de funcionalidades
• Roadmap — o rastreador de prontidão de código aberto: o que está feito, o que vem a seguir
• Encontrou uma vulnerabilidade? Veja a política de segurança.

Contribuindo

Veja CONTRIBUTING.md e o código de conduta.

Licença

Apache-2.0