Skip to main content
Instale o OpenClaw declarativamente com o nix-openclaw, o módulo oficial e completo do Home Manager.
O repositório nix-openclaw é a fonte oficial para a instalação com Nix. Esta página apresenta uma visão geral rápida.

​
O que você obtém

  • Gateway + aplicativo para macOS + ferramentas (whisper, spotify, câmeras), todos com versões fixadas
  • Serviço launchd que continua funcionando após reinicializações
  • Sistema de Plugins com configuração declarativa
  • Reversão instantânea: home-manager switch --rollback

​
Início rápido

1

Instalar o Determinate Nix

Se o Nix ainda não estiver instalado, siga as instruções do instalador do Determinate Nix.
2

Criar um flake local

Use o modelo voltado para agentes do repositório nix-openclaw:
3

Configurar segredos

Configure o token do bot de mensagens e a chave de API do provedor de modelos. Arquivos simples em ~/.secrets/ funcionam normalmente.
4

Preencher os espaços reservados do modelo e aplicar

5

Verificar

Confirme se o serviço launchd está em execução e se o bot responde às mensagens.
Consulte o README do nix-openclaw para ver todas as opções e exemplos do módulo.

​
Comportamento do ambiente de execução no modo Nix

Quando OPENCLAW_NIX_MODE=1 está definido (automaticamente com o 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:
No macOS, o aplicativo com interface gráfica não herda as variáveis de ambiente do shell. Em vez disso, ative o modo Nix por meio de defaults:

​
O que muda no modo Nix

  • Os fluxos de instalação automática e automodificação são desativados.
  • O arquivo openclaw.json é tratado como imutável. Os padrões derivados durante a inicialização permanecem apenas no ambiente de execução, e os gravadores de configuração (configuração, integração inicial, openclaw update com alterações, instalação/atualização/desinstalação/ativação de Plugins, doctor --fix, doctor --generate-gateway-token, openclaw config set) se recusam a editar o arquivo.
  • Em vez disso, edite o código-fonte Nix. Para o nix-openclaw, use o Início rápido voltado para agentes 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 interface 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. No Nix, defina-os explicitamente como locais gerenciados pelo Nix para que o estado do ambiente de execução e a configuração permaneçam fora do armazenamento imutável.

​
Descoberta do PATH do serviço

O serviço Gateway do launchd/systemd descobre automaticamente os binários dos perfis Nix para que Plugins e ferramentas que executam externamente executáveis instalados pelo nix funcionem sem configuração manual do 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 do Nix: a entrada mais à direita prevalece).
  • Quando NIX_PROFILES não está definido, ~/.nix-profile/bin é adicionado como alternativa.
Isso se aplica aos ambientes de serviço do launchd no macOS e do systemd no Linux.

​
Relacionados

nix-openclaw

Módulo oficial do Home Manager e guia completo de configuração.

Assistente de configuração

Guia passo a passo de configuração pela CLI sem Nix.

Docker

Configuração em contêiner como alternativa sem Nix.

Atualização

Atualização de instalações gerenciadas pelo Home Manager junto com o pacote.