Pular para o conteúdo principal

​
Instalação com Nix

Instale o OpenClaw de forma declarativa com nix-openclaw — um módulo Home Manager completo, com tudo incluído.
O repositório nix-openclaw é a fonte de verdade para a instalação com Nix. Esta página é uma visão geral rápida.

​
O que você recebe

  • Gateway + app para macOS + ferramentas (whisper, spotify, câmeras) — tudo fixado
  • Serviço launchd que sobrevive a reinicializações
  • Sistema de plugins com configuração declarativa
  • Rollback instantâneo: home-manager switch --rollback

​
Início rápido

1

Instalar Determinate Nix

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

Criar um flake local

Use o modelo agent-first do repositório nix-openclaw:
mkdir -p ~/code/openclaw-local
# Copie templates/agent-first/flake.nix do repositório nix-openclaw
3

Configurar segredos

Configure seu token de bot de mensagens e a API key do provider de modelo. Arquivos simples em ~/.secrets/ funcionam bem.
4

Preencher os placeholders do modelo e aplicar a configuração

home-manager switch
5

Verificar

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

​
Comportamento de runtime no modo Nix

Quando OPENCLAW_NIX_MODE=1 está definido (automático com nix-openclaw), o OpenClaw entra em um modo determinístico que desativa fluxos de instalação automática. 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. Ative 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 desativados
  • Dependências ausentes exibem mensagens de remediação específicas para Nix
  • A UI exibe um banner somente leitura para o modo Nix

​
Caminhos de configuração e estado

O OpenClaw lê configuração JSON5 de OPENCLAW_CONFIG_PATH e armazena dados mutáveis em OPENCLAW_STATE_DIR. Ao executar sob Nix, defina esses caminhos explicitamente para locais gerenciados pelo Nix, para que o estado de runtime e a configuração fiquem fora do armazenamento imutável.
VariávelPadrão
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

​
Relacionado

  • nix-openclaw — guia completo de configuração
  • Wizard — configuração da CLI sem Nix
  • Docker — configuração em contêiner