OpenParable
Skip to content
← Back to skills

Reddit

Apps & Automation
reddit

Reddit is an Agent Skill for apps & automation published in the LeoYeAI/openclaw-master-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Browse, search, post, and moderate Reddit. Read-only works without auth; posting/moderation requires OAuth setup.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/LeoYeAI/openclaw-master-skills/blob/HEAD/skills/reddit/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/reddit, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Reddit

Browse, search, post to, and moderate subreddits. Read-only actions work without auth; posting/moderation requires OAuth setup.

Setup (for posting/moderation)

  1. Go to https://www.reddit.com/prefs/apps
  2. Click "create another app..."
  3. Select "script" type
  4. Set redirect URI to http://localhost:8080
  5. Note your client ID (under app name) and client secret
  6. Set environment variables:
    export REDDIT_CLIENT_ID="your_client_id"
    export REDDIT_CLIENT_SECRET="your_client_secret"
    export REDDIT_USERNAME="your_username"
    export REDDIT_PASSWORD="your_password"
    

Read Posts (no auth required)

# Hot posts from a subreddit
node {baseDir}/scripts/reddit.mjs posts wallstreetbets

# New posts
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort new

# Top posts (day/week/month/year/all)
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort top --time week

# Limit results
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --limit 5

Search Posts

# Search within a subreddit
node {baseDir}/scripts/reddit.mjs search wallstreetbets "YOLO"

# Search all of Reddit
node {baseDir}/scripts/reddit.mjs search all "stock picks"

Get Comments on a Post

# By post ID or full URL
node {baseDir}/scripts/reddit.mjs comments POST_ID
node {baseDir}/scripts/reddit.mjs comments "https://reddit.com/r/subreddit/comments/abc123/..."

Submit a Post (requires auth)

# Text post
node {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Weekly Discussion" --text "What's on your mind?"

# Link post
node {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Great article" --url "https://example.com/article"

Reply to a Post/Comment (requires auth)

node {baseDir}/scripts/reddit.mjs reply THING_ID "Your reply text here"

Moderation (requires auth + mod permissions)

# Remove a post/comment
node {baseDir}/scripts/reddit.mjs mod remove THING_ID

# Approve a post/comment
node {baseDir}/scripts/reddit.mjs mod approve THING_ID

# Sticky a post
node {baseDir}/scripts/reddit.mjs mod sticky POST_ID

# Unsticky
node {baseDir}/scripts/reddit.mjs mod unsticky POST_ID

# Lock comments
node {baseDir}/scripts/reddit.mjs mod lock POST_ID

# View modqueue
node {baseDir}/scripts/reddit.mjs mod queue yoursubreddit

Notes

  • Read actions use Reddit's public JSON API (no auth needed)
  • Post/mod actions require OAuth - run login command once to authorize
  • Token stored at ~/.reddit-token.json (auto-refreshes)
  • Rate limits: ~60 requests/minute for OAuth, ~10/minute for unauthenticated