yutori-web-research

使用 Yutori 的云代理完成以下两项任务：

1) 研究（广义/深度网络研究 + 引用）通过 POST /v1/research/tasks

2) 浏览（在云端浏览器中运行的网页导航代理）通过 POST /v1/browsing/tasks

此技能适用于需要专用网页代理协助的场景（如论文检索、竞争对手分析、产品信息获取、从网站提取列表等），当 OpenClaw 的本地 web_fetch 或 browser 工具不适用时。

前置条件（认证与端点）

• 需要提供 YUTORI_API_KEY（推荐方式：由 OpenClaw 网关环境变量提供；备用方式：读取 ~/.openclaw/openclaw.json 文件中的 env.YUTORI_API_KEY）。
• 默认端点为 dev，除非显式覆盖：

- 设置 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 "Research reinforcement learning papers from the last 30 days. Output (1) a concise 1-page brief of themes/trends and (2) a curated list of 12 papers with title, 2-sentence summary, why it matters, and a link. Prefer arXiv + conference links."

3) 将结果以清晰的项目符号形式返回给用户（非原始 JSON 格式），并附上来源链接。

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

当用户请求：

• “导航至 <站点> 并列出……”
• “填写表单 / 点击跳转页面 / 收集项目”

请使用浏览 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": "Give me a list of all employees (names and titles) of Yutori.",
    "start_url": "https://yutori.com",
    "max_steps": 60
  }'

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

输出风格

• 优先输出格式化文本 + 项目符号
• 必须包含关键来源链接
• 若代理输出包含 HTML（如 <pre>...</pre>），请剥离后返回纯文本

故障排查

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