A local DNS sinkhole that blocks ads, trackers, and malware across your entire network without the need for dedicated hardware.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install adblock-dns
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 adblock-dns 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 AdBlock DNS?
AdBlock DNS is a sophisticated network-level security tool designed for Openclaw Skills users who need a robust Pi-hole alternative running directly on their local workstation or server. It acts as a DNS sinkhole, intercepting and neutralizing requests for known ad-serving, tracking, and malware domains before they ever reach your browser or apps. By leveraging this skill, you can achieve a cleaner, faster, and more private browsing experience for every device connected to your network, including smartphones, tablets, smart TVs, and IoT devices.
This skill is built for performance and reliability, utilizing the same industry-standard blocklists as major hardware solutions. It provides a centralized point of control for your network privacy, allowing you to monitor traffic and manage domain permissions through a simple, automated interface. By integrating AdBlock DNS into your environment via Openclaw Skills, you eliminate the need for per-device ad-blocking software while gaining significant protection against telemetry and data harvesting.
AdBlock DNS Use Cases
- Eliminating intrusive banner ads and tracking pixels across all home or office devices simultaneously.
- Preventing smart TVs and IoT hardware from communicating with telemetry or analytics servers.
- Reducing mobile data usage and increasing battery life by preventing ad-heavy content from loading in apps.
- Creating a safer browsing environment by automatically blocking access to known phishing and malware domains.
How AdBlock DNS Works
- The skill initializes a local DNS server that listens for incoming queries on port 53.
- When a device on your network requests a domain, the skill compares that domain against a database of 189,000+ blocked entries.
- If the domain is identified as an ad or tracker, the server returns 0.0.0.0, effectively preventing the connection.
- Clean queries are seamlessly forwarded to a secure upstream provider, such as Cloudflare (1.1.1.1), for resolution.
- All query activity is logged, providing real-time stats on blocked traffic and network health via an internal API.
AdBlock DNS Setup
Setting up AdBlock DNS with Openclaw Skills requires a few simple terminal commands:
- Run the automated setup script to install dependencies and configure the system service:
cd /path/to/skills/adblock/scripts
bash setup.sh
- Identify your machine's local IP address to use as the DNS target:
hostname -I | awk '{print $1}'
Update your router's DHCP settings or your individual device's DNS configuration to point to the IP address identified in the previous step.
Verify that blocking is active by testing a known ad domain:
nslookup ads.google.com <YOUR_MACHINE_IP>
AdBlock DNS Data Schema & Taxonomy
The skill manages its configuration and blocklists within the data/ directory using a transparent file structure:
| File | Purpose |
|---|---|
blocklist.txt |
The master list of ~150,000+ domains compiled from multiple sources. |
whitelist.txt |
User-defined domains that are explicitly allowed to bypass blocking. |
custom-blacklist.txt |
Manually added domains that you wish to block regardless of standard lists. |
stats.json |
Stores historical data on total queries, blocked counts, and top domains. |
config.json |
Stores configuration for upstream providers and API port settings. |
AdBlock DNS Advanced Features
- Automatic blocklist synchronization that refreshes every 24 hours to ensure protection against new threats.
- A dedicated REST API for real-time monitoring, allowing you to fetch stats or modify whitelists programmatically.
- Systemd service integration for high availability, ensuring the DNS server starts on boot and restarts automatically if interrupted.
- Support for both IPv4 and IPv6 query blocking to provide comprehensive coverage across modern network stacks.
- Custom blacklist support for blocking specific domains that may not be included in standard community lists.
SKILL.md
Loading
Related Openclaw Skills
Social Posting Skill
A multi-platform social media distribution service with automatic provider failover and support for nine major social networks.
Reddit Karma Scanner
An automated Reddit opportunity scanner that identifies high-potential posts and generates professional, AI-powered comments for strategic karma building.
Pinterest Search Scraper
An automated tool for scraping Pinterest search results to collect high-resolution images, descriptions, and direct links using infinite scroll technology.
Instagram Public Profile Scraper
A lightweight Python tool for scraping public Instagram profile metrics and recent post data without requiring a login or browser automation.
Backup Manager
A comprehensive automated backup solution for local, network, and cloud storage using enterprise-grade tools like rsync and rclone.
Country Info
A specialized integration for Openclaw Skills that retrieves comprehensive global data including demographics, currencies, and geography.
Featured*
