# How to connect Reddit to Hermes Agent (no API keys)

> Connect Reddit to Hermes with ClawLink in one click — 22 tools your AI agent can call from chat via hosted OAuth. No API keys, no manual setup.

Web version: https://claw-link.dev/hermes/reddit

Most guides for giving Hermes Agent Reddit access start with registering your own OAuth app or pasting API keys into env files, then leave the token refresh and tool wiring to you. ClawLink gives Hermes a more practical Reddit setup: pair once in the browser and your always-on Hermes agent can act on Reddit for you, reading and doing real work on your behalf with no auth, token refresh, or tool wiring to build yourself.

**Start here — paste this into Hermes to set up ClawLink:**

> Set up ClawLink for Hermes and tell me when it's ready.
> 1. Install the plugin: `hermes plugins install ClawLink-HQ/hermes-plugin --enable`
> 2. Start pairing with `hermes clawlink begin`. It prints an approval link, so show me the link and stop, don't wait.
> 3. I'll approve it in my browser, then reply "approved".
> 4. When I say approved, finish setup: `hermes clawlink finish`
> 5. Then run `hermes clawlink test` and tell me whether ClawLink is ready.

## Setup

It takes three steps to connect Hermes to Reddit.

1. **Install ClawLink** — add the plugin to Hermes Agent once.
2. **Connect Reddit** — one-click OAuth in the ClawLink dashboard.
3. **Use it from chat** — ask Hermes Agent in plain English.

**Alternative for any agent (no plugin needed):** if the Hermes Agent plugin route isn't available or doesn't work, any AI agent with shell access can use the ClawLink CLI instead:

```bash
npx -y @useclawlink/cli login          # sign in via browser — no API key to paste
npx -y @useclawlink/cli connect reddit  # connect Reddit (browser OAuth)
npx -y @useclawlink/cli actions reddit  # list available actions
npx -y @useclawlink/cli run reddit <action> --input '<json>'  # execute (add --confirm for writes)
```

### Install by command

The prompt above walks Hermes through this. By hand, it is four commands and a browser approval:

```bash
hermes plugins install ClawLink-HQ/hermes-plugin --enable
hermes clawlink begin    # prints an approval link — open it and approve
hermes clawlink finish   # after approving in the browser
hermes clawlink test
```

