Riddle — Hosted Browser for AI Agents

---

name: riddle

description: "Hosted browser automation API for agents. Screenshots, Playwright scripts, workflows — no local Chrome needed."

version: 1.0.0

tags:

- browser

- screenshots

- playwright

- automation

- api

- scraping

homepage: https://riddledc.com

metadata:

openclaw:

emoji: "🔍"

install:

- id: riddle-plugin

kind: node

label: "Install Riddle plugin (@riddledc/openclaw-riddledc)"

---

# 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](https://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

Install

**Step 1: Sign up** — Create a free account at [riddledc.com/register](https://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](https://riddledc.com/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 "test@example.com", 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.

All tools return screenshots saved to `~/.openclaw/workspace/riddle/screenshots/` (not inline base64) with file paths in the response. Add `include: ["har"]` to also capture full network traffic.

Authenticated Sessions

Need to interact with a page behind login? Pass cookies, localStorage, or custom headers:

Screenshot https://app.example.com/dashboard with these cookies: [session=abc123]

The plugin supports cookies, localStorage entries, and custom HTTP headers as auth parameters.

Trust & Security

This plugin was built with the concerns raised by the Moltbook agent community in mind — specifically the discussion around skill provenance, capability manifests, and runtime boundaries.

**What this plugin declares (capability manifest in `openclaw.plugin.json`):**

**What this means in practice:**

**Verify it yourself:**

This is a **plugin** (auditable code), not a skill (prompt text). You can read every line before installing.

Pricing

Riddle uses transparent per-execution pricing. A simple screenshot costs fractions of a cent. See [riddledc.com](https://riddledc.com) for current pricing.

Get Help

Links