用途
Research 技能用于对某个主题、想法或问题开展开放式研究，并持续构建一份“活的” Markdown 文档。其核心理念是：对话是临时的，文档才是真正重要的产出。
触发场景
当用户想要执行以下操作时激活：
- 研究某个主题、想法或问题
- 在决定构建某物之前先进行探索
- 调查各种选项、模式或方法
- 创建“研究文档”或“调查报告”
- 对复杂主题运行深度异步研究
研究目录结构
每个研究主题拥有独立文件夹：
~/.openclaw/workspace/research/<topic-slug>/
├── prompt.md # 原始研究问题/提示
├── research.md # 主要发现（Parallel 输出或交互式笔记）
├── research.pdf # PDF 导出（生成时）
└── ... # 其他相关文件（数据、图片等）
两种研究模式
1. 交互式研究（默认）
适用于在对话中共同探索的主题。实时进行搜索、综合并更新文档。
2. 深度研究（异步）
适用于需要全面调查的复杂主题。通过 parallel-research CLI 使用 Parallel AI API。耗时数分钟到数小时，返回详细的 Markdown 报告。
深度研究适用场景：
- 市场分析、竞争格局
- 需要大量来源收集的技术深度调查
- 受益于并行探索的多方面问题
- 用户明确说“deep research”或需要全面覆盖时
交互式研究工作流
1. 初始化研究
在 ~/.openclaw/workspace/research/<topic-slug>/ 创建研究文件夹。
创建 prompt.md，包含原始问题：
# <Topic Title>
> <The core question or curiosity>
**Started:** <date>
创建 research.md，包含工作结构：
# <Topic Title>
**Status:** Active Research
**Started:** <date>
**Last Updated:** <date>
---
## Open Questions
- <initial questions to explore>
## Findings
<!-- Populated as we research -->
## Options / Approaches
<!-- If comparing solutions -->
## Resources
<!-- Links, references, sources -->
## Next Steps
<!-- What to explore next, or "graduate to project" -->
与用户确认——展示文件夹已创建，并询问首先探索什么。
2. 研究循环
每次交互：
- 执行研究——网络搜索、获取文档、探索代码
- 更新文档——添加发现、移动已回答的问题、添加来源
- 展示进度——说明新增了什么（不要重复全部内容）
- 提示下一步方向——以问题或建议结尾
关键行为：
- 优先更新已有章节，而非创建新章节
- 发现使用要点列表；总结使用散文
- 标注不确定性（“似乎”、“根据 X”、“未验证”）
- 尽可能链接到来源
3. 综合检查点
每 5-10 次交互后，提供以下选项：
- 撰写“当前理解”总结
- 精简冗余发现
- 若内容过于庞杂则重新组织
- 检查盲点
4. 完成
研究完成时，更新 research.md 中的状态：
- “Status: Complete”——完成，原地保留作为参考
- “Status: Ongoing”——活的文档，将持续更新
如果研究专门用于构建项目：
- 升级到
~/specs/<project-name>.md作为项目规格 - 或直接基于发现创建项目
- 更新状态为 “Status: Graduated → ~/specs/...”
大多数研究只是研究——不需要变成规格。只有确实要基于它构建东西时才升级。
深度研究工作流
1. 启动深度研究
parallel-research create "Your research question" --processor ultra --wait
处理器选项：
- lite、base、core、pro、ultra（默认）、ultra2x、ultra4x、ultra8x
- 添加
-fast后缀以速度优先于深度：ultra-fast、pro-fast 等
选项：
-w, --wait——等待完成并显示结果-p, --processor——选择处理器层级-j, --json——原始 JSON 输出
2. 安排自动检查（可选）
深度研究任务耗时数分钟到数小时。建议自动轮询结果而非手动检查。
选项：
- OpenClaw 用户：参见 OPENCLAW.md 了解基于 cron 的自动检查调度
- 其他环境：使用任意调度器（cron、systemd timer、CI job）定期运行
parallel-research status <run_id>和parallel-research result <run_id>直到完成 - 简单方式：直接使用
parallel-research create "..." --wait阻塞直到完成（适用于较短任务）
3. 手动检查（如需要）
parallel-research status <run_id>
parallel-research result <run_id>
4. 保存到研究文件夹
创建研究文件夹并保存结果：
~/.openclaw/workspace/research/<topic-slug>/
├── prompt.md # 原始问题 + 运行元数据
├── research.md # 完整 Parallel 输出
prompt.md 应包含：
# <Topic Title>
> <Original research question>
**Run ID:** <run_id>
**Processor:** <processor>
**Started:** <date>
**Completed:** <date>
research.md 包含完整的 Parallel 输出，以及任何后续笔记。
PDF 导出
所有 PDF 都放入研究文件夹——绝不保存到 tmp/。无论使用 export-pdf、浏览器 pdf 操作还是其他方法，输出路径必须是 research/<topic-slug>/。
使用 export-pdf 脚本将研究文档转换为 PDF：
export-pdf ~/.openclaw/workspace/research/<topic-slug>/research.md
# Creates: ~/.openclaw/workspace/research/<topic-slug>/research.pdf
对于浏览器生成的 PDF（例如将网页保存为 PDF）：
browser pdf → save to research/<topic-slug>/<descriptive-name>.pdf
注意：表格会渲染为堆叠行（PyMuPDF 限制）。对研究文档而言可以接受。
命令
"new research: "——启动交互式研究文档"deep research: "——启动异步深度研究"show doc"/"show research"——显示当前研究文件"summarize"——综合检查点"graduate"——将研究移至下一阶段"archive"——标记为完成参考"export pdf"——导出为 PDF"check research"——检查待处理深度研究任务的状态
文档原则
- 原子化发现——每条要点一个洞察
- 链接一切——来源、文档、仓库
- 捕获上下文——我们为什么看这个？
- 标注置信度——不确定时使用限定词
- 为重要发现标注日期——尤其是快速变化的主题
安装设置
参见 SETUP.md 了解首次安装：
- parallel-research CLI
- PDF 导出工具（pandoc、PyMuPDF）
适用场景
- 主题调研与可行性探索
- 方案、模式、方法对比
- 市场分析与竞争格局调查
- 需要大量来源收集的技术深度调查
- 构建项目前的信息收集
限制
- 深度研究依赖 Parallel AI API 与 parallel-research CLI，需单独安装配置
- 深度研究耗时数分钟到数小时，需等待或轮询
- PDF 导出中表格会渲染为堆叠行（PyMuPDF 限制）
- 具体收费、价格、平台支持范围等资料暂未提供