Then connect Reddit in the [ClawLink dashboard](https://claw-link.dev/dashboard) — a one-click OAuth approval, no API keys.

Verify the connection by asking Hermes:

> Check the rules of r/[subreddit] with reddit_get_subreddit_rules and the flairs with reddit_list_subreddit_post_flairs. Then draft a text post about [topic] that fits both, show it to me, and wait for my approval before calling reddit_create_reddit_post.

### Using a different agent?

The Hermes plugin is one client of ClawLink's MCP server. Claude Code, Cursor, Codex, or any agent that can run a shell command pairs with the same ClawLink account through the CLI:

```bash
npx -y @useclawlink/cli login
```

`login` opens the same browser approval and stores a credential locally. Once Reddit is connected in the dashboard, that agent calls the same 22 Reddit tools over MCP. Full setup for MCP clients and shell agents: [connect apps to any AI agent](https://claw-link.dev/learn/connect-apps-to-any-ai-agent).

## Reddit MCP for Hermes

Looking for a Reddit MCP server for Hermes Agent? ClawLink connects Reddit to Hermes Agent and exposes 22 Reddit tools your agent can call over [MCP](https://claw-link.dev/learn/what-is-an-mcp-server), with [hosted auth](https://claw-link.dev/learn/oauth-for-ai-agents) and nothing to run or maintain yourself. Using OpenClaw instead? The [OpenClaw Reddit integration](https://claw-link.dev/openclaw/reddit) works the same way.

Every guide for this starts with the same two steps: Composio's curl install one-liner, then a `~/.hermes/config.yaml` block holding an `x-consumer-api-key` and a connect timeout. What none of them show is the alternative that skips both: a Reddit connection with no developer app, no client id and secret, and no config file. ClawLink connects Reddit through an app that is already registered and runs its calls under that app, so the token refresh and the Reddit User-Agent requirements are handled for you. What is still on you is judgment: the agent posts and comments as your account, so the write tools deserve an approval step in the prompt.

## What this Reddit integration does not do

The boundaries, so a prompt does not ask for something outside the 22 tools.

- **No inbox or private messages.** The connection's scopes are identity, read, vote, submit, flair, and edit; there is no history or privatemessages scope, so DMs are out of reach.
- **No voting.** The connection holds the vote scope but the 22-tool set has no vote tool, so the agent cannot upvote or downvote on your behalf.
- **No admin or moderator surfaces.** Banning users, removing others' posts, and moderating queues are not in the tool set, even for accounts that hold moderator roles.
- **No scheduling.** Posts go out when the tool runs; there is no draft queue or scheduler inside this integration.

The "best Reddit MCP server" roundup shape is deliberately not answered here; that is a /hub comparison, and the community servers that lead those lists have not been evaluated on this page.

## What the Hermes Agent Reddit integration can do

22 Reddit tools are ready for Hermes Agent once the account is connected. The 20 below are the ones people reach for most; your agent can call all 22.

### 20 of 22 Reddit tools for Hermes

| Tool | What it does |
|---|---|
| **Create reddit post** `reddit_create_reddit_post` | Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair. |
| **Edit reddit comment or post** `reddit_edit_reddit_comment_or_post` | Edits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles. |
| **Get** `reddit_get` | Tool to retrieve a listing of Reddit posts sorted by the specified criteria (hot, new, top, etc.). |
| **Get controversial posts** `reddit_get_controversial_posts` | Tool to retrieve controversial posts from all subreddits with time filters. |
| **Get me prefs** `reddit_get_me_prefs` | Tool to retrieve preference settings of the logged in user. Use when you need to check user preferences or settings. |
| **Get r top** `reddit_get_r_top` | Tool to retrieve top-rated posts from a subreddit with time filters. Use when you need to find the most popular posts from a specific time period (hour, day, week, month, year, or all-time). |
| **Get random** `reddit_get_random` | Tool to retrieve a random public Reddit post from any subreddit. Use when you want to discover serendipitous content or need a random post for testing or entertainment purposes. |
| **Get reddit user about** `reddit_get_reddit_user_about` | Retrieves information about a specified Reddit user account, including karma scores and gold status. Use when you need to get profile information for any public Reddit user. |
| **Get scopes** `reddit_get_scopes` | Tool to retrieve all available OAuth scopes supported by the Reddit API. Use when you need to understand what permissions are available or check scope definitions. |
| **Get subreddit rules** `reddit_get_subreddit_rules` | Fetch the explicit posting rules for a subreddit to ensure compliance before posting or commenting. |
| **Get subreddits search** `reddit_get_subreddits_search` | Search subreddits by title and description |
| **Get user flair** `reddit_get_user_flair` | Fetches the list of user flair assignments for a given subreddit |
| **Get username available** `reddit_get_username_available` | Check whether a username is available for registration on Reddit |
| **List subreddit post flairs** `reddit_list_subreddit_post_flairs` | List available link/post flairs for a subreddit (including flair_template_id) so posts can |
| **Retrieve post comments** `reddit_retrieve_post_comments` | Retrieves all comments for a Reddit post given its base-36 article ID |
| **Retrieve reddit post** `reddit_retrieve_reddit_post` | Retrieves posts from a specified, publicly accessible subreddit |
| **Retrieve specific comment** `reddit_retrieve_specific_comment` | Retrieves detailed information for a single Reddit comment or post using its fullname |
| **Search across subreddits** `reddit_search_across_subreddits` | Searches Reddit for posts/comments using a query |
| **Post reddit comment** `reddit_post_reddit_comment` | Posts a comment on Reddit, replying to an existing submission (post) or another comment |
| **Toggle inbox replies** `reddit_toggle_inbox_replies` | Enable or disable inbox replies for a submission or comment |

## Example prompts

**Draft a post for approval**

> Check the rules of r/[subreddit] with reddit_get_subreddit_rules and the flairs with reddit_list_subreddit_post_flairs. Then draft a text post about [topic] that fits both, show it to me, and wait for my approval before calling reddit_create_reddit_post.

**Comment with a rules check**

> For the post I link, run reddit_retrieve_specific_comment on its id to see the top comments, then check the subreddit rules. Write a comment that adds information rather than repeating an existing one, show it to me, and do not call reddit_post_reddit_comment until I approve.

**Monitor a topic across subreddits**

> Use reddit_search_across_subreddits for [topic] with a recent time filter and show me the top results with their scores and subreddits. For the three most relevant posts, pull reddit_retrieve_post_comments and summarize what people are saying, flagging any posts older than six months since those can no longer be replied to.

**Find the right subreddit**

> Run reddit_get_subreddits_search for [topic] and show me the matching communities with their subscriber counts. For the top three, pull their rules and tell me which one would be the best home for a question about [specific question], and why.

## How the Reddit tools behave

Facts from the live schemas and the manifest that change how a prompt should be written.

- **Every comment and edit takes a fullname, not an id.** `thing_id` must be 't3_' for a post or 't1_' for a comment followed by the base-36 id (for example t3_10omtdx). The tools reject calls that omit it, which is the most common production error.
- **`reddit_retrieve_post_comments` returns a two-element listing.** Post metadata lives in `listings[0]` and the comments in `listings[1].data.children`, with text at each `[].data.body` and replies nested under `replies`. An agent that reads only the top level of the response will report an empty thread.
- **Posting can succeed and still not be visible.** The manifest documents silent removal by automoderator and subreddit rules after a successful API response, with the errors SUBMIT_VALIDATION_BODY_BLACKLISTED_STRING and POST_GUIDANCE_VALIDATION_FAILED. Verify visibility after posting rather than trusting the response.
- **Reddit's rate limit answers with named cooldowns.** Bursts trip "take a break for X minutes" errors with an explicit wait; the manifest says to honor it before retrying. The User-Agent and per-client quotas from developer docs are not things a hosted connection's user can adjust.
- **`reddit_get_subreddit_rules` exists for a reason.** Comment and post tools fail against subreddit rules, including Reddit's AI-content rule, so reading the rules before a write is a schema-level option, not politeness.

## ClawLink vs. building it yourself

The alternative to ClawLink is usually manual OAuth app setup plus your own token handling, permission troubleshooting, and tool plumbing for Hermes Agent. That is fine if you want to build and maintain the integration yourself. Most teams just want Reddit working from chat.

| | Manual | ClawLink |
|---|---|---|
| **Connection flow** | Register a Reddit app, configure redirect URLs, manage consent details, and reconnect users when auth settings drift. | Users connect Reddit through the hosted browser flow and ClawLink keeps the token lifecycle out of your app code. |
| **Ongoing maintenance** | You own refresh logic, permission debugging, environment config, and every provider-specific edge case for Reddit. | ClawLink handles the repetitive integration plumbing so your team can focus on the workflow instead of the infrastructure. |
| **Agent usability** | You still need to expose the right Reddit actions to the runtime in a format your agent can reliably use. | 22 tools for Reddit are already exposed through ClawLink, so the agent can read and act from chat immediately. |

## ClawLink vs. Composio

Composio also exposes Reddit to AI agents. It is developer infrastructure: Python and TypeScript SDKs, an MCP server, and a catalog past 1,000 apps, aimed at teams shipping agent products. ClawLink is built for Hermes Agent users instead. You install the plugin once, connect Reddit in the browser, and the 22 tools above work from chat. There is no SDK, no config file, and no API key handling. Choosing between them? Read the full [Composio alternatives](https://claw-link.dev/hub/composio-alternatives) comparison.

### Hermes paired but still can't use Reddit
Pairing is a two-step handshake: run `hermes clawlink begin`, approve the link in your browser, then run `hermes clawlink finish`. If you ran finish before approving, or the approval link expired, run `hermes clawlink begin` again to get a fresh link. Confirm the plugin was installed with `--enable`, then verify with `hermes clawlink test`.

### Connection succeeds but no tools appear
Reconnect Reddit from the dashboard, then start a fresh chat if the runtime still has the old tool catalog loaded.

### "Tool schema not loaded yet" error when calling Reddit tools
Reddit tool schemas load on demand the first time a tool runs and are cached after that, so this error usually clears on its own: wait a few seconds and retry the same request. If every Reddit call keeps failing with it in a fresh chat, reconnect from the dashboard, and contact support if it still persists — that pattern points to a configuration problem on our side, not something you can fix by reconnecting again.

### Reddit returns 403 or "permission denied" on one action while others work
Two usual causes. The connected account may not have access to the specific workspace, inbox, store, or project in the request — check that first. If access looks right, the agent may have sent a placeholder value (like "YOUR_ID" or an example id from documentation) instead of a real one: ask it to run a list or search tool first, then retry the action with a real id from those results. Most failures at this stage are one of these two, not ClawLink bugs.

### "arguments.thing_id is required" when commenting or editing
This is the most common failure on the Reddit integration in production, by a wide margin. thing_id is Reddit's fullname: a prefix plus the base-36 id, 't3_' for a post and 't1_' for a comment, for example t3_10omtdx. Agents skip it when they have never listed anything, or they pass a bare numeric id. The fix is list-first: reddit_get or reddit_retrieve_reddit_post returns the ids, and the fullname of the target goes into thing_id unchanged. A share-URL token from a reddit.com/r/.../s/... link is not a fullname and will not work in its place.

Ask the agent to diagnose it:

```text
Run reddit_get_r_top for a subreddit I name and show me the post ids and fullnames that come back. Then retry the comment with thing_id set to the fullname of the post I point to.
```

### Rate limited by Reddit: "Looks like you've been doing that a lot. Take a break for 4 minutes before trying again."
This is Reddit's own cooldown, returned as an HTTP 429, and the message names the exact wait, which can be anywhere from a couple of minutes up to about ten. The developer-app advice about a unique bot User-Agent and 100 requests per minute per client id does not apply here: the User-Agent belongs to the registered app the connection runs under, and the per-client quota is not something you can tune. What you control is the burst: an agent that fires many comments or posts in one prompt trips this faster than the same work spaced out. The fix is to wait out the cooldown the error names, or restructure the task so one call does the work. Reconnecting changes nothing.

Ask the agent to diagnose it:

```text
Report the exact wait the error message names and do not retry until that time has passed. If the task is a burst, tell me how many calls it involves before you start.
```

### Cannot post comment: "AI-generated or AI-polished content is not allowed. Please write it yourself."
Reddit enforces this rule on subreddits whose settings require it, and the rejection comes back as a plain comment failure with that exact message. It is a content judgment, not a connection fault, so no reconnect fixes it and no tool argument does either. The practical fix is the drafting step: have the agent write the comment in your voice, show it to you, and let you rephrase before it posts. The same rule class can remove a post silently after a successful API response, which is why visibility should be checked after a post rather than assumed.

Ask the agent to diagnose it:

```text
Draft the comment in plain language, show it to me, and do not call reddit_post_reddit_comment until I approve the wording.
```

### Cannot comment on archived content: "that's a piece of history now; it's too late to reply to it."
Reddit archives posts and comments automatically after six months, and archived content rejects new replies with this exact message. The agent should check the post's age before replying; anything older than six months will fail on the write regardless of the connection. If the goal is engagement, the fix is to target recent posts, which is what the hot and top sort orders are for.

Ask the agent to diagnose it:

```text
Before replying, tell me how old the post is. If it is six months or older, find a recent post on the same topic instead.
```

### Access to subreddit 'X' is forbidden. The subreddit may be private, quarantined, or banned.
This is the real shape behind the generic "Reddit returns 403 Forbidden" answers, which mostly teach User-Agent fixes that do not apply to a hosted connection. In production this error appears as a 403 on the subreddit level, and the cause is access, not headers: the subreddit is private, quarantined, or banned, or the connected account lacks a role in it. A related literal error, \{"message": "Forbidden", "error": 403\}, appears on calls whose account has no grant for the target. The fix is to confirm the subreddit actually exists and the account can view it in a browser. A separate spelling case produces "Subreddit 'contentmarketing' not found", which means the name is wrong, not that access is broken.

Ask the agent to diagnose it:

```text
Open the subreddit name I used and tell me whether it resolves in a browser and whether my account can see it. Do not retry the failing call until that is confirmed.
```

### OAuth finished in the browser but the account is still missing
Try reconnecting Reddit and complete the consent flow in the same browser session. Partial OAuth approvals or switching accounts mid-flow can leave the connection incomplete.

### Is there a Hermes Agent Reddit integration?
Yes. ClawLink is the fastest way to connect Hermes to Reddit: link your Reddit account once in the browser and Hermes Agent can call the Reddit API through 22 ready-made tools — no custom code or token handling.

### How do I connect Reddit to Hermes with ClawLink?
Install the plugin with `hermes plugins install ClawLink-HQ/hermes-plugin --enable`, then pair once: run `hermes clawlink begin`, approve the link in your browser, and run `hermes clawlink finish`. Connect Reddit in the dashboard and Hermes can use it from the next message — no config files or API keys to manage.

### How long does it take to connect Reddit to Hermes Agent?
About two minutes. Sign in, click Connect next to Reddit in the dashboard, authenticate, and Hermes Agent can use it from the next chat message.

### Why use ClawLink instead of wiring Reddit up myself?
The alternative to ClawLink is usually manual OAuth app setup plus your own token handling, permission troubleshooting, and tool plumbing for Hermes Agent. That is fine if you want to build and maintain the integration yourself. Most teams just want Reddit working from chat.

### Do I need a Reddit developer app to connect Reddit to Hermes Agent?
Not for this connection. The manual path the search engines teach is: create a script app on reddit.com/prefs/apps with a redirect like http://localhost:8080, copy the client id and secret, and wire them into n8n or a config file. ClawLink connects through an app that is already registered, so you sign in with your Reddit account and approve the grant, and nothing is pasted into a file. The distinction matters for what the agent can do: the connection's scopes are identity, read, vote, submit, flair, and edit, which covers posting, commenting, and reading public data, but not your inbox or private messages.

### What does "without an API key" mean for Reddit, exactly?
Two different claims hide in that phrase. One reading, which an AI Overview answered for this query, is "without LLM API keys", pointing at local models like Ollama and LM Studio plus scraping. That is a different problem and not what this page solves. The other reading is "without Reddit app credentials", and that is this page: no developer app, no client id, no secret, no config.yaml. Both can be true at once: you can run a local model and still give it Reddit through this hosted connection.

### Is it safe to connect Reddit to an AI agent?
The connection runs under Reddit's OAuth, so the mechanics are the same as any app you approve at reddit.com/prefs/apps: the grant is scoped (identity, read, vote, submit, flair, edit), it does not expose your password, and you can revoke it from Reddit's own settings without involving us. The agent's reach is the 22 tools on this page, and the write ones are named, including reddit_post_reddit_comment and reddit_create_reddit_post. What Reddit itself enforces is content policy rather than connection policy: subreddit rules can reject posts and comments, including ones that read as AI-generated, so a drafting-and-approval step keeps the agent out of trouble.

### Can the agent post and comment on Reddit for me?
Yes, through reddit_create_reddit_post and reddit_post_reddit_comment, both of which are plain write tools. Two production realities change how you should use them. Reddit blocks comments its systems classify as AI-generated or AI-polished in subreddits that enforce that rule, and posts can be silently removed by automod after a successful API response. Both fail after the fact rather than at the call, so the practical pattern is: draft, show the user, approve, then post, and verify visibility afterwards.

### What can the Hermes Agent Reddit integration actually do?
        Read public content: hot, new, and top listings through reddit_get and reddit_get_r_top, subreddit search, post comments and specific comments, user profiles, and subreddit rules. Write as you: create posts with optional flair, post comments, edit your own posts and comments, and delete them. The set stops at your inbox: there is no history or privatemessages scope, so the agent cannot read or reply to DMs. There is also no vote tool, even though the connection holds the vote scope, so the agent cannot upvote or downvote for you.

### Hermes paired but still can't use Reddit
Pairing is a two-step handshake: run `hermes clawlink begin`, approve the link in your browser, then run `hermes clawlink finish`. If you ran finish before approving, or the approval link expired, run `hermes clawlink begin` again to get a fresh link. Confirm the plugin was installed with `--enable`, then verify with `hermes clawlink test`.

## Related

- [Hermes Stack Exchange integration](https://claw-link.dev/hermes/stack-exchange) — Search and browse questions, answers, and developer knowledge
- [Giphy tools](https://claw-link.dev/hermes/giphy) — Search GIFs, stickers, and emojis from the GIPHY library
- [Linkhut](https://claw-link.dev/hermes/linkhut) — Save, organize, and share bookmarks and links