riddle

What This Skill Does

Riddle is a specialized hosted browser automation service integrated into OpenClaw, allowing your AI agent to interact with the web without the resource overhead of local Chromium binaries. By offloading browser execution to Riddle's cloud infrastructure, your agents remain lean and efficient. The skill provides full Playwright support, enabling complex workflows, authenticated sessions, form submissions, and high-fidelity screenshots, all managed via a single API connection. It effectively eliminates common 'dependency hell' issues and hardware resource constraints typically associated with running headless browsers in memory-constrained environments like Lambda or T3 micro-instances.

Installation

To integrate Riddle into your agent, follow these steps:

1. Register for an account at riddledc.com/register.
2. Obtain your API key from the dashboard.
3. Install the plugin: openclaw plugins install @riddledc/openclaw-riddledc.
4. Enable the tool: openclaw config set tools.alsoAllow --json '["openclaw-riddledc"]'.
5. Configure your credentials: openclaw config set plugins.entries.openclaw-riddledc.config.apiKey "YOUR_RIDDLE_API_KEY".
6. Add the plugin to your plugins.allow list in your configuration file, then restart the gateway: openclaw gateway restart.

Use Cases

Riddle is ideal for agents performing automated research, competitive analysis, or web-based task orchestration. Use it for screenshotting UI changes, testing forms, performing multi-step account logins, or scraping structured data from websites that require JavaScript execution to render. It is particularly useful when deploying your agent to environments where installing a full browser stack is not possible or cost-prohibitive.

Example Prompts

1. 'Take a screenshot of the main page and the pricing page for https://stripe.com and save them to my local workspace.'
2. 'Go to https://google.com, search for "OpenClaw documentation", click on the first organic result, and take a screenshot of the landing page.'
3. 'Run a script to log into my dashboard at https://app.example.com using the provided credentials, wait for the table to load, and extract all invoice rows.'

Tips & Limitations

• Pricing: Usage is billed per second, making it very cost-effective. Ensure your scripts are optimized to avoid long idle times.
• Performance: Since this is a network-based service, avoid excessive page refreshes or heavy polling in your logic.
• Authentication: Store sensitive credentials in your environment variables rather than hardcoding them into scripts passed to the riddle_script tool.
• Scope: This skill provides full Playwright control, so ensure you handle navigation errors and timeouts within your automation logic to maintain agent stability.