nix-mode

What This Skill Does

The nix-mode skill is an essential utility for OpenClaw users running Clawdbot within a Nix-based ecosystem. It provides specialized logic to handle the inherent constraints and specific behaviors of Nix-managed environments. By detecting the CLAWDBOT_NIX_MODE=1 environment variable, the skill prevents the agent from attempting unauthorized file system modifications—such as auto-installing dependencies or modifying read-only system files—that would otherwise lead to failure in immutable Nix shells.

Installation

To integrate this skill into your environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/chronicuser21/nix-mode Ensure that you have appropriate permissions to modify your local Clawdbot configuration before running the installation.

Use Cases

This skill is designed for developers, systems engineers, and DevOps professionals who rely on Nix for declarative environment management. It is particularly useful when deploying Clawdbot across different Nix profiles or ephemeral dev shells. It allows the agent to correctly identify paths within the Nix store, preventing errors related to hardware-bound or non-standard configuration directories. It is ideal for teams enforcing strict security policies where automated software installation is blocked.

Example Prompts

1. "OpenClaw, please detect my current environment and confirm if I am running in Nix mode."
2. "I am getting an error regarding read-only paths in my Nix store; how should I reconfigure my Clawdbot state directory?"
3. "Explain why the auto-install feature is disabled and provide the Nix package management command for the missing dependency."

Tips & Limitations

• Respect Immutability: Always remember that in Nix mode, files in the store are read-only. Avoid asking the agent to perform self-upgrades or local package installations directly.
• Path Configuration: Ensure CLAWDBOT_CONFIG_PATH is explicitly set to a writeable directory, as the agent cannot write to its binary directory in Nix.
• Troubleshooting: When facing issues, always check the CLAWDBOT_NIX_MODE status first. If the skill is not triggering, verify your shell environment variables.
• Limitations: This skill does not manage Nix expressions directly; it focuses on managing the Clawdbot agent's behavior within existing Nix structures.