Instalación con Nix

La forma recomendada de ejecutar OpenClaw con Nix es mediante nix-openclaw — un módulo de Home Manager con todo incluido.

Inicio rápido

Pega esto en tu 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, model provider API 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.

📦 Guía completa: github.com/openclaw/nix-openclaw

El repositorio nix-openclaw es la fuente de verdad para la instalación con Nix. Esta página es solo un resumen.

Lo que obtienes

  • Gateway + app macOS + herramientas (whisper, spotify, cameras) — todo fijado
  • Servicio launchd que sobrevive a reinicios
  • Sistema de plugins con config declarativa
  • Rollback instantáneo: home-manager switch --rollback

Comportamiento del runtime en modo Nix

Cuando OPENCLAW_NIX_MODE=1 está configurado (automático con nix-openclaw):

OpenClaw soporta un modo Nix que hace la configuración determinista y deshabilita los flujos de auto-instalación.

OPENCLAW_NIX_MODE=1

En macOS, la app GUI no hereda automáticamente las variables de entorno del shell. También puedes habilitar el modo Nix vía defaults:

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

Rutas de config + estado

  • OPENCLAW_HOME (precedencia por defecto: HOME / USERPROFILE / os.homedir())
  • OPENCLAW_STATE_DIR (por defecto: ~/.openclaw)
  • OPENCLAW_CONFIG_PATH (por defecto: $OPENCLAW_STATE_DIR/openclaw.json)

Cuando ejecutas bajo Nix, configura estos explícitamente a ubicaciones gestionadas por Nix.

Comportamiento en modo Nix

  • Los flujos de auto-instalación y auto-mutación están deshabilitados
  • Las dependencias faltantes muestran mensajes de corrección específicos de Nix
  • La UI muestra un banner de modo Nix de solo lectura

Relacionado

arrow_back
Anterior
Podman
Siguiente
Ansible
arrow_forward