🦀 ZeroClaw — Assistente Pessoal de IA

Zero overhead. Zero compromisso. 100% Rust. 100% Agnóstico.
⚡️ Roda em hardware de $10 com <5MB de RAM: 99% menos memória que o OpenClaw e 98% mais barato que um Mac mini!

Construído por estudantes e membros das comunidades de Harvard, MIT e Sundai.Club.

🌐 Idiomas: 🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇵🇭 Tagalog · 🇪🇸 Español · 🇧🇷 Português · 🇮🇹 Italiano · 🇩🇪 Deutsch · 🇫🇷 Français · 🇸🇦 العربية · 🇮🇳 हिन्दी · 🇷🇺 Русский · 🇧🇩 বাংলা · 🇮🇱 עברית · 🇵🇱 Polski · 🇨🇿 Čeština · 🇳🇱 Nederlands · 🇹🇷 Türkçe · 🇺🇦 Українська · 🇮🇩 Bahasa Indonesia · 🇹🇭 ไทย · 🇵🇰 اردو · 🇷🇴 Română · 🇸🇪 Svenska · 🇬🇷 Ελληνικά · 🇭🇺 Magyar · 🇫🇮 Suomi · 🇩🇰 Dansk · 🇳🇴 Norsk

ZeroClaw é um assistente pessoal de IA que você executa nos seus próprios dispositivos. Ele responde nos canais que você já usa (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work e mais). Tem um painel web para controle em tempo real e pode se conectar a periféricos de hardware (ESP32, STM32, Arduino, Raspberry Pi). O Gateway é apenas o plano de controle — o produto é o assistente.

Se você quer um assistente pessoal, para um único usuário, que seja local, rápido e sempre ativo, é isso.

Site · Documentação · Arquitetura · Primeiros passos · Migração do OpenClaw · Solução de problemas · Discord

Configuração preferida: execute zeroclaw onboard no seu terminal. O ZeroClaw Onboard guia você passo a passo na configuração do gateway, workspace, canais e provedor. É o caminho de configuração recomendado e funciona no macOS, Linux e Windows (via WSL2). Nova instalação? Comece aqui: Primeiros passos

• OpenAI Codex (assinatura ChatGPT)
• Gemini (Google OAuth)
• Anthropic (chave API ou token de autenticação)

Nota sobre modelos: embora muitos provedores/modelos sejam suportados, para a melhor experiência use o modelo de última geração mais poderoso disponível para você. Veja Onboarding.

Configuração de modelos + CLI: Referência de provedores Rotação de perfis de autenticação (OAuth vs chaves API) + failover: Failover de modelos

Requisito: toolchain estável do Rust. Um único binário, sem dependências de runtime.

brew install zeroclaw

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

zeroclaw onboard executa automaticamente após a instalação para configurar seu workspace e provedor.

Guia completo para iniciantes (autenticação, pareamento, canais): Primeiros passos

# Instalar + onboard
./install.sh --api-key "sk-..." --provider openrouter

# Iniciar o gateway (servidor webhook + painel web)
zeroclaw gateway                # padrão: 127.0.0.1:42617
zeroclaw gateway --port 0       # porta aleatória (segurança reforçada)

# Falar com o assistente
zeroclaw agent -m "Hello, ZeroClaw!"

# Modo interativo
zeroclaw agent

# Iniciar runtime autônomo completo (gateway + canais + cron + hands)
zeroclaw daemon

# Verificar status
zeroclaw status

# Executar diagnósticos
zeroclaw doctor

Atualizando? Execute zeroclaw doctor após atualizar.

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

cargo build --release --locked
cargo install --path . --force --locked

zeroclaw onboard

Alternativa para desenvolvimento (sem instalação global): prefixe comandos com cargo run --release -- (exemplo: cargo run --release -- status).

O ZeroClaw pode importar seu workspace, memória e configuração do OpenClaw:

# Pré-visualizar o que será migrado (seguro, somente leitura)
zeroclaw migrate openclaw --dry-run

