Nix

Instale o OpenClaw declarativamente com nix-openclaw - o módulo Home Manager oficial, completo e pronto para uso.

# O que você recebe

• Gateway + app macOS + ferramentas (whisper, spotify, cameras) -- tudo com versões fixadas
• Serviço launchd que sobrevive a reinicializações
• Sistema de Plugin com configuração declarativa
• Rollback instantâneo: home-manager switch --rollback

# Início rápido

mkdir -p ~/code/openclaw-local
# Copy templates/agent-first/flake.nix from the nix-openclaw repo

home-manager switch

Consulte o README do nix-openclaw para ver todas as opções e exemplos do módulo.

# Comportamento de runtime no modo Nix

Quando OPENCLAW_NIX_MODE=1 está definido (automaticamente com nix-openclaw), o OpenClaw entra em um modo determinístico para instalações gerenciadas pelo Nix. Outros pacotes Nix podem definir o mesmo modo; o nix-openclaw é a referência oficial.

Você também pode defini-lo manualmente:

export OPENCLAW_NIX_MODE=1

No macOS, o app com GUI não herda automaticamente variáveis de ambiente do shell. Em vez disso, habilite o modo Nix via defaults:

defaults write ai.openclaw.mac openclaw.nixMode -bool true

# O que muda no modo Nix

• Fluxos de instalação automática e automutação são desabilitados
• openclaw.json é tratado como imutável. Padrões derivados da inicialização permanecem somente em runtime, e gravadores de configuração como setup, onboarding, openclaw update mutável, instalação/atualização/desinstalação/habilitação de plugins, doctor --fix, doctor --generate-gateway-token e openclaw config set se recusam a editar o arquivo.
• Agentes devem editar a fonte Nix em vez disso. Para nix-openclaw, use o Início rápido agent-first e defina a configuração em programs.openclaw.config ou instances.<name>.config.
• Dependências ausentes exibem mensagens de correção específicas do Nix
• A UI exibe um banner de modo Nix somente leitura

# Caminhos de configuração e estado

O OpenClaw lê a configuração JSON5 de OPENCLAW_CONFIG_PATH e armazena dados mutáveis em OPENCLAW_STATE_DIR. Ao executar sob o Nix, defina esses valores explicitamente para locais gerenciados pelo Nix, para que o estado de runtime e a configuração fiquem fora do store imutável.

# Descoberta do PATH do serviço

O serviço Gateway launchd/systemd descobre automaticamente binários de perfis Nix para que plugins e ferramentas que executam executáveis instalados por nix via shell funcionem sem configuração manual de PATH:

• Quando NIX_PROFILES está definido, cada entrada é adicionada ao PATH do serviço com precedência da direita para a esquerda (corresponde à precedência do shell Nix - o mais à direita vence).
• Quando NIX_PROFILES não está definido, ~/.nix-profile/bin é adicionado como fallback.

Isso se aplica aos ambientes de serviço launchd do macOS e systemd do Linux.

# Relacionados