openclaw-reddit-agent-server 2026.2.15

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+interface PluginLogger {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+}
+interface PluginApi {
+    pluginConfig: Record<string, unknown> | undefined;
+    logger: PluginLogger;
+    registerTool: (config: unknown) => void;
+    registerService: (config: {
+        id: string;
+        start: () => void | Promise<void>;
+        stop: () => void | Promise<void>;
+    }) => void;
+}
+declare const redditAgentPlugin: {
+    id: string;
+    name: string;
+    description: string;
+    register(api: PluginApi): void;
+};
+
+export { redditAgentPlugin as default };

package/dist/index.js

@@ -0,0 +1,267 @@
+// src/ws-bridge.ts
+import { WebSocketServer, WebSocket } from "ws";
+import { randomUUID } from "crypto";
+var REQUEST_TIMEOUT_MS = 6e4;
+var WebSocketBridge = class {
+  wss = null;
+  extensionSocket = null;
+  pendingRequests = /* @__PURE__ */ new Map();
+  port;
+  logger;
+  constructor(port, logger) {
+    this.port = port;
+    this.logger = logger ?? {
+      info: (msg) => console.log(`[reddit-agent] ${msg}`),
+      warn: (msg) => console.warn(`[reddit-agent] ${msg}`),
+      error: (msg) => console.error(`[reddit-agent] ${msg}`)
+    };
+  }
+  get isExtensionConnected() {
+    return this.extensionSocket !== null && this.extensionSocket.readyState === WebSocket.OPEN;
+  }
+  start() {
+    if (this.wss) return;
+    this.wss = new WebSocketServer({ port: this.port, path: "/ws" });
+    this.logger.info(
+      `WebSocket bridge listening on ws://localhost:${this.port}/ws`
+    );
+    this.wss.on("connection", (socket) => {
+      this.logger.info("New WebSocket connection");
+      socket.on("message", (raw) => {
+        let message;
+        try {
+          message = JSON.parse(
+            typeof raw === "string" ? raw : raw.toString("utf8")
+          );
+        } catch {
+          this.logger.warn("Failed to parse incoming WebSocket message");
+          return;
+        }
+        if ("type" in message && message.type === "identify") {
+          this.logger.info(
+            `Extension identified (role: ${message.role})`
+          );
+          this.extensionSocket = socket;
+          return;
+        }
+        if ("type" in message && message.type === "ping") {
+          socket.send(JSON.stringify({ type: "pong" }));
+          return;
+        }
+        if ("id" in message && "success" in message) {
+          const response = message;
+          const pending = this.pendingRequests.get(response.id);
+          if (!pending) {
+            this.logger.warn(
+              `Received response for unknown request id: ${response.id}`
+            );
+            return;
+          }
+          this.pendingRequests.delete(response.id);
+          clearTimeout(pending.timer);
+          if (response.success) {
+            pending.resolve(response.data);
+          } else {
+            pending.reject(new Error(response.error));
+          }
+        }
+      });
+      socket.on("close", () => {
+        if (socket === this.extensionSocket) {
+          this.logger.info("Extension disconnected");
+          this.extensionSocket = null;
+        }
+      });
+      socket.on("error", (err) => {
+        this.logger.error(`WebSocket error: ${err.message}`);
+      });
+    });
+  }
+  stop() {
+    for (const [id, pending] of this.pendingRequests) {
+      clearTimeout(pending.timer);
+      pending.reject(new Error("WebSocket bridge shutting down"));
+      this.pendingRequests.delete(id);
+    }
+    if (this.extensionSocket) {
+      this.extensionSocket.close();
+      this.extensionSocket = null;
+    }
+    if (this.wss) {
+      this.wss.close();
+      this.wss = null;
+    }
+    this.logger.info("WebSocket bridge stopped");
+  }
+  /**
+   * Send an action to the connected Chrome extension and wait for a response.
+   * Returns the `data` field from the success response.
+   */
+  sendAction(action, params, timeoutMs = REQUEST_TIMEOUT_MS) {
+    if (!this.isExtensionConnected) {
+      return Promise.reject(
+        new Error(
+          `Reddit Agent Chrome extension is not connected. Please ensure the extension is installed, the server URL is configured to ws://localhost:${this.port}/ws in the extension popup, and the browser is running.`
+        )
+      );
+    }
+    const id = randomUUID();
+    const request = { id, action, params };
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pendingRequests.delete(id);
+        reject(
+          new Error(
+            `Request timed out after ${timeoutMs}ms for action: ${action}`
+          )
+        );
+      }, timeoutMs);
+      this.pendingRequests.set(id, { resolve, reject, timer });
+      this.extensionSocket.send(JSON.stringify(request));
+    });
+  }
+};
+
+// src/tools.ts
+import { Type } from "@sinclair/typebox";
+var REPLY_TIMEOUT_MS = 9e4;
+function registerRedditTools(registerTool, bridge) {
+  registerTool({
+    name: "reddit_fetch_subreddit",
+    description: "Fetch a subreddit's listing from Reddit. Accepts subreddit name, r/name, or full URL. Optionally specify sort order (hot, new, top, rising, best).",
+    parameters: Type.Object({
+      subreddit: Type.String({
+        description: 'Subreddit name or URL. Accepts: "supplements", "r/supplements", "/r/supplements", or "https://www.reddit.com/r/supplements".'
+      }),
+      sort: Type.Optional(
+        Type.Unsafe({
+          type: "string",
+          enum: ["hot", "new", "top", "rising", "best"],
+          description: "Sort order. Default: hot."
+        })
+      )
+    }),
+    async execute(_id, params) {
+      const data = await bridge.sendAction("fetch_subreddit", {
+        subreddit: params.subreddit,
+        sort: params.sort
+      });
+      return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+      };
+    }
+  });
+  registerTool({
+    name: "reddit_search",
+    description: "Search Reddit for posts matching a query. Optionally scope to a specific subreddit. Supports sort (relevance, top, new, comments) and time filters (hour, day, week, month, year).",
+    parameters: Type.Object({
+      query: Type.String({ description: "Search query string." }),
+      subreddit: Type.Optional(
+        Type.String({
+          description: 'Subreddit to search within. Omit to search all of Reddit. Accepts same formats as reddit_fetch_subreddit (e.g. "supplements").'
+        })
+      ),
+      sort: Type.Optional(
+        Type.Unsafe({
+          type: "string",
+          enum: ["relevance", "top", "new", "comments"],
+          description: "Sort order for results. Default: relevance."
+        })
+      ),
+      time: Type.Optional(
+        Type.Unsafe({
+          type: "string",
+          enum: ["hour", "day", "week", "month", "year"],
+          description: "Time filter. Default: all time."
+        })
+      )
+    }),
+    async execute(_id, params) {
+      const data = await bridge.sendAction("search_reddit", {
+        query: params.query,
+        subreddit: params.subreddit,
+        sort: params.sort,
+        time: params.time
+      });
+      return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+      };
+    }
+  });
+  registerTool({
+    name: "reddit_fetch_post",
+    description: "Fetch a single Reddit post and its full comment tree. Provide the full post URL.",
+    parameters: Type.Object({
+      url: Type.String({
+        description: "Full Reddit post URL (e.g. https://www.reddit.com/r/supplements/comments/abc123/some_post/)."
+      })
+    }),
+    async execute(_id, params) {
+      const data = await bridge.sendAction("fetch_post", {
+        url: params.url
+      });
+      return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+      };
+    }
+  });
+  registerTool({
+    name: "reddit_reply",
+    description: "Reply to a Reddit comment or post using the user's logged-in session in Chrome. Requires the Reddit Agent Chrome extension to be connected and the user to be logged into Reddit. Takes ~7-10 seconds due to DOM interaction.",
+    parameters: Type.Object({
+      commentUrl: Type.String({
+        description: "Direct URL to the comment or post to reply to."
+      }),
+      replyText: Type.String({
+        description: "The reply text to post."
+      })
+    }),
+    async execute(_id, params) {
+      const data = await bridge.sendAction(
+        "reply_to_comment",
+        {
+          commentUrl: params.commentUrl,
+          replyText: params.replyText
+        },
+        REPLY_TIMEOUT_MS
+      );
+      return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+      };
+    }
+  });
+}
+
+// index.ts
+var DEFAULT_PORT = 7071;
+var redditAgentPlugin = {
+  id: "reddit-agent",
+  name: "Reddit Agent",
+  description: "Bridge to Reddit Chrome extension for browsing, searching, and commenting.",
+  register(api) {
+    const port = typeof api.pluginConfig?.port === "number" ? api.pluginConfig.port : DEFAULT_PORT;
+    const bridge = new WebSocketBridge(port, {
+      info: (msg) => api.logger.info(msg),
+      warn: (msg) => api.logger.warn(msg),
+      error: (msg) => api.logger.error(msg)
+    });
+    api.registerService({
+      id: "reddit-agent-bridge",
+      start: () => {
+        bridge.start();
+      },
+      stop: () => {
+        bridge.stop();
+      }
+    });
+    registerRedditTools(
+      (config) => api.registerTool(config),
+      bridge
+    );
+  }
+};
+var index_default = redditAgentPlugin;
+export {
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ws-bridge.ts","../src/tools.ts","../index.ts"],"sourcesContent":["import { WebSocketServer, WebSocket } from \"ws\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  BridgeRequest,\n  BridgeResponse,\n  ExtensionMessage,\n  PendingRequest,\n} from \"./types.js\";\n\nconst REQUEST_TIMEOUT_MS = 60_000;\n\nexport interface BridgeLogger {\n  info: (msg: string) => void;\n  warn: (msg: string) => void;\n  error: (msg: string) => void;\n}\n\nexport class WebSocketBridge {\n  private wss: WebSocketServer | null = null;\n  private extensionSocket: WebSocket | null = null;\n  private pendingRequests = new Map<string, PendingRequest>();\n  private port: number;\n  private logger: BridgeLogger;\n\n  constructor(port: number, logger?: BridgeLogger) {\n    this.port = port;\n    this.logger = logger ?? {\n      info: (msg: string) => console.log(`[reddit-agent] ${msg}`),\n      warn: (msg: string) => console.warn(`[reddit-agent] ${msg}`),\n      error: (msg: string) => console.error(`[reddit-agent] ${msg}`),\n    };\n  }\n\n  get isExtensionConnected(): boolean {\n    return (\n      this.extensionSocket !== null &&\n      this.extensionSocket.readyState === WebSocket.OPEN\n    );\n  }\n\n  start(): void {\n    if (this.wss) return;\n\n    this.wss = new WebSocketServer({ port: this.port, path: \"/ws\" });\n    this.logger.info(\n      `WebSocket bridge listening on ws://localhost:${this.port}/ws`\n    );\n\n    this.wss.on(\"connection\", (socket) => {\n      this.logger.info(\"New WebSocket connection\");\n\n      socket.on(\"message\", (raw) => {\n        let message: ExtensionMessage;\n        try {\n          message = JSON.parse(\n            typeof raw === \"string\" ? raw : raw.toString(\"utf8\")\n          );\n        } catch {\n          this.logger.warn(\"Failed to parse incoming WebSocket message\");\n          return;\n        }\n\n        // Handle identify\n        if (\"type\" in message && message.type === \"identify\") {\n          this.logger.info(\n            `Extension identified (role: ${(message as { role: string }).role})`\n          );\n          this.extensionSocket = socket;\n          return;\n        }\n\n        // Handle ping/pong keepalive\n        if (\"type\" in message && message.type === \"ping\") {\n          socket.send(JSON.stringify({ type: \"pong\" }));\n          return;\n        }\n\n        // Handle response to a pending request\n        if (\"id\" in message && \"success\" in message) {\n          const response = message as BridgeResponse;\n          const pending = this.pendingRequests.get(response.id);\n          if (!pending) {\n            this.logger.warn(\n              `Received response for unknown request id: ${response.id}`\n            );\n            return;\n          }\n          this.pendingRequests.delete(response.id);\n          clearTimeout(pending.timer);\n\n          if (response.success) {\n            pending.resolve(response.data);\n          } else {\n            pending.reject(new Error(response.error));\n          }\n        }\n      });\n\n      socket.on(\"close\", () => {\n        if (socket === this.extensionSocket) {\n          this.logger.info(\"Extension disconnected\");\n          this.extensionSocket = null;\n        }\n      });\n\n      socket.on(\"error\", (err) => {\n        this.logger.error(`WebSocket error: ${err.message}`);\n      });\n    });\n  }\n\n  stop(): void {\n    // Reject all pending requests\n    for (const [id, pending] of this.pendingRequests) {\n      clearTimeout(pending.timer);\n      pending.reject(new Error(\"WebSocket bridge shutting down\"));\n      this.pendingRequests.delete(id);\n    }\n\n    if (this.extensionSocket) {\n      this.extensionSocket.close();\n      this.extensionSocket = null;\n    }\n\n    if (this.wss) {\n      this.wss.close();\n      this.wss = null;\n    }\n\n    this.logger.info(\"WebSocket bridge stopped\");\n  }\n\n  /**\n   * Send an action to the connected Chrome extension and wait for a response.\n   * Returns the `data` field from the success response.\n   */\n  sendAction(\n    action: string,\n    params: Record<string, unknown>,\n    timeoutMs = REQUEST_TIMEOUT_MS\n  ): Promise<unknown> {\n    if (!this.isExtensionConnected) {\n      return Promise.reject(\n        new Error(\n          \"Reddit Agent Chrome extension is not connected. \" +\n            \"Please ensure the extension is installed, the server URL is configured \" +\n            `to ws://localhost:${this.port}/ws in the extension popup, and the browser is running.`\n        )\n      );\n    }\n\n    const id = randomUUID();\n    const request: BridgeRequest = { id, action, params };\n\n    return new Promise<unknown>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.pendingRequests.delete(id);\n        reject(\n          new Error(\n            `Request timed out after ${timeoutMs}ms for action: ${action}`\n          )\n        );\n      }, timeoutMs);\n\n      this.pendingRequests.set(id, { resolve, reject, timer });\n      this.extensionSocket!.send(JSON.stringify(request));\n    });\n  }\n}\n","import { Type } from \"@sinclair/typebox\";\nimport type { WebSocketBridge } from \"./ws-bridge.js\";\n\nconst REPLY_TIMEOUT_MS = 90_000;\n\ninterface ToolConfig {\n  name: string;\n  description: string;\n  parameters: unknown;\n  execute: (\n    id: string,\n    params: Record<string, unknown>\n  ) => Promise<{ content: { type: \"text\"; text: string }[] }>;\n}\n\nexport function registerRedditTools(\n  registerTool: (config: ToolConfig) => void,\n  bridge: WebSocketBridge\n) {\n  registerTool({\n    name: \"reddit_fetch_subreddit\",\n    description:\n      \"Fetch a subreddit's listing from Reddit. Accepts subreddit name, r/name, \" +\n      \"or full URL. Optionally specify sort order (hot, new, top, rising, best).\",\n    parameters: Type.Object({\n      subreddit: Type.String({\n        description:\n          'Subreddit name or URL. Accepts: \"supplements\", \"r/supplements\", ' +\n          '\"/r/supplements\", or \"https://www.reddit.com/r/supplements\".',\n      }),\n      sort: Type.Optional(\n        Type.Unsafe<\"hot\" | \"new\" | \"top\" | \"rising\" | \"best\">({\n          type: \"string\",\n          enum: [\"hot\", \"new\", \"top\", \"rising\", \"best\"],\n          description: \"Sort order. Default: hot.\",\n        })\n      ),\n    }),\n    async execute(_id: string, params: Record<string, unknown>) {\n      const data = await bridge.sendAction(\"fetch_subreddit\", {\n        subreddit: params.subreddit,\n        sort: params.sort,\n      });\n      return {\n        content: [{ type: \"text\" as const, text: JSON.stringify(data, null, 2) }],\n      };\n    },\n  });\n\n  registerTool({\n    name: \"reddit_search\",\n    description:\n      \"Search Reddit for posts matching a query. Optionally scope to a specific \" +\n      \"subreddit. Supports sort (relevance, top, new, comments) and time \" +\n      \"filters (hour, day, week, month, year).\",\n    parameters: Type.Object({\n      query: Type.String({ description: \"Search query string.\" }),\n      subreddit: Type.Optional(\n        Type.String({\n          description:\n            \"Subreddit to search within. Omit to search all of Reddit. \" +\n            'Accepts same formats as reddit_fetch_subreddit (e.g. \"supplements\").',\n        })\n      ),\n      sort: Type.Optional(\n        Type.Unsafe<\"relevance\" | \"top\" | \"new\" | \"comments\">({\n          type: \"string\",\n          enum: [\"relevance\", \"top\", \"new\", \"comments\"],\n          description: \"Sort order for results. Default: relevance.\",\n        })\n      ),\n      time: Type.Optional(\n        Type.Unsafe<\"hour\" | \"day\" | \"week\" | \"month\" | \"year\">({\n          type: \"string\",\n          enum: [\"hour\", \"day\", \"week\", \"month\", \"year\"],\n          description: \"Time filter. Default: all time.\",\n        })\n      ),\n    }),\n    async execute(_id: string, params: Record<string, unknown>) {\n      const data = await bridge.sendAction(\"search_reddit\", {\n        query: params.query,\n        subreddit: params.subreddit,\n        sort: params.sort,\n        time: params.time,\n      });\n      return {\n        content: [{ type: \"text\" as const, text: JSON.stringify(data, null, 2) }],\n      };\n    },\n  });\n\n  registerTool({\n    name: \"reddit_fetch_post\",\n    description:\n      \"Fetch a single Reddit post and its full comment tree. Provide the full post URL.\",\n    parameters: Type.Object({\n      url: Type.String({\n        description:\n          \"Full Reddit post URL (e.g. https://www.reddit.com/r/supplements/comments/abc123/some_post/).\",\n      }),\n    }),\n    async execute(_id: string, params: Record<string, unknown>) {\n      const data = await bridge.sendAction(\"fetch_post\", {\n        url: params.url,\n      });\n      return {\n        content: [{ type: \"text\" as const, text: JSON.stringify(data, null, 2) }],\n      };\n    },\n  });\n\n  registerTool({\n    name: \"reddit_reply\",\n    description:\n      \"Reply to a Reddit comment or post using the user's logged-in session in Chrome. \" +\n      \"Requires the Reddit Agent Chrome extension to be connected and the user to be \" +\n      \"logged into Reddit. Takes ~7-10 seconds due to DOM interaction.\",\n    parameters: Type.Object({\n      commentUrl: Type.String({\n        description: \"Direct URL to the comment or post to reply to.\",\n      }),\n      replyText: Type.String({\n        description: \"The reply text to post.\",\n      }),\n    }),\n    async execute(_id: string, params: Record<string, unknown>) {\n      const data = await bridge.sendAction(\n        \"reply_to_comment\",\n        {\n          commentUrl: params.commentUrl,\n          replyText: params.replyText,\n        },\n        REPLY_TIMEOUT_MS\n      );\n      return {\n        content: [{ type: \"text\" as const, text: JSON.stringify(data, null, 2) }],\n      };\n    },\n  });\n}\n","import { WebSocketBridge } from \"./src/ws-bridge.js\";\nimport { registerRedditTools } from \"./src/tools.js\";\n\nconst DEFAULT_PORT = 7071;\n\ninterface PluginLogger {\n  info: (msg: string) => void;\n  warn: (msg: string) => void;\n  error: (msg: string) => void;\n}\n\ninterface PluginApi {\n  pluginConfig: Record<string, unknown> | undefined;\n  logger: PluginLogger;\n  registerTool: (config: unknown) => void;\n  registerService: (config: {\n    id: string;\n    start: () => void | Promise<void>;\n    stop: () => void | Promise<void>;\n  }) => void;\n}\n\nconst redditAgentPlugin = {\n  id: \"reddit-agent\",\n  name: \"Reddit Agent\",\n  description:\n    \"Bridge to Reddit Chrome extension for browsing, searching, and commenting.\",\n\n  register(api: PluginApi) {\n    const port =\n      typeof api.pluginConfig?.port === \"number\"\n        ? api.pluginConfig.port\n        : DEFAULT_PORT;\n\n    const bridge = new WebSocketBridge(port, {\n      info: (msg) => api.logger.info(msg),\n      warn: (msg) => api.logger.warn(msg),\n      error: (msg) => api.logger.error(msg),\n    });\n\n    api.registerService({\n      id: \"reddit-agent-bridge\",\n      start: () => {\n        bridge.start();\n      },\n      stop: () => {\n        bridge.stop();\n      },\n    });\n\n    registerRedditTools(\n      (config) => api.registerTool(config),\n      bridge\n    );\n  },\n};\n\nexport default redditAgentPlugin;\n"],"mappings":"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","names":[]}

