An AI-powered monitoring extension for AdGuard Home that provides real-time DNS analytics and instance management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install adguard-test
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-test 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 extension for Openclaw Skills allows developers and home lab enthusiasts to monitor their DNS infrastructure directly through an AI agent. It provides a technical interface to query statistics, inspect blocked domains, and analyze client activity across multiple AdGuard Home instances. This integration is designed to enhance network visibility by surfacing critical DNS health metrics and security logs within a developer-centric workflow.
By leveraging Openclaw Skills, users can automate the inspection of filter rules, verify TLS encryption status, and monitor upstream server performance. The skill focuses on security hardening, utilizing native HTTPS requests and secure credential management to ensure that sensitive network data remains protected while providing actionable insights into network traffic.
AdGuard Home Skill Use Cases
- Real-time monitoring of DNS query statistics and blocked request percentages.
- Identifying the top 10 blocked domains to adjust security filtering rules.
- Analyzing active client behavior to identify high-bandwidth or suspicious devices.
- Troubleshooting network issues by reviewing recent DNS query logs and upstream response times.
- Auditing the health and configuration of multiple AdGuard Home instances from a single interface.
How AdGuard Home Skill Works
- The user issues a command via an AI agent, specifying the desired AdGuard Home instance.
- The skill performs a secure login using cookie-based authentication via the control/login endpoint.
- It maps the user command to specific AdGuard Home REST API endpoints such as stats, status, or filtering.
- Data is retrieved using a native Node.js HTTPS client to ensure security and performance.
- The skill processes the raw API data and formats it into technical summaries for the AI agent to display.
AdGuard Home Skill Setup
The most efficient way to get started with this extension for Openclaw Skills is via the CLI:
# Install the skill
clawhub install adguard-home
For secure credential management, it is recommended to use environment variables:
export ADGUARD_URL="http://your-instance-ip:port"
export ADGUARD_USERNAME="admin"
export ADGUARD_PASSWORD="your-password"
Alternatively, you can configure multiple instances by creating a JSON configuration file at ~/.openclaw/workspace/adguard-instances.json and securing it with chmod 600.
AdGuard Home Skill Data Schema & Taxonomy
The skill manages instance metadata and processes AdGuard Home API responses. The primary configuration schema for Openclaw Skills includes:
| Parameter | Type | Description |
|---|---|---|
| url | String | The base URL of the AdGuard Home instance |
| username | String | Administrative username |
| password | String | Administrative password or secret reference |
| instances | Object | A map of instance identifiers to their respective connection details |
Response data includes DNS statistics, service status (version, protection state), and query log entries containing timestamps, status (OK/BLOCKED), and client IPs.
AdGuard Home Skill Advanced Features
- Multi-instance support allowing seamless switching between different network environments.
- Zero-plaintext credential support through environment variables and 1Password CLI integration.
- Advanced query log filtering with customizable entry limits (1-100).
- Comprehensive filter rule inspection including active list counts and update intervals.
- Native Node.js implementation that avoids shell injection risks by bypassing external curl dependencies.
SKILL.md
Loading
Related Openclaw Skills
AdGuard Home Skill
A comprehensive monitoring tool for AdGuard Home instances that provides real-time DNS statistics, security audits, and client activity analysis.
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.
Binance DCA
A professional-grade tool for planning, simulating, and executing automated Dollar-Cost Averaging (DCA) strategies on the Binance exchange.
Binance DCA Tool
A powerful automation tool for executing and planning Dollar-Cost Averaging strategies directly on the Binance exchange.
Featured*