# Executar a migração
zeroclaw migrate openclaw

Isso migra suas entradas de memória, arquivos do workspace e configuração de ~/.openclaw/ para ~/.zeroclaw/. A configuração é convertida de JSON para TOML automaticamente.

O ZeroClaw conecta-se a superfícies de mensagens reais. Trate DMs recebidas como entrada não confiável.

Guia completo de segurança: SECURITY.md

Comportamento padrão em todos os canais:

• Pareamento por DM (padrão): remetentes desconhecidos recebem um código de pareamento curto e o bot não processa sua mensagem.
• Aprovar com: zeroclaw pairing approve <channel> <code> (então o remetente é adicionado a uma lista de permitidos local).
• DMs públicas recebidas requerem uma ativação explícita em config.toml.
• Execute zeroclaw doctor para detectar políticas de DM arriscadas ou mal configuradas.

Níveis de autonomia:

Camadas de sandboxing: isolamento do workspace, bloqueio de traversal de caminhos, listas de comandos permitidos, caminhos proibidos (/etc, /root, ~/.ssh), limitação de taxa (máximo de ações/hora, limites de custo/dia).

Use este quadro para avisos importantes (mudanças incompatíveis, avisos de segurança, janelas de manutenção e bloqueadores de lançamento).

• Runtime leve por padrão — fluxos de trabalho comuns de CLI e status rodam em poucos megabytes de memória em builds release.
• Implantação econômica — projetado para placas de $10 e instâncias pequenas na nuvem, sem dependências pesadas de runtime.
• Cold start rápido — runtime Rust com binário único mantém a inicialização de comandos e do daemon quase instantânea.
• Arquitetura portável — um binário para ARM, x86 e RISC-V com provedores/canais/ferramentas intercambiáveis.
• Gateway local-first — plano de controle único para sessões, canais, ferramentas, cron, SOPs e eventos.
• Caixa de entrada multicanal — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket e mais.
• Orquestração multi-agente (Hands) — enxames de agentes autônomos que rodam por agendamento e ficam mais inteligentes com o tempo.
• Procedimentos Operacionais Padrão (SOPs) — automação de fluxos de trabalho orientada por eventos com MQTT, webhook, cron e gatilhos de periféricos.
• Painel web — interface web React 19 + Vite com chat em tempo real, navegador de memória, editor de configuração, gerenciador de cron e inspetor de ferramentas.
• Periféricos de hardware — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO via trait Peripheral.
• Ferramentas de primeira classe — shell, E/S de arquivos, navegador, git, web fetch/search, MCP, Jira, Notion, Google Workspace e mais de 70 outras.
• Hooks de ciclo de vida — intercepte e modifique chamadas LLM, execuções de ferramentas e mensagens em cada estágio.
• Plataforma de skills — skills incluídos, comunitários e do workspace com auditoria de segurança.
• Suporte a túneis — Cloudflare, Tailscale, ngrok, OpenVPN e túneis personalizados para acesso remoto.

• Leve por padrão: binário Rust pequeno, inicialização rápida, baixo consumo de memória.
• Seguro por design: pareamento, sandboxing rigoroso, listas de permissão explícitas, escopo do workspace.
• Totalmente intercambiável: sistemas centrais são traits (provedores, canais, ferramentas, memória, túneis).
• Sem vendor lock-in: suporte a provedores compatíveis com OpenAI + endpoints personalizados plugáveis.

Benchmark rápido em máquina local (macOS arm64, fev 2026) normalizado para hardware edge de 0.8GHz.

Notas: Os resultados do ZeroClaw são medidos em builds release usando /usr/bin/time -l. O OpenClaw requer o runtime Node.js (tipicamente ~390MB de overhead adicional de memória), enquanto o NanoBot requer o runtime Python. PicoClaw e ZeroClaw são binários estáticos. Os valores de RAM acima são memória em runtime; os requisitos de compilação são maiores.

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

