{"skill":{"slug":"google-deep-research","displayName":"deep-research","summary":"使用 Gemini Deep Research Agent 进行自主深度研究，生成带引用的详细研究报告。当用户需要深度调研话题、生成研究报告、或需要多轮搜索和分析时使用。触发词：深度研究、deep research、帮我调研、研究一下、写研究报告、deep dive、详细分析。","description":"---\nname: deep-research\ndescription: \"使用 Gemini Deep Research Agent 进行自主深度研究，生成带引用的详细研究报告。当用户需要深度调研话题、生成研究报告、或需要多轮搜索和分析时使用。触发词：深度研究、deep research、帮我调研、研究一下、写研究报告、deep dive、详细分析。\"\nmetadata:\n  openclaw:\n    primaryEnv: GEMINI_API_KEY\n    homepage: https://www.npmjs.com/package/@google/genai\n---\n\n# Deep Research Agent\n\n使用 Gemini Deep Research Pro 执行自主多步搜索-阅读-分析的深度研究，通常需要 5-20 分钟完成。\n\n## 依赖来源\n\n- 首选 SDK 来源：npm 包 `@google/genai`\n- 可选兼容模式：通过 `GOOGLE_GENAI_SDK_PATH` 显式指定一个本地 SDK 路径\n\n不要依赖某台开发机上的隐式 bundled SDK 路径，也不要在技能里写死个人机器目录。\n\n## 工作流程\n\n### 1. 确认研究主题\n\n- 与用户确认研究主题和范围\n- 如果话题模糊，帮助用户明确研究方向和关注点\n- 将用户需求转化为清晰的英文或中文研究查询\n\n### 2. 准备 API Key\n\n必须显式提供：\n\n```bash\nexport GEMINI_API_KEY=\"<api_key>\"\n```\n\n不要自动读取本地 `openclaw.json` 或扫描多个默认配置位置。发布型技能应让密钥来源保持明确、可审查、可控。\n\n### 3. 执行研究\n\n**提醒用户**：深度研究通常需要 5-20 分钟，请耐心等待。\n\n脚本与 `SKILL.md` 位于同一目录。执行时先把脚本路径解析为当前技能目录下的 `deep-research.mjs`，不要写死开发机绝对路径。\n\n运行脚本：\n\n```bash\nGEMINI_API_KEY=\"<api_key>\" node <skill-dir>/deep-research.mjs \"<研究主题>\"\n```\n\n可选参数：\n\n- `--timeout <seconds>` — 超时时间，默认 3600 秒（1 小时）\n- `--no-stream` — 使用轮询模式（如果流式出错可尝试）\n\n可选 SDK 路径覆盖：\n\n```bash\nGOOGLE_GENAI_SDK_PATH=\"/path/to/@google/genai/dist/node/index.mjs\" \\\nGEMINI_API_KEY=\"<api_key>\" \\\nnode <skill-dir>/deep-research.mjs \"<研究主题>\"\n```\n\n**重要**：由于研究耗时较长，使用 exec 工具时设置足够的超时时间（至少 1200 秒）。\n\n### 4. 后续追问\n\n研究完成后，脚本会输出 Interaction ID。如果用户需要追问或深入某个方面：\n\n```bash\nGEMINI_API_KEY=\"<api_key>\" node <skill-dir>/deep-research.mjs --follow-up <interaction_id> \"<追加问题>\"\n```\n\n### 5. 呈现结果\n\n- stdout 输出为 Markdown 格式的研究报告\n- 保持原始 Markdown 格式呈现给用户\n- 报告包含引用来源链接\n- 如果用户需要，可以将报告保存为文件\n\n## 输出说明\n\n- **stdout** — 最终研究报告（Markdown 格式）\n- **stderr** — 进度信息：\n  - 🔬 研究开始\n  - 📊 状态更新\n  - 💭 思考摘要（Agent 的中间思考过程）\n  - ✅ 研究完成 + 耗时\n  - 📎 Interaction ID（用于后续追问）\n\n## 错误处理\n\n| 退出码 | 含义 | 处理方式 |\n|--------|------|----------|\n| 0 | 成功 | 正常呈现报告 |\n| 1 | 参数错误 | 检查研究主题是否提供 |\n| 2 | 环境或 API 错误 | 检查 `GEMINI_API_KEY`、`@google/genai` 安装和配额 |\n| 3 | 超时 | 建议缩小研究范围或增加超时 |\n\n## 安全\n\n- 不要将 API Key 直接展示给用户\n- 使用环境变量传递 API Key，不要把真实密钥写进技能文件\n- 不要在未获用户确认前读取本地配置中的潜在密钥\n","tags":{"latest":"1.0.2"},"stats":{"comments":0,"downloads":839,"installsAllTime":32,"installsCurrent":2,"stars":0,"versions":3},"createdAt":1773036338127,"updatedAt":1778491784317},"latestVersion":{"version":"1.0.2","createdAt":1773045570819,"changelog":"- Clarifies dependency handling: now requires explicit use of the @google/genai NPM package and/or GOOGLE_GENAI_SDK_PATH; stops scanning multiple local config paths.\n- Sets GEMINI_API_KEY as the explicit and only way to provide API credentials; local file/config scan is no longer supported.\n- Adds OpenClaw metadata (primaryEnv, homepage) to the manifest.\n- Updates process instructions to ensure SDK path and API key are provided in a clear, auditable, and controlled way.\n- Improves clarity on security and avoids use of personal/dev machine paths or bundled SDKs.","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"juan-xin-cai","userId":"s176vmsw277cbmxftj2h1emcr183hbx1","displayName":"juan-xin-cai","image":"https://avatars.githubusercontent.com/u/33806107?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089810406}}