A lightweight, privacy-focused command-line utility for performing DuckDuckGo searches directly from your terminal or AI agent environment.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ddg-1-0-0
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 ddg-1-0-0 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 DuckDuckGo CLI (ddgr)?
The DuckDuckGo CLI skill, also known as ddgr, allows developers and AI agents to query the web without a browser. It is a critical component for Openclaw Skills that require real-time information retrieval while maintaining strict privacy standards. By leveraging this tool, you can fetch search results in clean text or structured JSON, making it ideal for integration into automated scripts and coding workflows.
This utility bypasses the need for heavy browser engines, providing a fast and terminal-friendly way to browse the web. Whether you are looking for documentation, troubleshooting errors, or gathering data for a project, this tool ensures your search history remains private while delivering accurate results directly to your command line.
DuckDuckGo CLI (ddgr) Use Cases
- Perform quick web searches without leaving the terminal or IDE environment.
- Retrieve structured JSON search results for programmatic processing within Openclaw Skills.
- Utilize DuckDuckGo bangs (e.g., !gh, !w) for targeted site searches on GitHub or Wikipedia.
- Conduct research privately using the Tor network or HTTPS proxies to avoid user profiling.
- Fetch time-sensitive information such as the latest software releases or news updates using time-limit filters.
How DuckDuckGo CLI (ddgr) Works
- The user or AI agent executes the ddgr command with specific query parameters and optional flags.
- The utility connects to DuckDuckGo's privacy-focused interface to fetch relevant results.
- Search results are filtered and narrowed down based on flags like site-specific constraints or specific time ranges.
- The output is rendered either in an interactive terminal interface for manual browsing or as a raw data stream for the agent to parse.
- Structured data can then be passed to other Openclaw Skills to inform complex development tasks.
DuckDuckGo CLI (ddgr) Setup
Install the tool using your preferred package manager. For Ubuntu users, snap is the recommended installation method:
sudo snap install ddgr
Alternatively, you can install it via the PPA for Debian-based systems:
sudo add-apt-repository ppa:twodopeshaggy/jarun
sudo apt-get update
sudo apt-get install ddgr
For advanced users, build from source to ensure you have the latest features compatible with Openclaw Skills:
git clone https://github.com/jarun/ddgr.git
cd ddgr
sudo make install
DuckDuckGo CLI (ddgr) Data Schema & Taxonomy
The skill returns data in structured formats, particularly when using the --json flag. This metadata taxonomy is essential for Openclaw Skills to interpret web data accurately.
| Field | Description |
|---|---|
| title | The headline or page title of the search result |
| url | The direct, expanded link to the resource |
| abstract | A brief snippet or summary of the content found on the page |
In non-interactive mode, results are indexed numerically, allowing agents to select and process specific links based on relevance.
DuckDuckGo CLI (ddgr) Advanced Features
- Support for DuckDuckGo bangs to search across thousands of external platforms instantly.
- Integrated JSON output mode enabling seamless interoperability with other Openclaw Skills.
- Built-in privacy protections including Do Not Track (DNT) headers and no search history storage.
- Global region support allowing for localized search results across different countries and languages.
- Non-interactive mode using the
--npflag, which is optimized for automated AI agent workflows and headless environments.
SKILL.md
Loading
Related Openclaw Skills
macOS Reminders Skill
An AI-driven interface for managing native macOS Reminders through simple CLI commands and JSON responses.
Google Calendar
A powerful skill for AI agents to interact with Google Calendar accounts, enabling seamless event management and scheduling through a unified CLI.
Google Calendar Skill
A comprehensive automation skill that enables AI agents to manage Google Calendar events, query availability, and handle multiple accounts through a streamlined CLI interface.
Miniflux
A powerful CLI-based tool for AI agents to interact with Miniflux RSS feeds, allowing for article discovery, reading, and management.
XRPL Micropayments
A specialized plugin for enabling instant, low-cost XRP micropayments and automated fee splitting for AI-driven services.
Pulse App Development Skill
A comprehensive development toolkit for building, scaffolding, and deploying module-federated React extensions for the Pulse Editor ecosystem.
Featured*
