Omarchy provides a comprehensive suite of system wrappers and operating guardrails to ensure AI agents manage local environments using safe, native workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install omarchy
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 omarchy 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 Omarchy?
Omarchy acts as an intelligent operating layer for Linux systems, specifically designed to guide AI agents through native workflows. Instead of relying on generic Linux commands that might bypass system state management, this Openclaw Skills integration prioritizes a catalog of over 160 specialized scripts. It ensures that tasks like theme switching, package management, and service restarts are handled through official wrappers, maintaining system integrity and avoiding common pitfalls of ad-hoc command execution.
By treating the skill as an operating mode rather than just a command list, it enforces best practices such as read-only inspection and confirmation for high-impact actions. This approach makes Omarchy one of the most reliable Openclaw Skills for managing complex desktop environments and system-level configurations.
Omarchy Use Cases
- Restarting desktop components like Waybar or Hyprland without breaking session state.
- Installing or removing system packages using native wrappers that verify dependencies.
- Synchronizing themes across multiple applications including VS Code, browsers, and Obsidian.
- Troubleshooting hardware issues such as Wi-Fi, Bluetooth, and Audio using targeted restart scripts.
- Discovering safe system commands through static inspection rather than risky trial-and-error execution.
How Omarchy Works
- Identify the specific system component requiring action, such as the UI, network, or package manager.
- Locate the appropriate command family within the Openclaw Skills script directory.
- Perform a static inspection of script headers to understand the intended purpose and avoid parameter errors.
- Execute read-only or status commands first to validate the current system state before making changes.
- Use targeted refresh or restart wrappers instead of generic process-killing commands to preserve environment variables.
- Propose high-impact actions to the user and wait for confirmation before executing scripts that modify the system.
Omarchy Setup
To enable these Openclaw Skills, ensure the Omarchy binary directory is accessible to your agent environment.
# Ensure the Omarchy bin directory is in your PATH
export PATH="$HOME/.local/share/omarchy/bin:$PATH"
# Verify the installation and check the current version
omarchy-version
Omarchy Data Schema & Taxonomy
The skill operates using a structured directory of executable scripts. Each script contains documentation headers to guide the agent.
| Functional Category | Script Prefix | Purpose |
|---|---|---|
| UI Management | omarchy-refresh-* | Safely updates UI components like Waybar or Hyprland |
| Package Control | omarchy-pkg-* | Handles installation and removal with state awareness |
| Service Recovery | omarchy-restart-* | Restarts services like pipewire or bluetooth without collateral damage |
| Theme Pipeline | omarchy-theme-* | Synchronizes visual styles across multiple applications |
| Update Workflow | omarchy-update-* | Manages staged system and firmware updates |
Omarchy Advanced Features
- Multi-component theme synchronization for consistent UI across the entire desktop environment.
- Intelligent update staging that analyzes logs and checks for available updates before performing changes.
- Integrated desktop automation for window management, screen recording, and system snapshots.
- Support for specialized workflows like FIDO2 setup and fingerprint sensor configuration.
- Safe-mode guardrails that prevent bulk command probing and enforce static file inspection through Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Glance
Glance is an AI-extensible personal dashboard that allows developers to create custom widgets using natural language, where AI agents handle the underlying data collection and caching.
Redshift CLI for Decentralized Secret Management
Redshift is a decentralized secret management tool that uses Nostr relays for client-side encrypted storage, eliminating the need for central servers.
PPT Compression
A specialized tool for drastically reducing PowerPoint file sizes by optimizing internal media and converting the output to compact PDF format.
Skills Improvement
A comprehensive diagnostic and optimization framework designed to audit, refine, and verify the quality of AI agent skills.
Remember Me
A sophisticated memory layer that tracks user preferences, goals, and boundaries to provide highly personalized AI interactions over time.
Soaring Weather
A professional-grade thermal and gliding weather forecast tool using an 11-parameter scoring engine to predict soaring conditions.
Featured*