• Plano de controle Gateway HTTP/WS/SSE com sessões, presença, configuração, cron, webhooks, painel web e pareamento.
• Superfície CLI: gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Loop de orquestração do agente com despacho de ferramentas, construção de prompts, classificação de mensagens e carregamento de memória.
• Modelo de sessão com aplicação de políticas de segurança, níveis de autonomia e aprovação condicional.
• Wrapper de provedor resiliente com failover, retry e roteamento de modelos em mais de 20 backends LLM.

Canais: WhatsApp (nativo), Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, DingTalk, Lark, Mattermost, Nextcloud Talk, Nostr, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WATI, Mochat, Linq, Notion, WebSocket, ClawdTalk.

Habilitados por feature gate: Matrix (channel-matrix), Lark (channel-lark), Nostr (channel-nostr).

Painel web React 19 + Vite 6 + Tailwind CSS 4 servido diretamente pelo Gateway:

• Dashboard — visão geral do sistema, status de saúde, uptime, rastreamento de custos
• Chat do agente — chat interativo com o agente
• Memória — navegar e gerenciar entradas de memória
• Configuração — visualizar e editar configuração
• Cron — gerenciar tarefas agendadas
• Ferramentas — navegar ferramentas disponíveis
• Logs — visualizar logs de atividade do agente
• Custos — uso de tokens e rastreamento de custos
• Doctor — diagnósticos de saúde do sistema
• Integrações — status e configuração de integrações
• Pareamento — gerenciamento de pareamento de dispositivos

• Core: shell, leitura/escrita/edição de arquivos, operações git, busca glob, busca de conteúdo
• Web: controle de navegador, web fetch, web search, captura de tela, informação de imagem, leitura de PDF
• Integrações: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: Model Context Protocol tool wrapper + conjuntos de ferramentas deferidos
• Agendamento: cron add/remove/update/run, ferramenta de agendamento
• Memória: recall, store, forget, knowledge, project intel
• Avançado: delegate (agente para agente), swarm, troca/roteamento de modelos, operações de segurança, operações na nuvem
• Hardware: board info, memory map, memory read (habilitado por feature gate)

• Níveis de autonomia: ReadOnly, Supervised (padrão), Full.
• Sandboxing: isolamento do workspace, bloqueio de traversal de caminhos, listas de comandos permitidos, caminhos proibidos, Landlock (Linux), Bubblewrap.
• Limitação de taxa: máximo de ações por hora, máximo de custo por dia (configurável).
• Aprovação condicional: aprovação interativa para operações de risco médio/alto.
• Parada de emergência: capacidade de desligamento de emergência.
• 129+ testes de segurança em CI automatizado.

• Painel web servido diretamente pelo Gateway.
• Suporte a túneis: Cloudflare, Tailscale, ngrok, OpenVPN, comando personalizado.
• Adaptador de runtime Docker para execução em contêineres.
• CI/CD: beta (automático no push) → stable (dispatch manual) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.
• Binários pré-construídos para Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).

~/.zeroclaw/config.toml mínimo:

default_provider = "anthropic"
api_key = "sk-ant-..."

Referência completa de configuração: docs/reference/api/config-reference.md.

Telegram:

[channels.telegram]
bot_token = "123456:ABC-DEF..."

Discord:

[channels.discord]
token = "your-bot-token"

Slack:

[channels.slack]
bot_token = "xoxb-..."
app_token = "xapp-..."

WhatsApp:

[channels.whatsapp]
enabled = true

Matrix:

[channels.matrix]
homeserver_url = "https://matrix.org"
username = "@bot:matrix.org"
password = "..."

Signal:

[channels.signal]
phone_number = "+1234567890"

[tunnel]
kind = "cloudflare"  # ou "tailscale", "ngrok", "openvpn", "custom", "none"

Detalhes: Referência de canais · Referência de configuração

• native (padrão) — execução direta de processos, caminho mais rápido, ideal para ambientes confiáveis.
• docker — isolamento completo em contêineres, políticas de segurança forçadas, requer Docker.

Defina runtime.kind = "docker" para sandboxing rigoroso ou isolamento de rede.

