名称： yutori-web-research
描述： 使用 Yutori 的研究 API 和浏览 API（云端浏览器）来研究主题、收集资料并从网络提取结构化信息。当用户要求“研究 X”、“监控/查找论文”或“导航到某个网站并提取信息”，并且您通过 YUTORI_API_BASE 环境变量以及环境变量中的 API 密钥（YUTORI_API_KEY 或 ~/.openclaw/openclaw.json 中的 env.YUTORI_API_KEY）可以访问 YUTORI 的开发/生产端点时，请使用此技能。

yutori-web-research

利用 Yutori 的云端智能体完成以下两类任务：

1) 研究（广泛/深入的网络研究 + 引用来源）通过 POST /v1/research/tasks
2) 浏览（在云端浏览器上进行网页导航的智能体）通过 POST /v1/browsing/tasks

此技能适用于需要专用网络智能体的网络任务（例如查找论文、分析竞争对手、获取产品信息、从网站提取列表），且 OpenClaw 本地的 web_fetch 或 browser 工具不适用的情况。

前提条件（认证与端点）

• 需要 YUTORI_API_KEY（首选：由 OpenClaw Gateway 环境提供；备选：位于 ~/.openclaw/openclaw.json 中的 env.YUTORI_API_KEY）。
• 除非被覆盖，否则端点默认为开发环境：
• 设置 YUTORI_API_BASE=https://api.dev.yutori.com（开发环境）
• 或 YUTORI_API_BASE=https://api.yutori.com（生产环境）

如果请求返回 403 Forbidden，可能是密钥无权访问所请求的 API 产品（研究/浏览）。

捆绑的运行脚本

此技能期望存在（或与此技能捆绑）一个小的 Node.js 运行脚本：

• yutori-research.mjs — 创建并轮询研究任务；输出格式美观的文本。

建议：将此脚本捆绑在此技能文件夹的 scripts/yutori-research.mjs 路径下。

工作流：研究一个主题（简报 + 阅读清单）

当用户要求进行研究时（例如：“过去一个月的强化学习论文”）：

1) 撰写一个简洁的查询提示，要求：
- 一页简报（主题与趋势）
- 精选阅读清单（10–15 项，每项包含标题、1–2 句摘要、重要性说明和链接）
- 优先选择一手来源（arXiv + 出版商页面）

2) 使用运行脚本执行研究任务（示例）：

cd /Users/juanpin/.openclaw/workspace
node yutori-research.mjs "研究过去 30 天内的强化学习论文。输出：(1) 一份关于主题/趋势的简明一页简报，以及 (2) 一份包含 12 篇论文的精选列表，每篇论文需包含标题、2 句摘要、重要性说明和链接。优先选择 arXiv 和会议链接。"

3) 将结果以清晰的要点列表（而非原始 JSON）形式返回给用户，并包含来源 URL。

工作流：浏览网站并提取信息（例如，员工名单）

当用户提出以下要求时，使用浏览 API：
- “导航到 <网站> 并列出 …”
- “填写表单 / 点击翻页 / 收集项目”

创建一个浏览任务（示例 curl 命令）：

curl --request POST \
  --url "$YUTORI_API_BASE/v1/browsing/tasks" \
  --header "x-api-key: $YUTORI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "task": "给我一份 Yutori 所有员工（姓名和职位）的列表。",
    "start_url": "https://yutori.com",
    "max_steps": 60
  }'

轮询直到状态变为 succeeded，然后返回一个去重后的列表。

输出风格

• 优先使用格式美观的文本和要点列表。
• 包含关键来源 URL。
• 如果智能体输出包含 HTML（例如 <pre>...</pre>），请将其剥离并返回纯文本。

故障排除

• 401 Missing API key header：确保发送了正确的请求头。Yutori 大多数 API 使用 x-api-key。
• 403 Forbidden：密钥在该环境中无权访问该产品。
• 长时间运行的任务：分享 view_url，并可选地延长轮询时间。