Adguard Home

What This Skill Does

The AdGuard Home skill for OpenClaw provides a comprehensive interface for monitoring and managing your AdGuard Home DNS server instances. It transforms your CLI environment into a powerful dashboard for network observability. Whether you are managing a single home server or multiple distributed instances, this tool enables you to track DNS query volume, identify top blocked domains, monitor active clients, and perform health diagnostics without ever leaving your terminal.

Installation

You can install the skill using the ClawHub CLI for a seamless experience. Simply run: clawhub install openclaw/skills/skills/foxleoly/adguard-home. For manual installation, clone the repository from GitHub into your ~/.openclaw/workspace/skills/adguard-home/ directory. After installation, define your server connections in ~/.openclaw/workspace/adguard-instances.json, ensuring you set proper file permissions (chmod 600) to protect your instance credentials. This configuration file supports multiple instance definitions, allowing you to switch between servers instantly using command flags.

Use Cases

• Network Health Monitoring: Periodically check the status of your AdGuard Home instances to ensure your DNS services are running smoothly.
• Threat Intelligence: Use the top-blocked domains feature to identify potential malware, tracking, or phishing attempts happening within your network.
• Performance Tuning: Analyze DNS query logs and client activity to optimize your filter lists and network performance.
• Security Auditing: Easily verify TLS and encryption statuses to ensure your network traffic remains private and secure against interception.

Example Prompts

1. "Adguard, can you show me the current health status and recent DNS statistics for my home server named dns1?"
2. "List the top 10 most frequently blocked domains on my primary dns1 instance to see if there is any unusual activity."
3. "Show me the last 20 DNS queries recorded by the dns1 instance so I can verify if my ad-blocking rules are catching everything."

Tips & Limitations

• Security First: Always use HTTPS URLs for your instance connections to ensure your administrative credentials are encrypted in transit.
• Configuration: Ensure the user account provided in the JSON configuration has sufficient API permissions to query the stats you require.
• Limitations: This skill is read-heavy for monitoring; while it can inspect configurations, extensive management of blocklists should be handled through the primary AdGuard Home web dashboard for the most granular control. Be mindful that frequent polling of large log files may impact server performance if your network is exceptionally busy.