package/openclaw.plugin.json

@@ -0,0 +1,25 @@
+{
+  "id": "reddit-agent",
+  "name": "Reddit Agent",
+  "description": "Bridge to Reddit Chrome extension for browsing, searching, and commenting on Reddit.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "port": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 65535,
+        "default": 7071
+      }
+    }
+  },
+  "uiHints": {
+    "port": {
+      "label": "WebSocket Port",
+      "placeholder": "7071",
+      "help": "Port for the WebSocket bridge server. The Chrome extension connects here."
+    }
+  },
+  "skills": ["skills/reddit-agent"]
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "openclaw-reddit-agent-server",
+  "version": "2026.2.15",
+  "description": "OpenClaw plugin for Reddit automation via Chrome extension bridge",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "skills",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0",
+    "ws": "^8.19.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.0",
+    "tsup": "^8.0.0",
+    "typescript": "~5.8.0"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "reddit",
+    "automation"
+  ],
+  "license": "MIT"
+}

package/skills/reddit-agent/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: reddit-agent
+description: Browse, search, and interact with Reddit via the Chrome extension bridge.
+user-invocable: false
+---
+
+# Reddit Agent
+
+You have access to Reddit tools via the Reddit Agent plugin. These tools communicate with a Chrome extension that executes actions in a real browser session.
+
+## Available Tools
+
+### reddit_fetch_subreddit
+Fetch a subreddit listing. Provide a subreddit name (e.g., "supplements", "r/supplements", or a full URL) and optional sort order (hot, new, top, rising, best).
+
+### reddit_search
+Search Reddit for posts. Provide a query string and optionally scope to a subreddit. Supports sort (relevance, top, new, comments) and time filters (hour, day, week, month, year).
+
+### reddit_fetch_post
+Fetch a single post and its comment tree. Provide the full Reddit post URL.
+
+### reddit_reply
+Reply to a comment or post. Requires the user to be logged into Reddit in Chrome. Provide the comment URL and reply text. This action takes ~7-10 seconds.
+
+## Important Notes
+
+- The Reddit Agent Chrome extension must be installed and connected
+- The extension connects to the bridge server automatically at `ws://localhost:7071/ws`
+- Reply actions require an active Reddit login session in Chrome
+- Reddit rate limits apply — avoid rapid-fire requests
+- If tools return a "not connected" error, check that Chrome is running and the extension is enabled