A read-only Reddit browsing tool for AI agents that extracts posts and comments via public JSON endpoints without requiring write access.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install reddit-readonly
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 reddit-readonly 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 Reddit Readonly?
Reddit Readonly is a specialized tool designed to facilitate non-intrusive data gathering from the Reddit platform. As part of the Openclaw Skills ecosystem, it allows AI agents to search for topics, browse subreddits, and pull full comment threads for context without the need for posting, voting, or moderation permissions. This makes it an ideal choice for developers and researchers who need to monitor community sentiment or gather public data while maintaining a read-only footprint.
By leveraging public JSON endpoints, this skill provides a structured way to access Reddit's vast repository of information. It is built to be polite to the platform, offering configurable rate limiting and small default request sizes. Integrating this with other Openclaw Skills enables automated research workflows that can identify trends and summarize discussions efficiently.
Reddit Readonly Use Cases
- Searching across multiple subreddits for specific keywords or topics of interest.
- Extracting deep comment threads to provide comprehensive context for AI analysis.
- Monitoring subreddit feeds for trending posts based on score or age.
- Building a curated shortlist of Reddit permalinks for manual follow-up or reply.
- Identifying community opportunities by filtering posts by engagement metrics and custom keyword exclusions.
How Reddit Readonly Works
- The AI agent receives a query or research objective involving Reddit data.
- The agent uses the search or find commands to query public Reddit endpoints for relevant posts.
- Results are filtered based on user-defined criteria such as score, age, or subreddit relevance.
- For selected posts, the agent retrieves the comment bundle to understand the nuance of the discussion.
- The agent formats the gathered intelligence, including permalinks, to present a structured overview to the user.
Reddit Readonly Setup
To integrate this capability into your project, ensure you have Node.js installed. You can configure the skill using environment variables to control request timing and user-agent settings. This ensures your use of Openclaw Skills remains compliant with platform expectations.
# List posts from a specific subreddit
node ./scripts/reddit-readonly.mjs posts python --sort hot --limit 10
# Configure custom delays for rate limiting
export REDDIT_RO_MIN_DELAY_MS=800
export REDDIT_RO_MAX_DELAY_MS=1800
Reddit Readonly Data Schema & Taxonomy
The skill provides a consistent JSON output format for all commands, making it easy to parse for automated workflows within Openclaw Skills.
| Field | Type | Description |
|---|---|---|
| ok | Boolean | Indicates if the request was successful. |
| data | Object/Array | The actual content retrieved (posts, comments, etc.). |
| error | Object | Contains message and details if the request fails. |
| permalink | String | A direct link to the Reddit thread or comment. |
Reddit Readonly Advanced Features
- Advanced filtering with the find command to include or exclude specific keywords across multiple subreddits.
- Customizable depth and limit controls for comment threads to optimize token usage in AI workflows.
- Environment variable support for setting custom user-agent strings and timeout thresholds.
- Automatic detection of HTML responses to trigger retry logic for consistent data retrieval.
- Seamless integration for building complex research pipelines alongside other Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
SocialRails
A comprehensive social media management skill that enables post scheduling, AI caption generation, and analytics tracking via chat commands.
fdv.lol - Headless Memecoin Auto Trader
A CLI-based automated memecoin trader for Solana that leverages Agent Gary for autonomous AI-driven decision making.
Fractal Memory
Fractal Memory is an automated hierarchical compression system that distills raw agent experiences into structured patterns to prevent context overflow.
HokiPoki
A CLI-based P2P tool for routing tasks to different AI models and sharing subscriptions securely within teams.
TorrentClaw
TorrentClaw is a powerful AI agent skill for searching, filtering, and downloading high-quality movie and TV torrents with automated local client integration.
AIPex Browser Control
Control Chrome tabs, interact with web elements, and automate complex browser workflows using an AI-powered MCP bridge and extension.
Featured*
