A specialized skill for managing Clawdbot operations within Nix-based immutable environments and configuration workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install nix-mode
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install nix-mode using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Clawdbot Nix Mode?
Clawdbot Nix Mode is a technical extension designed for developers operating within Nix-managed environments. It ensures that your AI agent respects the deterministic and immutable nature of Nix, providing specialized handling for configuration paths, state directories, and dependency management. By integrating this into your repository of Openclaw Skills, you gain a reliable bridge between dynamic AI tasks and the strict requirements of NixOS or nix-shell setups, ensuring that the agent never attempts to break the system's declarative state.
Clawdbot Nix Mode Use Cases
- Detecting Nix-managed environments via the CLAWDBOT_NIX_MODE environment flag.
- Managing configuration and state directories within specific Nix store paths.
- Preventing unauthorized auto-installation attempts in read-only or immutable filesystems.
- Troubleshooting environment-specific errors in Nix-based CI/CD pipelines or development shells.
- Guiding users toward declarative package management instead of imperative ad-hoc installs.
How Clawdbot Nix Mode Works
- The skill initializes by detecting the presence of the Nix environment through the CLAWDBOT_NIX_MODE variable and binary availability.
- It identifies whether the system is in a restricted Nix mode, which triggers a read-only banner and disables self-modifying features.
- The skill maps internal configuration paths to the appropriate CLAWDBOT_CONFIG_PATH and CLAWDBOT_STATE_DIR locations to maintain persistence.
- When dependencies are missing, the skill suppresses standard install scripts and provides remediation guidance tailored to Nix package management.
- It validates all operations against the immutable nature of the Nix store to prevent runtime path errors.
Clawdbot Nix Mode Setup
To enable this functionality within your Openclaw Skills setup, ensure that the Nix package manager and bash are installed. Configure your environment as follows:
# Enable Nix mode for the agent
export CLAWDBOT_NIX_MODE=1
# Define persistent configuration and state paths
export CLAWDBOT_CONFIG_PATH=$HOME/.config/clawdbot
export CLAWDBOT_STATE_DIR=$HOME/.local/share/clawdbot
Clawdbot Nix Mode Data Schema & Taxonomy
The skill organizes its operation around specific Nix-compliant directory structures and environment flags:
| Component | Source | Purpose |
|---|---|---|
| Mode Flag | CLAWDBOT_NIX_MODE | Determines if the agent operates in immutable mode. |
| Config Path | CLAWDBOT_CONFIG_PATH | Defines where declarative configurations are stored. |
| State Dir | CLAWDBOT_STATE_DIR | Manages ephemeral and variable state data outside the Nix store. |
| Binaries | nix, bash | Required system dependencies for environment detection. |
Clawdbot Nix Mode Advanced Features
- Intelligent detection of read-only Nix store paths to prevent file system write errors during agent execution.
- Automated remediation messaging that directs users to specific Nix-shell or Flake commands for dependency resolution.
- Support for custom configuration pathing to accommodate multi-user Nix environments and profiles.
- Seamless integration with other Openclaw Skills to ensure cross-compatible environment detection and path resolution.
SKILL.md
Loading
Related Openclaw Skills
Molt Identity
A core personality module for Molt that emphasizes transformation, resilience, and continuous evolution.
Weights & Biases (wandb)
A comprehensive tool for monitoring, analyzing, and comparing Weights & Biases training runs to optimize machine learning workflows.
tududi
A comprehensive integration for managing tasks, projects, and notes within a self-hosted tududi productivity environment.
Transistor.fm Podcast Management
Effortlessly manage podcast hosting, episode distribution, and listener analytics through the Transistor.fm REST API.
UI Debugging Methodology
A rigorous, evidence-based debugging framework that replaces trial-and-error with a structured observe-then-act workflow for frontend development.
Remix Agent Publish
A comprehensive skill for automating game builds and publishing to remix.gg via REST APIs and the Farcade SDK.
Featured*
