Instalacao com Nix¶

A forma recomendada de executar o OpenClaw com Nix e por meio do nix-openclaw — um modulo do Home Manager com tudo incluido.

Inicio Rapido¶

Cole isto no seu agente de IA (Claude, Cursor, etc.):

I want to set up nix-openclaw on my Mac.
Repository: github:openclaw/nix-openclaw

What I need you to do:
1. Check if Determinate Nix is installed (if not, install it)
2. Create a local flake at ~/code/openclaw-local using templates/agent-first/flake.nix
3. Help me create a Telegram bot (@BotFather) and get my chat ID (@userinfobot)
4. Set up secrets (bot token, Anthropic key) - plain files at ~/.secrets/ is fine
5. Fill in the template placeholders and run home-manager switch
6. Verify: launchd running, bot responds to messages

Reference the nix-openclaw README for module options.

📦 Guia completo: github.com/openclaw/nix-openclaw

O repo nix-openclaw e a fonte da verdade para a instalacao com Nix. Esta pagina e apenas uma visao geral rapida.

O que voce recebe¶

• Gateway + app macOS + ferramentas (whisper, spotify, cameras) — tudo fixado
• Servico do Launchd que sobrevive a reinicializacoes
• Sistema de plugins com configuracao declarativa
• Rollback instantaneo: home-manager switch --rollback

Comportamento de Runtime no Modo Nix¶

Quando OPENCLAW_NIX_MODE=1 esta definido (automatico com nix-openclaw):

O OpenClaw oferece um modo Nix que torna a configuracao deterministica e desativa fluxos de auto-instalacao. Ative exportando:

OPENCLAW_NIX_MODE=1

No macOS, o app de GUI nao herda automaticamente variaveis de ambiente do shell. Voce tambem pode ativar o modo Nix via defaults:

defaults write bot.molt.mac openclaw.nixMode -bool true

Caminhos de configuracao + estado¶

O OpenClaw le configuracao JSON5 de OPENCLAW_CONFIG_PATH e armazena dados mutaveis em OPENCLAW_STATE_DIR. Quando necessário, você também pode definir OPENCLAW_HOME para controlar o diretório home base usado para a resolução interna de caminhos.

• OPENCLAW_HOME (precedência padrão: HOME / USERPROFILE / os.homedir())
• OPENCLAW_STATE_DIR (padrao: ~/.openclaw)
• OPENCLAW_CONFIG_PATH (padrao: $OPENCLAW_STATE_DIR/openclaw.json)

Ao executar sob Nix, defina estes explicitamente para locais gerenciados pelo Nix para que o estado de runtime e a configuracao fiquem fora do store imutavel.

Comportamento de runtime no modo Nix¶

• Fluxos de auto-instalacao e auto-mutacao sao desativados
• Dependencias ausentes exibem mensagens de remediacao especificas do Nix
• A UI exibe um banner de modo Nix somente leitura quando presente

Nota de empacotamento (macOS)¶

O fluxo de empacotamento do macOS espera um template Info.plist estavel em:

apps/macos/Sources/OpenClaw/Resources/Info.plist

scripts/package-mac-app.sh copia este template para dentro do bundle do app e aplica patches nos campos dinamicos (ID do bundle, versao/build, SHA do Git, chaves do Sparkle). Isso mantem o plist deterministico para empacotamento com SwiftPM e builds do Nix (que nao dependem de uma toolchain completa do Xcode).

Relacionado¶

• nix-openclaw — guia completo de configuracao
• Wizard — configuracao da CLI sem Nix
• Docker — configuracao em contêiner