feishu-deep-research飞书深度研究报告生成器。自动执行深度研究并将结果导入为飞书文档。输入研究主题和云空间文件夹token，自动生成结构化研究报告并上传到飞书云空间。用于投资研究、行业分析、竞品调研、技术调研等需要多步骤信息收集和文档化的场景。
Install via ClawdBot CLI:
clawdbot install henryjing96/feishu-deep-research自动执行深度研究并生成飞书文档的完整工作流。
⚠️ 重要技术约束
本技能要求 严格使用飞书 REST API 直接调用，禁止使用任何封装工具（如feishu_doc、feishu_drive等）。
原因：封装工具隐藏了关键步骤（token获取、文件上传、导入任务），无法验证流程合规性。
必须使用：exec工具 +curl命令直接调用飞书 API
/feishu-research "研究主题" --folder-token <parent_node>完整的端到端工作流包含三个阶段：
必须首先向用户确认：
【启动确认】
研究主题：{topic}
研究深度：{basic/standard/deep}
数据时效：默认覆盖至 {current_date}
搜索速率：默认 1次/秒
请确认或调整：
- 如需指定历史日期范围，请告诉我（例："只需2024年数据"）
- 如需调整搜索速率，请告诉我（例："2次/秒"或"不限"）
- 如无特殊要求，回复"确认"开始执行规则：
确认后全自动执行，不再交互。
| 轮次 | 目标 | 时间范围 | 来源要求 |
|------|------|----------|----------|
| 第一轮 | 历史基础数据 | 最近完整财年 | 覆盖核心指标 |
| 第二轮 | 近期表现 | 最近4个季度 | 季度财报/数据 |
| 第三轮 | 最新动态 | 当前年份至current_date | 必须包含当月数据 |
搜索速率控制：
硬性规则：
生成报告前自动验证：
□ 数据来源数 ≥ 深度要求
□ 数据时间覆盖至目标日期（用户指定或current_date）
□ 包含当年最新数据
□ 至少3种来源类型（官方/媒体/研究机构）
任一检查不通过 → 自动补充搜索，不生成不完整报告数据时效声明格式：
**数据时效声明**
- 报告生成日期：{current_date}
- 数据时间范围：{start_date} - {end_date}
- 最新数据日期：{latest_data_date}
- 搜索来源数：{count} 个
- 覆盖完整性：完整/部分（如有缺失需说明）执行前必须复述：
我将按以下标准 API 流程执行文件上传：
1. 获取 tenant_access_token
2. 上传文件获取 file_token
3. 创建导入任务获取 ticket
4. 轮询查询 job_status 直到成功
确认：使用 exec + curl，绝不使用 feishu_doc/feishu_drive 工具Step 1: 获取 Tenant Access Token
必须使用 curl 调用：
curl -X POST https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal \
-H "Content-Type: application/json" \
-d '{
"app_id": "cli_xxx",
"app_secret": "xxx"
}'✅ 检查点：成功获取 token 后必须报告：
tenant_access_token: t-xxxxxStep 2: 上传文件到云空间
必须使用 curl 调用（multipart/form-data）：
curl -X POST "https://open.feishu.cn/open-apis/drive/v1/medias/upload_all" \
-H "Authorization: Bearer <tenant_access_token>" \
-F "file_name=xxx.md" \
-F "parent_type=explorer" \
-F "parent_node=<FOLDER_TOKEN>" \
-F "size=<FILE_SIZE>" \
-F "file=@/path/to/file.md"✅ 检查点：上传成功后必须报告：
file_token: xxx❌ 合规验证：如果没有明确报告 file_token，说明使用了 feishu_doc 工具，必须重试。
Step 3: 创建导入任务
必须使用 curl 调用：
curl -X POST "https://open.feishu.cn/open-apis/drive/v1/import_tasks" \
-H "Authorization: Bearer <tenant_access_token>" \
-H "Content-Type: application/json" \
-d '{
"file_token": "<FILE_TOKEN>",
"type": "docx",
"file_extension": "md",
"file_name": "xxx",
"point": {
"mount_type": 1,
"mount_key": "<FOLDER_TOKEN>"
}
}'✅ 检查点：创建成功后必须报告：
ticket: xxxStep 4: 轮询导入状态
必须使用 curl 循环查询：
for i in {1..15}; do
curl -X GET "https://open.feishu.cn/open-apis/drive/v1/import_tasks/<TICKET>" \
-H "Authorization: Bearer <tenant_access_token>"
# 检查 job_status
sleep 2
done✅ 检查点：导入完成后必须报告：
job_status: 0（成功）或 job_status: 2（失败）doc_url: https://xxx.feishu.cn/docx/xxxdoc_token: xxx❌ 合规验证：必须显示完整的轮询过程和最终结果，不能只给一个最终链接。
完成所有步骤后，汇总输出：
✅ 研究完成，{N}个来源已分析
✅ 数据时效：{start_date} 至 {end_date}（最新：{latest_date}）
✅ 文件已上传到云空间
- File Token: xxx
✅ 导入任务创建成功
- Ticket: xxx
✅ 文档导入完成
- Job Status: 0
- Doc URL: https://xxx.feishu.cn/docx/xxx
- Doc Token: xxx| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| topic | string | ✅ | 研究主题，如"特斯拉2025投资分析" |
| parent_node | string | ✅ | 飞书云空间文件夹 token |
| file_name | string | ❌ | 自定义文档名称（默认使用主题） |
| date_range | string | ❌ | 指定日期范围（默认覆盖至current_date） |
| search_rate | string | ❌ | 搜索速率（默认1次/秒） |
{
"success": true,
"doc_url": "https://xxx.feishu.cn/docx/xxx",
"doc_token": "xxx",
"file_token": "xxx",
"ticket": "xxx",
"import_status": "success",
"job_status": 0,
"data_range": "2024-01-01 至 2026-02-08",
"source_count": 25
}| 深度 | 来源数 | 时间覆盖 | 适用场景 |
|------|--------|----------|----------|
| basic | ≥5个 | 基础历史数据 | 快速了解 |
| standard | ≥10个 | 近2年+当年 | 一般调研 |
| deep | ≥20个 | 完整历史+当年最新 | 投资/战略研究 |
时间覆盖硬性要求：
自动生成的 Markdown 报告包含以下章节：
# {topic} 深度研究报告
**报告生成时间：** {timestamp}
**研究深度：** {depth}
**报告机构：** 虾哥 AI Research
**数据时效声明**
- 报告生成日期：{current_date}
- 数据时间范围：{start_date} - {end_date}
- 最新数据日期：{latest_data_date}
- 搜索来源数：{count} 个
---
## 一、执行摘要
### 1.1 核心发现
### 1.2 关键数据
---
## 二、研究背景与定义
### 2.1 研究范围
### 2.2 关键概念
---
## 三、主要研究发现
### 3.1 {子问题1}
### 3.2 {子问题2}
### 3.3 {子问题3}
---
## 四、数据来源与引用
- [来源1] url
- [来源2] url
---
## 五、结论与建议
### 5.1 主要结论
### 5.2 风险提示
### 5.3 后续建议需要从 OpenClaw 配置中读取以下信息：
{
"channels": {
"feishu": {
"appId": "cli_xxx",
"appSecret": "xxx"
}
}
}使用 gateway config.get 获取配置。
如果配置读取失败，提示用户：
"请提供 Feishu App ID 和 App Secret，或在配置中设置"
drive:file:upload - 文件上传docs:document:import - 文档导入drive:drive - 云空间访问遇到以下情况必须立即停止，向用户报告，不得生成不完整报告：
遇到限流时：
1. 按当前速率等待（默认1秒）
2. 自动重试（最多3次）
3. 成功 → 继续
4. 失败 → 停止并报告（不降级）报告支持以下可视化元素：
注意：飞书 API 导入时会自动处理 Markdown 表格，但复杂图表需要在飞书中手动优化。
/feishu-research "小米集团投资分析" --folder-token L5AOf4DYnlXma7duXAqceWm8nAb
【启动确认】
研究主题：小米集团投资分析
研究深度：deep
数据时效：默认覆盖至 2026年2月8日
搜索速率：默认 1次/秒
请确认或调整：
- 如需指定历史日期范围，请告诉我
- 如需调整搜索速率，请告诉我
- 如无特殊要求，回复"确认"开始执行
用户回复：确认
【执行过程】
Step 1: 前置检查
✅ 当前日期：2026-02-08
✅ 目标时间范围：2024-2026年（覆盖至最近日期）
✅ 搜索API可用
Step 2: 深度研究（全自动）
第一轮：历史基础数据（2024年报）... 10个来源
第二轮：近期表现（2025各季度）... 8个来源
第三轮：最新动态（2026年1-2月）... 12个来源
✅ 共30个来源，覆盖至2026年2月
Step 3: 报告生成
✅ 包含数据时效声明
Step 4: 文件上传
Step 4.1: 获取 Token
✅ tenant_access_token: t-g1042792VRYNWEDIA5OIMF6HM4ERFV26GBJD2WEZ
Step 4.2: 上传文件
✅ file_token: MLjXbh7ZQoyM1gxHTitcqHZ4nNh
Step 4.3: 创建导入任务
✅ ticket: 7603922307581021383
Step 4.4: 轮询导入状态
第1次查询: job_status=0 (成功)
✅ 导入完成
【执行结果】
✅ 研究完成，30个来源已分析
✅ 数据时效：2024-01-01 至 2026-02-08（最新：2026-02-01）
✅ 文件已上传到云空间
- File Token: MLjXbh7ZQoyM1gxHTitcqHZ4nNh
✅ 导入任务创建成功
- Ticket: 7603922307581021383
✅ 文档导入完成
- Job Status: 0
- Doc URL: https://caz6yhvgk5z.feishu.cn/docx/RdKTdVO5bokpSNxgrjtcZcTenUb
- Doc Token: RdKTdVO5bokpSNxgrjtcZcTenUb| 步骤 | 端点 | 方法 |
|------|------|------|
| 获取 Token | /open-apis/auth/v3/tenant_access_token/internal | POST |
| 上传文件 | /open-apis/drive/v1/medias/upload_all | POST |
| 创建导入任务 | /open-apis/drive/v1/import_tasks | POST |
| 查询导入状态 | /open-apis/drive/v1/import_tasks/{ticket} | GET |
10 表示成功, 2 表示失败执行完成后，自我检查：
feishu_doc 或 feishu_drive 工具？（必须：否）exec + curl 调用 API？（必须：是）tenant_access_token？（必须：是）file_token？（必须：是）ticket？（必须：是）job_status？（必须：是）如果任何一项未通过，必须重新执行。
feishu_doc create、feishu_drive 等封装工具exec + curl 直接调用飞书 REST API虾哥 AI Research 水印如果执行过程中发现使用了封装工具或数据不完整：
Generated Mar 1, 2026
VC analysts use this skill to generate deep research reports on potential investment targets, such as startups or emerging technologies. It automates data collection from multiple sources, ensuring up-to-date financial and market data for due diligence and investment decisions.
Tech companies employ this skill to analyze competitors by gathering recent performance data, product updates, and market trends. It helps in strategic planning and identifying gaps in the competitive landscape, with reports structured for easy sharing via Feishu.
Business development teams use this skill to research new markets, including regulatory environments, consumer trends, and local competitors. It provides comprehensive reports that support decision-making for expansion plans, with data validated for timeliness.
Researchers in academia or think tanks utilize this skill to compile data for industry reports, such as on sustainability or economic trends. It ensures data integrity through automated checks and generates structured documents suitable for publication or internal review.
Product managers apply this skill to assess the feasibility of new products by researching market demand, technical requirements, and competitor offerings. It streamlines the research phase, producing detailed reports that inform go/no-go decisions and resource allocation.
Offer this skill as part of a subscription-based SaaS platform for research teams, charging per report or monthly fee. It targets enterprises needing automated, compliant research workflows, with revenue from tiered plans based on usage and depth levels.
Integrate the skill into consulting firms' toolkits to enhance client deliverables, such as investment or market analysis reports. Revenue comes from service fees charged for comprehensive research projects, leveraging the skill's automation to reduce manual effort.
License the skill to large corporations for internal use by departments like R&D or strategy, with one-time or annual licensing fees. It supports compliance with strict API usage and data validation, generating revenue from enterprise-scale deployments.
💬 Integration Tip
Ensure Feishu API credentials are correctly configured via gateway config.get to avoid authentication failures during file uploads.
Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).
AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.
This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.
Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
Search indexed Discord community discussions via Answer Overflow. Find solutions to coding problems, library issues, and community Q&A that only exist in Discord conversations.
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.