O ZeroClaw suporta perfis de autenticação nativos de assinatura (multi-conta, criptografados em repouso).

• Arquivo de armazenamento: ~/.zeroclaw/auth-profiles.json
• Chave de criptografia: ~/.zeroclaw/.secret_key
• Formato de id do perfil: <provider>:<profile_name> (exemplo: openai-codex:work)

# OpenAI Codex OAuth (assinatura ChatGPT)
zeroclaw auth login --provider openai-codex --device-code

# Gemini OAuth
zeroclaw auth login --provider gemini --profile default

# Anthropic setup-token
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

# Verificar / atualizar / trocar perfil
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Executar o agente com autenticação por assinatura
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Raiz do workspace: ~/.zeroclaw/workspace/ (configurável via config).

Arquivos de prompt injetados:

• IDENTITY.md — personalidade e papel do agente
• USER.md — contexto e preferências do usuário
• MEMORY.md — fatos e lições de longo prazo
• AGENTS.md — convenções de sessão e regras de inicialização
• SOUL.md — identidade central e princípios operacionais

Skills: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md ou SKILL.toml.

# Listar skills instalados
zeroclaw skills list

# Instalar do git
zeroclaw skills install https://github.com/user/my-skill.git

# Auditoria de segurança antes de instalar
zeroclaw skills audit https://github.com/user/my-skill.git

# Remover um skill
zeroclaw skills remove my-skill

# Gerenciamento do workspace
zeroclaw onboard              # Assistente de configuração guiada
zeroclaw status               # Mostrar status do daemon/agente
zeroclaw doctor               # Executar diagnósticos do sistema

# Gateway + daemon
zeroclaw gateway              # Iniciar servidor gateway (127.0.0.1:42617)
zeroclaw daemon               # Iniciar runtime autônomo completo

# Agente
zeroclaw agent                # Modo de chat interativo
zeroclaw agent -m "message"   # Modo de mensagem única

# Gerenciamento de serviços
zeroclaw service install      # Instalar como serviço do SO (launchd/systemd)
zeroclaw service start|stop|restart|status

# Canais
zeroclaw channel list         # Listar canais configurados
zeroclaw channel doctor       # Verificar saúde dos canais
zeroclaw channel bind-telegram 123456789

# Cron + agendamento
zeroclaw cron list            # Listar trabalhos agendados
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Memória
zeroclaw memory list          # Listar entradas de memória
zeroclaw memory get <key>     # Recuperar uma memória
zeroclaw memory stats         # Estatísticas de memória

# Perfis de autenticação
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Periféricos de hardware
zeroclaw hardware discover    # Escanear dispositivos conectados
zeroclaw peripheral list      # Listar periféricos conectados
zeroclaw peripheral flash     # Flashear firmware no dispositivo

# Migração
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Completação de shell
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

Referência completa de comandos: docs/reference/cli/commands-reference.md

curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

./install.sh --prefer-prebuilt

./install.sh --prebuilt-only

Os assets de release são publicados para:

• Linux: x86_64, aarch64, armv7
• macOS: x86_64, aarch64
• Windows: x86_64

Baixe os últimos assets em: https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Use estes recursos quando tiver passado pelo fluxo de onboarding e quiser a referência mais aprofundada.

• Comece com o índice de docs para navegação e "o que está onde."
• Leia a visão geral da arquitetura para o modelo completo do sistema.
• Use a referência de configuração quando precisar de cada chave e exemplo.
• Execute o Gateway conforme o livro com o runbook operacional.
• Siga o ZeroClaw Onboard para uma configuração guiada.
• Depure falhas comuns com o guia de solução de problemas.
• Revise a orientação de segurança antes de expor qualquer coisa.

• Hub de documentação: docs/README.md
• TOC unificado de docs: docs/SUMMARY.md
• Referência de comandos: docs/reference/cli/commands-reference.md
• Referência de configuração: docs/reference/api/config-reference.md
• Referência de provedores: docs/reference/api/providers-reference.md
• Referência de canais: docs/reference/api/channels-reference.md
• Runbook operacional: docs/ops/operations-runbook.md
• Solução de problemas: docs/ops/troubleshooting.md

