A specialized tool for searching subreddits and extracting comment threads via public JSON endpoints without requiring authenticated API access.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install reddit-read-only
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-read-only 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 high-performance utility designed for the Openclaw Skills ecosystem to facilitate deep research and community monitoring. It provides a structured way to interact with Reddit's public data, allowing agents to fetch hot, new, top, or controversial posts without the overhead of complex authentication. By utilizing public JSON endpoints, it ensures that data gathering remains lightweight and transparent.
This skill is built for developers and researchers who need to surface insights from specific communities or track keywords across the platform. It prioritizes data integrity and politeness, strictly adhering to a read-only protocol to prevent unauthorized modifications or automated interactions while providing all the necessary metadata like permalinks and scores for manual follow-up.
Reddit Readonly Use Cases
- Monitoring multiple subreddits for specific technical keywords or product mentions.
- Researching community sentiment and common pain points within niche forums.
- Compiling lists of high-engagement posts for manual outreach or marketing analysis.
- Extracting full comment hierarchies to provide deep context for AI analysis.
How Reddit Readonly Works
- The agent receives a request to find information or browse a specific subreddit.
- The skill executes a Node.js script that targets Reddit's public .json endpoints.
- Search queries or subreddit listings are processed with configurable limits and timeframes.
- The raw data is parsed into a clean JSON format, including post IDs, scores, and permalinks.
- Structured results are delivered to the agent to be presented as a curated shortlist for the user.
Reddit Readonly Setup
To use this skill within Openclaw Skills, ensure you have Node.js installed on your system. You can configure custom user agents and request delays via environment variables to ensure stable performance.
# Set a custom user agent for requests
export REDDIT_RO_USER_AGENT='script:clawdbot-reddit-readonly:v1.0.0 (personal)'
# Configure optional delays to avoid rate limits
export REDDIT_RO_MIN_DELAY_MS=800
export REDDIT_RO_MAX_DELAY_MS=1800
Reddit Readonly Data Schema & Taxonomy
The skill returns structured JSON objects for every command. The schema is designed to be easily digestible by both human users and AI agents.
| Key | Type | Description |
|---|---|---|
| ok | boolean | Success status of the request |
| data | object | The actual payload containing posts or comments |
| permalink | string | Direct link to the content on Reddit |
| score | number | Current upvote/downvote score of the post |
| error | object | Detailed error message and context if 'ok' is false |
Reddit Readonly Advanced Features
- Advanced search across multiple subreddits simultaneously with the find helper.
- Granular filtering using include/exclude keywords and minimum score thresholds.
- Comprehensive thread bundling that captures both the parent post and deep-nested comments in a single operation.
- Configurable rate-limiting and timeout parameters to handle network fluctuations gracefully.
SKILL.md
Loading
Related Openclaw Skills
Notion Management Skill
A JSON-first CLI skill for managing Notion pages, databases, and Markdown content with deterministic script execution.
iOS Simulator Automation
An advanced CLI wrapper that enables AI agents to programmatically control iOS simulators, manage app lifecycles, and perform accessibility-based UI navigation.
Fabric API Skill
A cross-platform skill for Openclaw Skills that enables AI agents to create, search, and organize content within a Fabric workspace using the official HTTP API.
Mistral OCR PDF Extraction
A powerful tool for converting complex PDFs and scanned documents into structured Markdown and JSON using the Mistral OCR API.
Todoist API Skill
A comprehensive CLI and automation toolkit for managing Todoist tasks, projects, and workflows via the Todoist API v1.
track17
A comprehensive parcel tracking integration that connects AI agents to the 17TRACK API for real-time shipment monitoring and local data persistence.
Featured*
