A comprehensive monitoring tool for AdGuard Home instances that provides real-time DNS statistics, security audits, and client activity analysis.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install adguard-home
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-home 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 Skill?
The AdGuard Home Skill is a powerful integration designed for Openclaw Skills that enables developers and home lab enthusiasts to interact directly with their AdGuard Home DNS servers. This skill facilitates deep visibility into network traffic, allowing users to query multiple instances for real-time DNS statistics, service health, and security filtering status. By integrating this into your workflow, you gain a centralized dashboard for managing privacy and security across your entire infrastructure.
Developed with a focus on security and performance, the skill utilizes native Node.js HTTPS modules and supports modern credential management. Whether you are troubleshooting connectivity issues or auditing blocked domains, this addition to your Openclaw Skills library provides the technical transparency needed to maintain a high-performance network environment.
AdGuard Home Skill Use Cases
- Monitoring real-time DNS query volumes and blocking percentages across distributed instances.
- Auditing blocked domain leaderboards to identify potential malware activity or tracking attempts.
- Troubleshooting network issues by analyzing recent query logs and client-specific DNS requests.
- Verifying the status of upstream DNS providers and ensuring TLS encryption is active.
- Inspecting and managing filter rules and blocklists to optimize network performance.
How AdGuard Home Skill Works
- The skill initializes by retrieving configuration data from environment variables, the 1Password CLI, or a local workspace JSON file.
- It authenticates with the target AdGuard Home instance using a secure cookie-based login flow via the control API.
- User-issued commands are validated and translated into specific API requests to endpoints such as /control/stats or /control/querylog.
- The skill processes the returned JSON data, performing necessary calculations like blocking percentages and response time averages.
- Formatted technical reports are delivered to the user, providing actionable insights into the DNS server's operational status.
AdGuard Home Skill Setup
Install the skill via the command line:
# Install from the registry
clawhub install adguard-home
Configure your credentials using environment variables for maximum security:
export ADGUARD_URL="http://192.168.1.1:80"
export ADGUARD_USERNAME="admin"
export ADGUARD_PASSWORD="your-secure-password"
Verify the installation within Openclaw Skills:
/adguard health dns1
AdGuard Home Skill Data Schema & Taxonomy
The skill organizes and retrieves data based on the following taxonomy:
| Category | Description | Key Metadata |
|---|---|---|
| DNS Stats | Aggregate traffic metrics | Total queries, blocked requests, average response time |
| Service Status | Instance health data | Version, protection state, active ports, DHCP availability |
| Filtering | Blocklist configuration | Enabled filters, user rules count, update intervals |
| Query Log | Request history | Timestamp, status (OK/Blocked), client IP, triggering rule |
| Security | Encryption metrics | TLS status, certificate validity, DNSSEC configuration |
AdGuard Home Skill Advanced Features
- Multi-instance support allows for seamless switching between different DNS servers using named instance aliases.
- Integrated 1Password CLI support enables secure, plaintext-free credential injection at runtime.
- Configurable query log depth, allowing users to inspect up to 100 recent entries with a single command.
- Real-time client analysis identifies the most active devices on the network for bandwidth and security auditing.
- Native ES Module implementation ensures high efficiency and compatibility with modern Openclaw Skills environments.
SKILL.md
Loading
Related Openclaw Skills
X-Claw Agent
A secure Python-based runtime for executing crypto wallet operations, automated trading, and liquidity management with a fail-closed deterministic architecture.
Telegram Context
A toggle-enabled skill that retrieves recent Telegram message history to ensure conversational continuity across agent sessions.
sam-tts
A retro robotic text-to-speech engine for AI agents that recreates the iconic Commodore 64 SAM voice.
Krea.ai Image Generation Skill
A professional-grade AI skill for generating high-quality images via Krea.ai using advanced models like Flux and Imagen.
AdGuard Home Skill
An AI-powered monitoring extension for AdGuard Home that provides real-time DNS analytics and instance management.
Binance DCA
A professional-grade tool for planning, simulating, and executing automated Dollar-Cost Averaging (DCA) strategies on the Binance exchange.
METADATA
Featured*
