云端浏览器自动化

技能简介

Riddle 提供托管式浏览器自动化服务，让 AI 代理无需在本地运行 Chrome 即可执行网页操作。通过单一 API 调用完成页面导航、点击、表单填写、截图和网络流量捕获，所有执行均在 Riddle 服务器端完成。

能做什么

• 对任意网址进行单页或批量截图
• 执行多步骤网页操作流程（跳转、点击、填写、截图）
• 运行完整 Playwright 脚本实现复杂自动化
• 捕获网络请求记录（HAR 格式）
• 使用 Cookie 或自定义头部访问需登录的页面

使用说明

第一步：注册账号

访问 riddledc.com/register 创建免费账户，无需信用卡，赠送 5 分钟浏览器使用时间。

第二步：获取 API 密钥

登录后在 控制台 查看 API 密钥。

第三步：安装并配置插件

# 安装插件
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 数组：

# 查看当前白名单
openclaw config get plugins.allow

# 添加 riddle 插件（或使用 jq 直接编辑 ~/.openclaw/openclaw.json）
jq '.plugins.allow += ["openclaw-riddledc"]' ~/.openclaw/openclaw.json > tmp && mv tmp ~/.openclaw/openclaw.json

# 重启网关
openclaw gateway restart

安装完成后可使用五个工具：riddle_screenshot（单页截图）、riddle_screenshots（批量截图）、riddle_steps（分步操作）、riddle_script（Playwright 脚本）、riddle_run（底层 API）。截图文件保存至 ~/.openclaw/workspace/riddle/screenshots/，返回文件路径而非 base64 编码。

输入与输出

见下方输入与输出表格。

风险提示

• 按量计费：$0.50/小时，按秒计费，单张截图约 $0.004
• 免费额度用尽后需充值才能继续使用
• 插件仅能将 API 密钥发送至 api.riddledc.com，无法修改此硬编码限制
• 截图以文件形式存储，需确保工作目录磁盘空间充足

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/davisdiehl/riddle/SKILL.md
来源类型：GitHub 仓库