Como instalar o NanoClaw em um Mac mini

O que é o NanoClaw

O NanoClaw é um assistente de IA de código aberto que você roda no seu próprio computador. Ele é escrito em TypeScript sob a licença MIT. O README chama o NanoClaw de alternativa leve ao OpenClaw (github.com/nanocoai/nanoclaw, lido em 2 de outubro de 2026). A versão mais recente era a 2.4.0, de 23 de setembro de 2026.

A grande diferença é o isolamento. Cada agente roda dentro do próprio contêiner Linux. Ele só vê as pastas que você monta nele. O agente é construído sobre o Claude Agent SDK da Anthropic. Você fala com ele por apps de chat como WhatsApp, Telegram, Discord, Slack, Teams ou iMessage. Cada channel é adicionado com a própria skill de configuração.

Requisitos

Estes vêm da documentação de instalação do NanoClaw (docs.nanoclaw.dev).

• macOS ou Linux, com pelo menos 4 GB de memória. O instalador avisa abaixo de 3.700 MB.
• Git, para baixar o código. O instalador não adiciona o Git para você.
• Docker Desktop no macOS. Os agentes rodam em contêineres Docker. O instalador adiciona o Docker Desktop com Homebrew se ele estiver faltando.
• Node 22 ou mais novo e pnpm 10 ou mais novo. O instalador adiciona os dois se estiverem faltando.
• Claude Code no Mac. O NanoClaw usa o Claude Code para corrigir passos de configuração que falharam e para adicionar channels.
• Uma credencial de modelo. A configuração oferece Claude ou Codex. Este guia usa uma API key da Anthropic, que a Anthropic cobra por uso.

Instale

Primeiro confira se o Git está lá. Uma linha começando com git version quer dizer que sim.

git --version

Depois rode estes quatro comandos do quick start oficial, uma linha por vez.

cd ~
git clone https://github.com/nanocoai/nanoclaw.git
cd nanoclaw
bash nanoclaw.sh

O script confere a máquina e instala o que está faltando. Depois um assistente de configuração faz algumas perguntas. A documentação sugere Standard setup e depois Fresh agent. Ela prevê de 30 a 60 minutos para tudo.

• Sandbox image. Fetch the hardened image precisa de uma conta gratuita do NanoClaw. Build it here não precisa de conta e leva alguns minutos.
• AI service. Escolha Claude e depois Paste an Anthropic API key. A configuração guarda a chave em um cofre local chamado OneCLI. Ela nunca entra no contêiner do agente.
• Service. A configuração inicia o NanoClaw em segundo plano e envia uma mensagem de teste para conferir se o agente responde.

A configuração também oferece login com assinatura. Se você pretende usar um, confira antes os termos do seu provedor para ferramentas de terceiros.

Depois da configuração, mande uma mensagem da pasta nanoclaw. O texto entre aspas é a sua mensagem. Para rodar a verificação completa de novo, use o passo verify.

cd ~/nanoclaw
pnpm run chat "Help me plan one of those weekend ideas."
pnpm run setup -- --step verify

Ainda não rodamos esta instalação na nossa própria máquina de teste. Os comandos acima foram copiados da documentação do NanoClaw em 2 de outubro de 2026. Confira de novo antes de começar.

Mantenha rodando 24/7

A configuração instala um LaunchAgent na pasta LaunchAgents da Library da sua pasta pessoal. O nome dele é parecido com com.nanoclaw-v2 mais um código curto da sua cópia. Ele tem RunAtLoad e KeepAlive definidos. Então ele inicia no login e reinicia se travar. Estes são os comandos documentados.

# Find your label
launchctl list | grep nanoclaw

# Restart
launchctl kickstart -k gui/$(id -u)/com.nanoclaw-v2-<slug>

# Stop / start
launchctl unload ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist
launchctl load   ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist

# Logs (stdout and stderr go to files, not the system log)
tail -f logs/nanoclaw.log logs/nanoclaw.error.log

O Docker também precisa estar rodando. Se não estiver, nenhum agente consegue iniciar. A documentação de solução de problemas diz para abrir o Docker Desktop, conferir se docker info funciona e depois reiniciar o NanoClaw. Nas configurações do Docker Desktop, ative a opção de iniciar quando você entra.

Um LaunchAgent só roda enquanto um usuário está logado. Depois de reinicializar, nada inicia até alguém entrar. Em um Mac sem ninguém por perto, ative o login automático para a conta que roda o NanoClaw. Depois impeça o Mac de entrar em repouso. O repouso pausa o Docker e derruba todas as conexões de chat.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Os motivos estão em o que acontece quando um Mac entra em repouso. A lista completa, incluindo quedas de energia, está no guia do Mac sempre ligado.

Notas de segurança

• Os agentes só veem as pastas que você permite. O arquivo da lista de permissão é mount-allowlist.json em ~/.config/nanoclaw, fora do checkout. Em uma instalação nova ele começa vazio.
• Os agentes nunca têm a sua API key pura. As requisições de saída passam pelo cofre, que adiciona a chave na hora da requisição.
• A configuração envia diagnósticos anônimos. Defina NANOCLAW_NO_DIAGNOSTICS=1 para desligar.
• A documentação tem uma página de hardening para configurações mais restritas. Ela trata de limites de acesso à rede, de quem pode mandar mensagens ao agente e de quais comandos ele pode rodar.

Contêineres ajudam, mas uma máquina dedicada ajuda mais. Rode o NanoClaw em um Mac que não guarda mais nada seu. Se o agente fizer algo estranho, o estrago fica nessa máquina. Para remover depois, a documentação dá uma flag de desinstalação. Adicione --dry-run para ver antes o que seria removido.

bash nanoclaw.sh --uninstall

Rodando em um Mac da MacRun

Nosso plano agente é um Mac mini dedicado que nunca entra em repouso. Ele fica na nossa instalação privada em Nova Jersey. A sessão de login volta sozinha depois de reinicializar, então os LaunchAgents iniciam de novo. O Claude Code e o Codex vêm pré-instalados, o que cobre a necessidade do NanoClaw de ter o Claude Code. O NanoClaw e o Docker Desktop não vêm pré-instalados. Você mesmo instala, porque tem acesso total de administrador.

O M6 básico tem 16 GB de memória, bem acima do mínimo de 4 GB. O plano agente custa $169 por mês. A MacRun não vende API keys. Use uma API key do seu provedor de modelo, que cobra o uso conforme os termos dele.

Quando você não precisa da MacRun

Se você já tem um Mac que fica ligado e logado, use esse Mac. Os passos acima são os mesmos. O NanoClaw também roda no Linux com o Docker Engine. Se você não precisa de nada do macOS, um pequeno servidor Linux custa menos que qualquer Mac.

No plano agente, o NanoClaw pode trabalhar nas suas próprias contas, incluindo o seu email, calendário e chats. Ele também pode revisar código, acompanhar o CI ou escrever notas de versão. Mensagens em massa ou não solicitadas não são permitidas, conforme a nossa política de uso aceitável. Quer testar em uma máquina que fica no ar? Veja a página do Mac para agentes.