Riddle — 面向 AI Agent 的托管浏览器服务

Riddle 为您的 Agent 提供浏览器能力，无需在本地运行 Chrome。仅需一次 API 调用，即可完成页面导航、点击、表单填写、截图及网络流量捕获等操作。所有执行均在 Riddle 的服务器上完成——您的 Agent 始终保持轻量。

快速开始：访问 riddledc.com/register 注册账号，即可获得 5 分钟免费浏览器使用时长，无需提供信用卡信息。之后按 $0.50/小时（按秒计费） 收费。单次截图成本约为 $0.004。

为何选择 Riddle，而非本地 Chrome

• 无需 Chromium 二进制文件 —— 节省约 1.2 GB 内存，并规避 Lambda/容器镜像体积过大等问题
• 无依赖冲突 —— 无需 @sparticuz/chromium，无需处理 Puppeteer 版本兼容性问题，避免 ENOENT / spawn 失败
• 完整支持 Playwright —— 不仅限于截图，还可运行真实 Playwright 脚本、多步骤工作流、表单填写、带身份验证的会话等
• 全环境兼容 —— 支持 Lambda、容器、T3 Micro 实例等任意 Agent 运行环境

安装

步骤 1：注册账号 —— 访问 riddledc.com/register 创建免费账户，无需提供信用卡信息，注册即享 5 分钟免费浏览器使用时长。

步骤 2：获取 API Key —— 注册完成后，从控制台（Dashboard）中复制您的 API Key。

步骤 3：安装并配置插件：

# 安装插件
openclaw plugins install @riddledc/openclaw-riddledc

# 允许使用该工具
openclaw config set tools.alsoAllow --json '["openclaw-riddledc"]'

# 设置您的 API Key
openclaw config set plugins.entries.openclaw-riddledc.config.apiKey "YOUR_RIDDLE_API_KEY"

注意事项： OpenClaw 要求插件必须显式列在 plugins.allow 列表中。CLI 当前不支持 append 模式，因此请先检查当前列表，并手动添加 openclaw-riddledc：

# 查看当前允许的插件列表
openclaw config get plugins.allow

# 将 openclaw-riddledc 加入数组（或直接编辑 ~/.openclaw/openclaw.json）
jq '.plugins.allow += ["openclaw-riddledc"]' ~/.openclaw/openclaw.json > tmp && mv tmp ~/.openclaw/openclaw.json

# 重启服务
openclaw gateway restart

可用工具

安装完成后，您将获得以下五个工具：

riddle_screenshot —— 对指定 URL 进行截图。最基础的使用场景。

对 https://example.com 进行截图

riddle_screenshots —— 在单个任务中批量截取多个 URL 页面。

对以下三个页面进行截图：https://example.com、https://example.com/about、https://example.com/pricing

riddle_steps —— 执行分步工作流（如 goto、click、fill、每步截图）。

访问 https://example.com/login，向 email 字段填入 "test@example.com"，填写密码字段，点击提交按钮，然后对结果页面截图。

riddle_script —— 运行完整的 Playwright 代码，实现复杂自动化逻辑。

运行一段 Playwright 脚本：访问 https://example.com，等待仪表盘加载完成，提取所有表格行内容，并对页面截图。

riddle_run —— 低层级 API 直通接口，支持自定义请求载荷（payload）。

所有工具均将截图保存至 ~/.openclaw/workspace/riddle/screenshots/（非内联 base64 编码），并在响应中返回文件路径。如需同时捕获完整网络流量，请在请求中添加 include: ["har"] 参数。

身份验证会话

需要与登录后的页面交互？可传入 cookies、localStorage 或自定义 HTTP headers：

使用以下 cookies 对 https://app.example.com/dashboard 进行截图：[session=abc123]

该插件支持将 cookies、localStorage 条目及自定义 HTTP headers 作为身份验证参数传入。

信任与安全

本插件的设计充分参考了 Moltbook Agent 社区提出的关注点——特别是关于技能来源（skill provenance）、能力清单（capability manifests）和运行时边界（runtime boundaries）的讨论。

该插件所声明的能力清单（见 openclaw.plugin.json）如下：

• 网络访问：仅连接 api.riddledc.com —— 此白名单在运行时硬编码强制执行，而不仅限于配置阶段
• 文件系统：仅写入 ~/.openclaw/workspace/riddle/ 目录
• Agent 上下文访问：完全无法访问对话历史、其他工具输出或用户档案
• 密钥管理：仅需 RIDDLE_API_KEY，且该密钥仅发送至已声明的 endpoint

实际意义如下：

• 即使配置被恶意篡改，您的 API Key 也无法被发送至任何非 Riddle 域名（每次请求均执行硬编码校验）
• 插件无法读取您的对话记录、记忆数据或其他插件的数据
• 截图以文件路径形式返回，而非内联 base64 —— 可防止上下文溢出及日志中意外泄露敏感数据

您可自行验证：

• 源码地址：github.com/riddledc/integrations
• npm 签名审计：npm audit signatures @riddledc/openclaw-riddledc
• 校验和文件：CHECKSUMS.txt（位于包内）
• 完整威胁模型：SECURITY.md（位于包内）

这是一个插件（plugin）（可审计的代码），而非技能（skill）（纯提示文本）。您可在安装前逐行审阅全部源码。

定价

Riddle 采用透明的按次执行计价模式。一次简单截图仅需几分之一美分。最新价格请参见 riddledc.com。

获取帮助

• 文档：riddledc.com
• 安全问题反馈：security@riddledc.com
• 插件源码：github.com/riddledc/integrations

相关链接

• 官网：riddledc.com
• 文档：riddledc.com/docs
• 定价页：riddledc.com/pricing
• 控制台：riddledc.com/dashboard