A robust CLI tool for managing AdGuard Home DNS filtering, protection states, and domain rules via an intuitive HTTP API interface.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install adguard
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 adguard 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 AdGuard Home Controller?
The AdGuard Home Controller is a specialized utility designed to bring the management of your AdGuard Home instance directly to your terminal. By utilizing Openclaw Skills, users can programmatically interact with their DNS server to handle blocklists, allowlists, and real-time protection settings without the need for a web browser.
This skill is ideal for developers and home lab enthusiasts who require a fast, scriptable way to manage network-level filtering. It leverages the AdGuard Home REST API to provide a seamless experience for checking domain statuses, monitoring block rates, and clearing DNS caches instantly, making it a vital addition to any Openclaw Skills collection.
AdGuard Home Controller Use Cases
- Temporarily disabling DNS protection for troubleshooting network connectivity issues.
- Quickly whitelisting false-positive domains that are interrupting workflow.
- Instant blacklisting of known malicious domains or trackers discovered during research.
- Generating quick reports of DNS query statistics and block rates for network auditing.
How AdGuard Home Controller Works
- The user initializes the skill by providing the AdGuard Home instance URL and administrative credentials.
- The skill utilizes curl to communicate with the AdGuard Home REST API endpoints.
- Commands such as allow or block are translated into specific DNS filtering rule syntax (e.g., adblock-style filters).
- The controller authenticates each request using the provided admin password to ensure secure communication.
- Real-time feedback and status reports are parsed from the API response and displayed in a developer-friendly format.
AdGuard Home Controller Setup
To start using this skill within the Openclaw Skills framework, you must first configure your connection settings. Set the following environment variables in your shell:
export ADGUARD_URL="http://192.168.1.100:3000"
export ADGUARD_USERNAME="admin"
export ADGUARD_PASSWORD="your_secure_password"
For persistent configuration, you can create a JSON file at ~/.adguard/config.json containing your URL and username, while keeping the password in your environment variables for security.
AdGuard Home Controller Data Schema & Taxonomy
The skill manages data primarily through filtering rules and API interactions. It follows the standard AdGuard DNS filtering syntax:
| Rule Type | Syntax | Effect |
|---|---|---|
| Block | ` | |
| Allow | `@@ | |
| Exact | domain.com |
Blocks only the exact domain specified |
Local configuration is optionally stored in ~/.adguard/config.json to persist the instance URL and username metadata.
AdGuard Home Controller Advanced Features
- Batch operations using shell loops to block or check hundreds of domains at once.
- Remote protection toggling to enable or disable the entire DNS filtering engine via script.
- Cache-clear functionality to force immediate propagation of new filtering rules.
- Integration support for automated cybersecurity workflows using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
CV Builder
A sophisticated AI agent skill that generates professional resumes, interactive CVs, and 3D digital identities with built-in human-in-the-loop verification.
HITL Protocol
An open standard for integrating human decision-making directly into autonomous AI agent workflows using HTTP 202 responses.
OpenClaw Update
A dedicated management skill for monitoring and applying version updates to the OpenClaw platform.
OpenClaw Update Skill
A specialized management tool for checking, applying, and verifying updates to the OpenClaw platform and its core components.
WLED Control
A Python-powered CLI tool for controlling WLED-enabled LED strips and matrices via their native JSON API.
AI Daily Digest
An intelligent RSS aggregator that fetches content from 90 elite tech blogs and uses AI to generate a curated, categorized daily summary.
Featured*
