名称： riddle
描述： "为智能体提供的托管浏览器自动化 API。支持截图、Playwright 脚本、工作流——无需本地 Chrome。"
版本： 1.0.0
标签：
- 浏览器
- 截图
- playwright
- 自动化
- api
- 数据抓取
主页： https://riddledc.com
元数据：
openclaw:
emoji: "🔍"
install:
- id: riddle-plugin
kind: node
label: "安装 Riddle 插件 (@riddledc/openclaw-riddledc)"

Riddle — 为 AI 智能体提供的托管浏览器

Riddle 为你的智能体提供一个浏览器，无需在本地运行 Chrome。只需一次 API 调用，即可实现导航、点击、填写表单、截图、捕获网络流量。所有执行都在 Riddle 的服务器上完成——让你的智能体保持轻量。

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

为何选择它而非本地 Chrome

• 无需 Chromium 二进制文件 —— 节省约 1.2 GB 内存，避免 Lambda/容器体积问题。
• 无依赖地狱 —— 无需 @sparticuz/chromium，无 Puppeteer 版本冲突，无 ENOENT / spawn 错误。
• 完整的 Playwright 功能 —— 不仅仅是截图。可运行真实的 Playwright 脚本、多步骤工作流、表单填写、认证会话。
• 随处可用 —— Lambda、容器、T3 Micro 实例，你的智能体可以运行的任何地方。

安装

步骤 1：注册 —— 在 riddledc.com/register 创建一个免费账户。无需信用卡。你将获得 5 分钟免费浏览器时长。

步骤 2：获取 API 密钥 —— 注册后，从 仪表板 获取你的 API 密钥。

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

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

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

# 设置你的 API 密钥
openclaw config set plugins.entries.openclaw-riddledc.config.apiKey "YOUR_RIDDLE_API_KEY"

一个注意事项： OpenClaw 要求插件在 plugins.allow 列表中。CLI 没有追加标志，因此请检查你当前的列表并添加 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 —— 运行分步工作流（转到、点击、填写、每一步截图）。

访问 https://example.com/login，在邮箱字段填写 "test@example.com"，填写密码字段，点击提交按钮，然后截图结果。

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

运行一个 Playwright 脚本，导航到 https://example.com，等待仪表板加载，提取所有表格行，并对页面截图。

riddle_run —— 用于自定义负载的低级 API 透传。

所有工具都会将截图保存到 ~/.openclaw/workspace/riddle/screenshots/（非内联 base64），并在响应中返回文件路径。添加 include: ["har"] 以同时捕获完整的网络流量。

认证会话

需要与登录后的页面交互吗？传递 cookies、localStorage 或自定义请求头：

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

该插件支持 cookies、localStorage 条目和自定义 HTTP 请求头作为认证参数。

信任与安全

此插件的构建考虑了 Moltbook 智能体社区提出的关切——特别是关于技能来源、能力清单和运行时边界的讨论。

此插件声明的内容（openclaw.plugin.json 中的能力清单）：
- 网络：仅与 api.riddledc.com 通信——运行时强制执行的硬编码允许列表，而不仅仅是配置时。
- 文件系统：仅写入 ~/.openclaw/workspace/riddle/。
- 智能体上下文：零访问对话历史、其他工具的输出或用户资料。
- 密钥：仅需要 RIDDLE_API_KEY，且仅发送到声明的端点。

这在实践中的意义：
- 即使配置被篡改，你的 API 密钥也无法发送到任何非 Riddle 域名（每次请求都会运行硬编码检查）。
- 该插件无法读取你的对话、记忆或其他插件的数据。
- 截图保存为文件引用，而非内联 base64——防止上下文溢出和日志中的意外数据泄漏。

自行验证：
- 源代码：github.com/riddledc/integrations
- npm 来源验证：npm audit signatures @riddledc/openclaw-riddledc
- 校验和：包内的 CHECKSUMS.txt
- 完整威胁模型：包内的 SECURITY.md

这是一个 插件（可审计的代码），而非技能（提示文本）。你可以在安装前阅读每一行代码。

定价

Riddle 采用透明的按执行计费模式。一次简单的截图只需几分之一美分。请访问 riddledc.com 查看当前定价。

获取帮助

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

链接

• 官网： riddledc.com
• 文档： riddledc.com/docs
• 定价： riddledc.com/pricing
• 仪表板： riddledc.com/dashboard