Coloque o ZeroClaw pra Rodar
Binário único em Rust, múltiplos caminhos de instalação. Escolha o que funciona pra você.
checklist Requisitos do Sistema
Toolchain Rust (stable) via rustup.rs — necessário apenas pra builds do fonte
Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64)
Runtime: <5MB de RAM. Build do fonte: 2GB+ de RAM, 4GB recomendado
Binário: ~8.8MB. Build do fonte: 6GB livres em disco, 10GB recomendado
Opcional: Docker (pra runtime em sandbox), Git (pra builds do fonte)
Internet pra chamadas de API de IA. Modelos locais via Ollama funcionam totalmente offline.
Scripts de uma linha que fazem tudo. Recomendado pra maioria dos usuários.
Remote One-Liner
macOS / Linux. Single command.
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash Local Bootstrap
Clone first, then bootstrap. More options.
git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw && ./bootstrap.sh # With system deps + Rust: ./bootstrap.sh --install-system-deps --install-rust # With onboarding: ./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter verified Verifique Sua Instalação
Rode esses comandos pra confirmar que o ZeroClaw foi instalado corretamente.
zeroclaw --version Deve mostrar a versão instalada. Roda em ~0.02s com ~3.9MB de memória de pico.
zeroclaw doctor Roda diagnósticos do sistema: versão do Rust, arquivos de config, conectividade de providers, saúde dos canais.
zeroclaw onboard --interactive Assistente interativo de configuração pra API keys, seleção de provider e configuração de canais.
settings Configuração Inicial
Após a instalação, o assistente de onboard te guia pela configuração. Veja o que cada passo faz.
Escolha Seu Provedor de IA
Selecione do catálogo de providers: OpenAI, Anthropic, Google Gemini, xAI, Mistral, DeepSeek, OpenRouter (100+ modelos), ou qualquer endpoint compatível com OpenAI incluindo Ollama pra modelos locais.
Adicione Sua API Key
Cole sua API key. As chaves são armazenadas localmente no config.toml — nunca enviadas pra lugar nenhum exceto o provedor de IA. Autenticação por assinatura (OpenAI Codex, Anthropic) também suportada com perfis criptografados.
Conecte um Canal
Vincule Telegram (cole o token do bot), Discord (cole o token do bot), Slack (app do workspace), WhatsApp (QR code), ou qualquer um dos 17+ canais suportados. Política de allowlist deny-by-default.
Inicie o Agente
Rode 'zeroclaw agent -m "Olá!"' pra um teste rápido, 'zeroclaw daemon' pra runtime autônomo completo, ou 'zeroclaw service install' pra serviço em background.
.env — Toda configuração fica em ~/.zeroclaw/config.toml. Edite diretamente pra trocar providers, canais, backends de memória, túneis e configurações de segurança. Veja docs/reference/README.md pra referência completa.
system_update_alt Atualizando o ZeroClaw
Mantenha o ZeroClaw atualizado pra ter os últimos recursos, integrações e correções de segurança.
brew upgrade zeroclaw cargo install zeroclaw --force cd zeroclaw && git pull && cargo build --release --locked ./bootstrap.sh --docker --skip-build Confira o changelog em github.com/zeroclaw-labs/zeroclaw/releases pra ver as novidades de cada versão.
build Solução de Problemas
Problemas comuns e como resolver.
Precisa de Ajuda?
Entre na nossa comunidade pra suporte na instalação e solução de problemas.