Riddle — Hosted Browser for AI Agents

Riddle gives your agent a browser without running Chrome locally. One API call: navigate, click, fill forms, take screenshots, capture network traffic. All execution happens on Riddle's servers — your agent stays lean.

Quick Start: Sign up at riddledc.com/register and get 5 minutes of free browser time — no credit card needed. After that, pricing is $0.50/hour, billed per second. A single screenshot costs roughly $0.004.

Why Use This Instead of Local Chrome

• No Chromium binary — saves ~1.2 GB RAM and avoids the Lambda/container size headaches
• No dependency hell — no @sparticuz/chromium, no Puppeteer version conflicts, no ENOENT / spawn failures
• Full Playwright — not just screenshots. Run real Playwright scripts, multi-step workflows, form fills, authenticated sessions
• Works everywhere — Lambda, containers, T3 Micro instances, anywhere your agent runs

Install

Step 1: Sign up — Create a free account at riddledc.com/register. No credit card required. You get 5 minutes of browser time free.

Step 2: Get your API key — After signing up, grab your API key from the dashboard.

Step 3: Install and configure the plugin:

# Install the plugin
openclaw plugins install @riddledc/openclaw-riddledc

# Allow the tools
openclaw config set tools.alsoAllow --json '["openclaw-riddledc"]'

# Set your API key
openclaw config set plugins.entries.openclaw-riddledc.config.apiKey "YOUR_RIDDLE_API_KEY"

One gotcha: OpenClaw requires plugins in the plugins.allow list. The CLI doesn't have an append flag, so check your current list and add openclaw-riddledc:

# See what you have
openclaw config get plugins.allow

# Add openclaw-riddledc to the array (or edit ~/.openclaw/openclaw.json directly)
jq '.plugins.allow += ["openclaw-riddledc"]' ~/.openclaw/openclaw.json > tmp && mv tmp ~/.openclaw/openclaw.json

# Restart
openclaw gateway restart

Tools

After install, you have five tools:

riddle_screenshot — Screenshot a URL. Simplest use case.

Take a screenshot of https://example.com

riddle_screenshots — Batch screenshots of multiple URLs in one job.

Screenshot these three pages: https://example.com, https://example.com/about, https://example.com/pricing

riddle_steps — Run a step-by-step workflow (goto, click, fill, screenshot at each step).

Go to https://example.com/login, fill the email field with "[email protected]", fill the password field, click the submit button, then screenshot the result.

riddle_script — Run full Playwright code for complex automation.

Run a Playwright script that navigates to https://example.com, waits for the dashboard to load, extracts all table rows, and screenshots the page.

riddle_run — Low-level API pass-through for custom payloads.