Skip to main content
Instala OpenClaw de forma declarativa con nix-openclaw, el módulo oficial y completo de Home Manager.
El repositorio nix-openclaw es la fuente de referencia para la instalación con Nix. Esta página ofrece una descripción general rápida.

​
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

1

Instalar Determinate Nix

Si Nix aún no está instalado, sigue las instrucciones del instalador de Determinate Nix.
2

Crear un flake local

Utiliza la plantilla orientada a agentes del repositorio nix-openclaw:
3

Configurar los secretos

Configura el token del bot de mensajería y la clave de API del proveedor del modelo. Los archivos de texto sin formato en ~/.secrets/ funcionan correctamente.
4

Completar los marcadores de posición de la plantilla y aplicar

5

Verificar

Confirma que el servicio launchd esté en ejecución y que el bot responda a los mensajes.
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:
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:

​
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

nix-openclaw

Módulo de Home Manager que constituye la fuente de referencia y guía completa de configuración.

Asistente de configuración

Guía paso a paso para la configuración mediante la CLI sin Nix.

Docker

Configuración en contenedores como alternativa sin Nix.

Actualización

Actualización de las instalaciones gestionadas por Home Manager junto con el paquete.