Requisitos do Sistema OpenClaw

Certifique-se de que seu ambiente atende aos requisitos básicos antes de instalar.

Resposta curta

OpenClaw requer Node.js 22 ou posterior e suporta macOS, Linux e Windows via WSL2. Para a maioria dos usuários, um laptop moderno é suficiente, a menos que você execute modelos locais ou automação pesada.

Por que Node.js 22+ é necessário

O runtime depende de recursos modernos do Node e dependências atualizadas. Usar uma versão mais antiga do Node geralmente leva a falhas na instalação ou a um processo de gateway que trava sob carga.

Sistemas operacionais suportados

macOS e Linux são suportados nativamente. Usuários de Windows devem executar OpenClaw via WSL2 para um ambiente estável semelhante ao Unix. Se você hospedar em um servidor, Linux é a opção mais previsível.

Orientação de hardware por caso de uso

Se você usa apenas modelos na nuvem, os requisitos de CPU e memória permanecem modestos. Se você planeja executar modelos locais ou vários canais simultaneamente, mais RAM e armazenamento ajudam. Mantenha espaço em disco suficiente para logs, caches e dados de skills.

Mínimo vs. recomendado

Um laptop moderno com 8 GB de RAM geralmente é suficiente para modelos na nuvem e automação leve. Para cargas de trabalho mais pesadas, 16 GB ou mais é uma base mais segura. Armazenamento SSD é fortemente recomendado para acesso mais rápido a logs, cache e downloads de modelos.

Considerações de rede

OpenClaw pode rodar inteiramente localmente, mas muitos usuários se conectam a APIs de modelos externas. Certifique-se de que o acesso HTTPS de saída é permitido e estável. Se sua rede for restrita, planeje configurações de proxy e confirme que as portas do gateway não estão expostas publicamente.

Permissões de usuário e modo daemon

Instale e execute OpenClaw sob uma conta de usuário normal, não uma conta de sistema privilegiada. Se você usar o modo daemon, verifique se o serviço inicia na inicialização e se seu diretório de trabalho é legível e gravável. Permissões incorretas são uma causa comum de falhas silenciosas.

Verificações rápidas do ambiente

Check your Node version first, then run openclaw doctor after install. Fixing missing dependencies early saves hours of debugging later.

Referência oficial

Use the official install requirements as the authoritative source: Install requirements .