Nix

Instala OpenClaw de forma declarativa con nix-openclaw, el módulo oficial y completo de Home Manager.

Qué se obtiene

• Gateway + aplicación para macOS + herramientas (whisper, spotify, cámaras), todo con versiones fijadas
• Servicio launchd que se mantiene tras los reinicios
• Sistema de Plugins con configuración declarativa
• Reversión instantánea: home-manager switch --rollback

Inicio rápido

mkdir -p ~/code/openclaw-local# Copia templates/agent-first/flake.nix del repositorio nix-openclaw

home-manager switch

Consulta el README de nix-openclaw para ver todas las opciones del módulo y ejemplos.

Comportamiento del entorno de ejecución en modo Nix

Cuando se establece OPENCLAW_NIX_MODE=1 (automáticamente con nix-openclaw), OpenClaw entra en un modo determinista para las instalaciones gestionadas con Nix. Otros paquetes de Nix pueden establecer el mismo modo; nix-openclaw es la referencia oficial.

También se puede establecer manualmente:

export OPENCLAW_NIX_MODE=1

En macOS, la aplicación con interfaz gráfica no hereda las variables de entorno del shell. En su lugar, habilita el modo Nix mediante defaults:

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

Qué cambia en el modo Nix

• Los flujos de instalación automática y automodificación están deshabilitados.
• openclaw.json se considera inmutable. Los valores predeterminados derivados del inicio permanecen únicamente en el entorno de ejecución, y las operaciones que escriben la configuración (configuración inicial, incorporación, modificación de openclaw update, instalación, actualización, desinstalación y habilitación de Plugins, doctor --fix, doctor --generate-gateway-token, openclaw config set) se niegan a editar el archivo.
• Edita en su lugar el código fuente de Nix. Para nix-openclaw, utiliza el inicio rápido orientado a agentes y establece la configuración en programs.openclaw.config o instances.<name>.config.
• Las dependencias que faltan muestran mensajes de solución específicos de Nix.
• La interfaz de usuario muestra un aviso de modo Nix de solo lectura.

Rutas de configuración y estado

OpenClaw lee la configuración JSON5 de OPENCLAW_CONFIG_PATH y almacena los datos modificables en OPENCLAW_STATE_DIR. Con Nix, establece estas rutas explícitamente en ubicaciones gestionadas por Nix para que el estado del entorno de ejecución y la configuración permanezcan fuera del almacén inmutable.

Detección de PATH para el servicio

El servicio Gateway de launchd/systemd detecta automáticamente los ejecutables de los perfiles de Nix para que los Plugins y las herramientas que invocan ejecutables instalados mediante nix funcionen sin configurar PATH manualmente:

• Cuando se establece NIX_PROFILES, cada entrada se añade al PATH del servicio con precedencia de derecha a izquierda (coincide con la precedencia del shell de Nix: la entrada situada más a la derecha prevalece).
• Cuando no se establece NIX_PROFILES, se añade ~/.nix-profile/bin como alternativa.

Esto se aplica tanto a los entornos de servicio launchd de macOS como a los de systemd de Linux.

Contenido relacionado