OpenClaw Deep Research
Run research as a file-backed production workflow, not as a chat-only exercise. Optimize for source traceability, narrow ownership, compact handoffs, and a final report that distinguishes facts, interpretations, comparisons, and forecasts.
Platform notes
- - Install this skill under
~/.openclaw/skills/openclaw-deep-research/ for user-wide use or skills/openclaw-deep-research/ inside a workspace when using OpenClaw local skills. - Keep the actual research directory under the active workspace so report artifacts remain close to the task.
- Assume delegation is optional. Use subagents only if the current OpenClaw setup exposes them and the user explicitly wants parallel work.
Quick start
- 1. Freeze the topic, audience, report shape, and research cutoff date before collecting sources.
- Create one canonical project root in the current workspace and treat it as the single source of truth.
- Persist project memory immediately: status, task board, source ledger, claim ledger, fact-check log, handoffs, and draft report.
- If the user explicitly wants multi-agent work, split the project into bounded roles with disjoint write scopes. Otherwise use the same workflow locally without delegation.
- Collect sources first, write claims second, draft only from verified claims, and end with a QA pass that checks dates, comparability, and unsupported conclusions.
Non-negotiables
- - Keep exactly one canonical project directory.
- Write project memory to local files; do not rely on chat history as durable state.
- Prefer primary sources for unstable or high-stakes facts.
- Give every substantive claim a
claim_id and at least one source_id. - Put absolute dates on fast-moving facts and on the report cutoff.
- State the comparison metric and time window whenever comparing countries, companies, models, markets, or policies.
- Separate
hard_fact, reported_fact, interpretation, comparison, and forecast. - Do not let multiple agents edit the same files unless the user explicitly wants that tradeoff.
Workflow
1. Freeze scope
- - Clarify the research question, target reader, deliverable format, and report cutoff date.
- Prefer dimensional comparison over a single headline ranking when the topic is structurally uneven.
- Record the scope and stop conditions before searching.
For a starter layout, load references/project-layout.md.
2. Create the file-backed workspace
- - Create the project root and a minimal scaffold for workflow, sources, claims, checks, handoffs, and deliverables.
- Record current phase, next actions, and open questions in a short status file.
- Update these files every round so a later agent can resume without replaying chat.
For copy-paste starter files, load references/templates.md.
3. Decide the delegation pattern
- - Only use OpenClaw subagents when the user explicitly asks for multi-agent or delegation work and the current setup supports them.
- Use one agent per bounded responsibility or per independent research slice.
- Assign each agent one objective, one read set, one write scope, one cutoff date, and one handoff target.
- Keep the PM/orchestrator role local whenever possible so synthesis and quality control stay centralized.
For role options and handoff contracts, load references/delegation-patterns.md.
4. Collect sources
- - Build the source ledger before building the narrative.
- Prioritize primary sources: official documents, filings, company docs, papers, model cards, release notes, government pages, and original datasets.
- Use high-quality secondary sources for synthesis and triangulation when primary material is incomplete.
- Record enough metadata that another reviewer can reopen the source later.
For evidence rules and claim classes, load references/evidence-standards.md.
5. Build claims
- - Convert source notes into atomic claims.
- Attach
source_id, claim class, confidence, date range, and comparability notes. - Mark unsupported or unresolved claims as
draft, blocked, contested, or equivalent; do not quietly promote them into the report.
6. Normalize comparisons
- - Build a comparison matrix when the report compares two or more entities.
- Explicitly mark rows as
comparable, partial, or not_comparable. - If two sources use different units, populations, definitions, or time windows, say so instead of forcing a clean ranking.
7. Draft the report
- - Put the research cutoff date near the top.
- Draft from verified claims only.
- Keep the main text readable, but make the evidence chain auditable through source and claim ledgers.
- Include a methods section, limits section, and open questions or future watchpoints section.
8. QA the report
- - Recheck every numerical claim, dated statement, and leadership claim.
- Downgrade or remove statements that are true only under narrow assumptions.
- Ensure the final report does not blur facts and inference.
- Confirm that every citation in the report resolves back to the local ledgers.
Delegation rules
- - Keep agent ownership disjoint by file path or by work package.
- Require every handoff to include:
done, verified, open, next, and changed files. - Do not ask scouts to write synthesis if their job is evidence collection.
- Do not ask drafters to invent facts or fill gaps from memory.
- Route conflicts back to the source layer, not to a rhetorical compromise.
Writing rules
- - Prefer direct, dated language: "As of 2026-03-21..." over relative timing.
- Use cautious wording for vendor claims, self-reported performance, and fast-moving policy changes.
- Avoid totalizing conclusions like "X is winning overall" unless the evidence really supports that scope.
- End with what is still uncertain and what could change the conclusion.
Reference map
- -
references/project-layout.md -> canonical directory structure and when to create each artifact. - INLINECODE25 -> role menu, handoff contract, and anti-duplication rules.
- INLINECODE26 -> source hierarchy, claim classes, and QA gates.
- INLINECODE27 -> compact starter templates for ledgers, status files, and handoffs.
- INLINECODE28 -> OpenClaw specific installation and usage notes.
OpenClaw 深度研究
将研究作为基于文件的生产工作流运行,而非仅限聊天的练习。优化源可追溯性、明确所有权归属、紧凑交接,以及最终报告中区分事实、解读、比较和预测的能力。
平台说明
- - 将本技能安装至 ~/.openclaw/skills/openclaw-deep-research/ 以实现用户级使用,或在使用 OpenClaw 本地技能时安装至工作区内的 skills/openclaw-deep-research/ 目录。
- 将实际研究目录保留在活动工作区下,确保研究产物与任务紧密关联。
- 假设委派为可选操作。仅当当前 OpenClaw 设置支持子代理且用户明确要求并行工作时,才使用子代理。
快速开始
- 1. 在收集来源前,先确定主题、受众、报告形态和研究截止日期。
- 在当前工作区创建一个规范的项目根目录,并将其视为唯一真实来源。
- 立即持久化项目记忆:状态、任务看板、来源台账、声明台账、事实核查日志、交接记录和报告草稿。
- 如果用户明确要求多代理工作,将项目拆分为具有不重叠写入范围的限定角色。否则,在本地使用相同工作流,无需委派。
- 先收集来源,再构建声明,仅从已验证的声明起草报告,最后进行质量检查,核实日期、可比性和无依据的结论。
不可妥协事项
- - 仅保留一个规范的项目目录。
- 将项目记忆写入本地文件;不依赖聊天历史作为持久状态。
- 对于不稳定或高风险的事实,优先使用一手来源。
- 为每个实质性声明分配 claimid 和至少一个 sourceid。
- 在快速变化的事实和报告截止日期上标注绝对日期。
- 在比较国家、公司、模型、市场或政策时,明确说明比较指标和时间窗口。
- 区分 hardfact(硬事实)、reportedfact(报道事实)、interpretation(解读)、comparison(比较)和 forecast(预测)。
- 除非用户明确要求,否则不允许多个代理编辑同一文件。
工作流
1. 确定范围
- - 明确研究问题、目标读者、交付物格式和报告截止日期。
- 当主题结构不均衡时,优先采用维度比较而非单一标题排名。
- 在搜索前记录范围和停止条件。
如需初始布局,请加载 references/project-layout.md。
2. 创建基于文件的工作区
- - 创建项目根目录,并为工作流、来源、声明、核查、交接和交付物搭建最小框架。
- 在简短的状态文件中记录当前阶段、下一步行动和未解决问题。
- 每轮更新这些文件,以便后续代理无需重放聊天即可恢复工作。
如需可复制粘贴的初始文件,请加载 references/templates.md。
3. 决定委派模式
- - 仅在用户明确要求多代理或委派工作且当前设置支持时,才使用 OpenClaw 子代理。
- 每个限定职责或独立研究切片使用一个代理。
- 为每个代理分配一个目标、一个读取集、一个写入范围、一个截止日期和一个交接目标。
- 尽可能将项目经理/协调员角色保留在本地,以便集中进行综合和质量控制。
如需角色选项和交接合同,请加载 references/delegation-patterns.md。
4. 收集来源
- - 在构建叙述之前先建立来源台账。
- 优先使用一手来源:官方文件、备案文件、公司文档、论文、模型卡、发布说明、政府页面和原始数据集。
- 当一手材料不完整时,使用高质量二手来源进行综合和三角验证。
- 记录足够的元数据,以便其他审阅者后续能够重新打开来源。
如需证据规则和声明类别,请加载 references/evidence-standards.md。
5. 构建声明
- - 将来源笔记转化为原子声明。
- 附加 source_id、声明类别、置信度、日期范围和可比性说明。
- 将无依据或未解决的声明标记为 draft(草稿)、blocked(受阻)、contested(争议)或同等状态;不要悄悄将其提升至报告中。
6. 标准化比较
- - 当报告比较两个或多个实体时,构建比较矩阵。
- 明确将行标记为 comparable(可比)、partial(部分可比)或 not_comparable(不可比)。
- 如果两个来源使用不同的单位、人群、定义或时间窗口,应明确说明,而非强行得出整齐的排名。
7. 起草报告
- - 将研究截止日期放在报告顶部附近。
- 仅从已验证的声明起草。
- 保持正文可读性,但通过来源和声明台账使证据链可审计。
- 包含方法部分、限制部分以及未解决问题或未来关注点部分。
8. 质量检查报告
- - 重新核查每个数字声明、带日期的陈述和领先性声明。
- 降级或删除仅在狭窄假设下成立的陈述。
- 确保最终报告不模糊事实与推断的界限。
- 确认报告中的每个引用都能追溯到本地台账。
委派规则
- - 通过文件路径或工作包保持代理所有权不重叠。
- 要求每次交接包含:done(已完成)、verified(已验证)、open(未完成)、next(下一步)和已更改文件。
- 如果侦察员的工作是收集证据,不要要求他们撰写综合报告。
- 不要要求起草者凭空捏造事实或凭记忆填补空白。
- 将冲突回溯到来源层,而非寻求修辞上的妥协。
写作规则
- - 优先使用直接、带日期的语言:截至2026年3月21日...而非相对时间表述。
- 对供应商声明、自我报告的性能和快速变化的政策使用谨慎措辞。
- 避免使用X 全面领先等绝对化结论,除非证据确实支持该范围。
- 以仍不确定的内容以及可能改变结论的因素作为结尾。
参考地图
- - references/project-layout.md -> 规范目录结构及各产物的创建时机。
- references/delegation-patterns.md -> 角色菜单、交接合同和防重复规则。
- references/evidence-standards.md -> 来源层级、声明类别和质量检查关卡。
- references/templates.md -> 台账、状态文件和交接记录的紧凑初始模板。
- references/platform-notes.md -> OpenClaw 特定的安装和使用说明。