研究技能

描述

围绕某个主题进行开放式研究，构建一份动态的Markdown文档。对话是临时的；文档才是关键。

触发条件

当用户想要进行以下操作时激活：

• 研究某个主题、想法或问题
• 在决定构建某物之前进行探索
• 调查选项、模式或方法
• 创建一份“研究文档”或“调查报告”
• 对复杂主题进行深入的异步研究

研究目录

每个研究主题都有其独立的文件夹：

~/.openclaw/workspace/research/<topic-slug>/
├── prompt.md          # Original research question/prompt
├── research.md        # Main findings (Parallel output or interactive notes)
├── research.pdf       # PDF export (when generated)
└── ...                # Any other related files (data, images, etc.)

两种研究模式

1. 交互式研究（默认）

适用于在对话中共同探索的主题。您实时搜索、综合信息并更新文档。

2. 深度研究（异步）

适用于需要全面调查的复杂主题。通过parallel-research 使用 Parallel AI APICLI。耗时数分钟至数小时，返回详细的markdown报告。

何时使用深度研究：

• 市场分析、竞争格局
• 需要广泛收集资料的技术深度剖析
• 可从并行探索中获益的多方面问题
• 当用户提及“深度研究”或希望获得全面覆盖时

交互式研究工作流程

1. 初始化研究

1. 在研究文件夹中创建位于~/.openclaw/workspace/research/<话题-短链>/

2. 创建 prompt.md包含原始问题：

   # <Topic Title>
   
   > <The core question or curiosity>
   
   **Started:** <date>
   

3. 创建 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" -->
   

4. 与用户确认- 显示文件夹已创建，并询问首先探索什么。

2. 研究循环

对于每一次交互：

1. 执行研究- 网络搜索、获取文档、探索代码
2. 更新文档- 添加发现、移动已回答的问题、添加来源
3. 展示进度- 记录添加的内容（不要重复所有内容）
4. 提示下一步方向- 以问题或建议结尾

关键行为：

• 优先更新现有部分而非创建新部分
• 发现用项目符号；总结用叙述性文字
• 注明不确定性（例如“似乎”、“据X称”、“未经核实”）
• 尽可能链接到来源

3. 综合检查点

每5-10次交流后，主动提供：

• 撰写“当前理解”总结
• 精简冗余发现
• 如果内容冗杂则重新组织
• 检查盲点

4. 完成

研究完成后，在以下文件中更新状态：research.md “状态：已完成”

• — 已完成，作为参考资料保留“状态：进行中”
• — 动态文档，将随时间更新如果研究专门用于构建项目：

升级为

• ~/specs/<项目名称>.md作为项目规格书或根据研究结果直接创建项目
• 将状态更新为
• “状态：已升级 → ~/specs/...”大多数研究仅仅是研究——不需要变成规格书。只有在你确实要基于它构建某些东西时，才进行升级。

深度研究工作流程

1. 开始深度研究

处理器选项：

parallel-research create "Your research question" --processor ultra --wait

轻量版

• 、基础版、核心版、专业版pro,ultra（默认）,ultra2x,ultra4x,ultra8x
• 添加-fast后缀以速度优先于深度：ultra-fast,pro-fast等。

选项：

• -w, --wait— 等待完成并显示结果
• -p, --processor— 选择处理器层级
• -j, --json— 原始JSON输出

2. 计划自动检查（可选）

深度研究任务需要数分钟到数小时。您会希望自动轮询结果，而不是手动检查。

选项：

• OpenClaw用户：参见OPENCLAW.md获取基于cron的自动检查调度方案
• 其他设置：使用任意调度器（cron、systemd定时器、CI任务）定期运行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          # Original question + run metadata
├── research.md        # Full Parallel output

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/<主题-短链接>/。

使用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:<主题>"- 启动异步深度研究
• "显示文档"/"显示研究"- 显示当前研究文件
• "总结"- 综合检查点
• "完成"- 将研究推进到下一阶段
• "归档"- 标记为完成参考
• "导出PDF"- 导出为PDF
• "检查研究"- 检查待处理的深度研究任务状态

文档原则

• 原子化发现- 每个要点一个见解
• 链接一切- 来源、文档、代码库
• 捕捉上下文- 我们为何查看此项？
• 注明置信度- 不确定时使用限定词
• 记录重要发现- 尤其针对快速发展的主题

设置

查看SETUP.md以进行首次安装：

• parallel-researchCLI
• PDF导出工具（pandoc, PyMuPDF）