Como instalar o nanobot em um Mac mini

O que é o nanobot

O nanobot é um agente de IA pessoal de código aberto do grupo HKUDS no GitHub. Ele é escrito em Python sob a licença MIT. Como o OpenClaw, ele guarda memória, roda ferramentas e responde a você por apps de chat. O núcleo dele é mantido pequeno e legível (github.com/HKUDS/nanobot, lido em 2 de outubro de 2026). A versão mais recente no PyPI era a 0.3.5, de 15 de setembro de 2026.

Você pode usar em uma WebUI no navegador, no terminal ou pelo Telegram, Discord, Slack, Email e outros channels. Ele pode trabalhar com arquivos, rodar comandos de shell, pesquisar na web, usar servidores MCP e rodar tarefas agendadas. Mais uma nota sobre o nome. Este não é o obot-platform/nanobot, que é um framework em Go para criar agentes MCP.

Requisitos

• Python 3.11 ou mais novo. Confira com python3 --version. O instalador para se não encontrar um, então instale o Python antes, se precisar.
• macOS 13 ou mais novo. Os pacotes prontos para Macs com Apple silicon e Intel incluem a WebUI e a interface de terminal.
• Um provedor de modelo. Anthropic, OpenAI, OpenRouter e servidores locais como o Ollama estão todos na documentação de provedores. Use uma API key do provedor que você escolher.
• Git e Bun, mas só se você instalar a partir do código-fonte. A instalação normal não precisa deles.

Instale

Rode o instalador oficial de um comando do README.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

Ele instala o pacote nanobot-ai do PyPI. Ele evita instalações de pip no sistema inteiro. Ele usa um ambiente virtual ativo, uv, pipx ou um ambiente próprio na pasta .nanobot da sua pasta pessoal. Depois mostra o comando exato que usou. Para ver o plano sem mudar nada, adicione a flag de dry run.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh -s -- --dry-run

Se você já usa uv, isto faz o mesmo trabalho. Depois confira a versão.

uv tool install nanobot-ai
nanobot --version

Primeira execução e um modelo

O README recomenda a WebUI para a primeira execução. Ela abre em 127.0.0.1 na porta 8765 e escuta só neste Mac.

nanobot webui

Abra Settings, depois Models. Escolha um provedor, cole a API key dele e escolha um modelo. Depois comece um novo tópico e envie Hello. Qualquer resposta normal quer dizer que o provedor, o modelo e o gateway funcionam juntos. No terminal, uma mensagem avulsa faz a mesma verificação.

nanobot -m "Hello!"

As configurações são salvas em config.json na pasta .nanobot da sua pasta pessoal. Ainda não rodamos esta instalação na nossa própria máquina de teste. Os comandos aqui foram copiados do README e da documentação do nanobot em 2 de outubro de 2026.

Mantenha rodando 24/7

O gateway é a parte que fica online. Ele mantém os apps de chat, as tarefas agendadas e o trabalho de memória funcionando. Este comando mantém o gateway rodando depois que você fecha o terminal.

nanobot gateway --background

Isso não sobrevive a uma reinicialização. Para isso, a documentação de deployment instala um LaunchAgent. Termine primeiro a configuração do modelo na WebUI. Depois veja uma prévia do arquivo de serviço e instale.

nanobot gateway install-service --manager launchd --dry-run
nanobot gateway install-service --manager launchd

Ele grava ai.nanobot.gateway.plist na pasta LaunchAgents da Library da sua pasta pessoal. Ele inicia o gateway com o mesmo Python que instalou o nanobot. Os logs vão para a pasta logs dentro de .nanobot. Se falhar com address already in use, pare antes o gateway que você iniciou manualmente.

launchctl list | grep ai.nanobot.gateway
launchctl kickstart -k gui/$(id -u)/ai.nanobot.gateway
nanobot gateway uninstall-service --manager launchd

O gateway só lê o config.json ao iniciar. Reinicie depois de cada mudança de configuração.

Um LaunchAgent só roda enquanto um usuário está logado. Em um Mac sem ninguém por perto, ative o login automático para a conta que roda o nanobot. Depois impeça o Mac de entrar em repouso, porque o repouso pausa o gateway e as tarefas agendadas.

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

Mais detalhes estão em o que acontece quando um Mac entra em repouso e no guia do Mac sempre ligado.

Notas de segurança

• Para produção, a documentação recomenda duas configurações juntas. Defina restrictToWorkspace como true e defina tools.exec.sandbox como seatbelt no macOS. O seatbelt limita os comandos de shell à pasta do workspace.
• Nenhuma das duas limita o acesso à rede. Mantenha os segredos fora do workspace.
• A WebUI e a verificação de saúde do gateway escutam em 127.0.0.1 por padrão. Deixe as duas só neste Mac.
• Remetentes desconhecidos nos apps de chat recebem um código de pareamento, não uma resposta. Você aprova essas pessoas com /pairing approve e o código delas.
• A documentação sugere referências a variáveis de ambiente para as API keys, em vez de chaves puras no config.json. De qualquer jeito, trate a pasta .nanobot como um arquivo de senhas.

A proteção mais simples é um Mac que não guarda mais nada seu. Se o agente fizer algo estranho, o estrago fica nessa máquina.

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 o LaunchAgent do nanobot inicia de novo. O Claude Code e o Codex vêm pré-instalados. O nanobot não. Você mesmo instala, junto com o Python se precisar, porque tem acesso total de administrador.

Você pode abrir a WebUI no próprio navegador do Mac pela nossa área de trabalho no navegador. 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

O nanobot é pequeno e roda em quase qualquer lugar. A documentação cobre serviços no Linux, Docker e um deploy de um clique no Render. Se você não precisa de nada do macOS, qualquer uma dessas opções custa menos que um Mac. E se você já tem um Mac que fica ligado e logado, use esse Mac.

No plano agente, o nanobot pode trabalhar nas suas próprias contas, incluindo o seu email, calendário e chats. Ele também pode fazer a triagem de issues ou rodar tarefas noturnas no repositório. Mensagens em massa ou não solicitadas não são permitidas, conforme a nossa política de uso aceitável. Para comparar os planos, veja a página do Mac para agentes.