• Guia de contribuição: CONTRIBUTING.md
• Política de fluxo de trabalho de PR: docs/contributing/pr-workflow.md
• Guia de fluxo de trabalho CI: docs/contributing/ci-map.md
• Manual do revisor: docs/contributing/reviewer-playbook.md
• Política de divulgação de segurança: SECURITY.md
• Template de documentação: docs/contributing/doc-template.md

• Guia de implantação em rede: docs/ops/network-deployment.md
• Manual de agente proxy: docs/ops/proxy-agent-playbook.md
• Guias de hardware: docs/hardware/README.md

O ZeroClaw foi construído para o caranguejo suave 🦀, um assistente de IA rápido e eficiente. Construído por Argenis De La Rosa e a comunidade.

• zeroclawlabs.ai
• @zeroclawlabs

Se o ZeroClaw ajuda no seu trabalho e você quer apoiar o desenvolvimento contínuo, pode doar aqui:

Um sincero agradecimento às comunidades e instituições que inspiram e impulsionam este trabalho de código aberto:

• Harvard University — por fomentar a curiosidade intelectual e empurrar os limites do possível.
• MIT — por defender o conhecimento aberto, o código aberto e a crença de que a tecnologia deve ser acessível a todos.
• Sundai Club — pela comunidade, a energia e o impulso incansável de construir coisas que importam.
• O Mundo e Além 🌍✨ — a cada contribuidor, sonhador e construtor que faz do código aberto uma força para o bem. Isto é para você.

Estamos construindo abertamente porque as melhores ideias vêm de todos os lugares. Se você está lendo isto, faz parte disso. Bem-vindo. 🦀❤️

Novo no ZeroClaw? Procure issues rotulados como good first issue — veja nosso Guia de contribuição para saber como começar. PRs com IA/vibe-coded são bem-vindos! 🤖

Veja CONTRIBUTING.md e CLA.md. Implemente um trait, envie um PR:

• Guia de fluxo de trabalho CI: docs/contributing/ci-map.md
• Novo Provider → src/providers/
• Novo Channel → src/channels/
• Novo Observer → src/observability/
• Novo Tool → src/tools/
• Novo Memory → src/memory/
• Novo Tunnel → src/tunnel/
• Novo Peripheral → src/peripherals/
• Novo Skill → ~/.zeroclaw/workspace/skills/<name>/

Este é o único repositório oficial do ZeroClaw:

https://github.com/zeroclaw-labs/zeroclaw

Qualquer outro repositório, organização, domínio ou pacote que afirme ser "ZeroClaw" ou implique afiliação com ZeroClaw Labs não é autorizado e não é afiliado a este projeto. Forks não autorizados conhecidos serão listados em TRADEMARK.md.

Se encontrar falsificação ou uso indevido de marca, por favor abra um issue.

O ZeroClaw tem licença dupla para máxima abertura e proteção dos contribuidores:

Você pode escolher qualquer uma das licenças. Os contribuidores automaticamente concedem direitos sob ambas — veja CLA.md para o acordo completo de contribuidores.

O nome e logo do ZeroClaw são marcas registradas da ZeroClaw Labs. Esta licença não concede permissão para usá-los para implicar endosso ou afiliação. Veja TRADEMARK.md para usos permitidos e proibidos.

• Você mantém o copyright das suas contribuições
• Concessão de patentes (Apache 2.0) protege você de reclamações de patentes de outros contribuidores
• Suas contribuições são permanentemente atribuídas no histórico de commits e NOTICE
• Nenhum direito de marca registrada é transferido ao contribuir

ZeroClaw — Zero overhead. Zero compromisso. Implante em qualquer lugar. Troque qualquer coisa. 🦀

Esta lista é gerada a partir do gráfico de contribuidores do GitHub e é atualizada automaticamente.