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 禁止访问，密钥可能缺少对所请求API产品（研究/浏览）的访问权限。

捆绑的运行脚本

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

• 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）返回给用户，并包含来源 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": "Give me a list of all employees (names and titles) of Yutori.",
    "start_url": "https://yutori.com",
    "max_steps": 60
  }'

轮询直到成功，然后返回一个去重后的列表。

输出风格

• 偏好美观的文本+ 项目符号。
• 包含关键来源网址。
• 如果代理输出包含HTML（例如，<pre>...</pre>），请去除HTML并返回纯文本。

故障排除

• 401 缺少API密钥头：请确保您发送了正确的头部。Yutori 大多数API使用x-api-key。
• 403 禁止访问：密钥无权访问该环境中的该产品。
• 长时间运行的任务：分享view_url并可以选择性地延长轮询时间。