\r \r

FineBI 技能\r

\r

技能介绍\r

\r 该技能集成了 FineBI，能够通过自然语言实现数据分析、生成报告以及查询数据集等功能。\r \r

工具列表\r

\r

get-dataset-info\r

通过名称查询 FineBI 数据集信息。\r \r 参数:\r

• dataset (string, 必填): 要查询的数据集名称\r
• filters (object, 选填): 用于过滤的键值对\r \r

preview-dataset-data\r

获取数据集的数据预览（限制最大不超过 10w 条数据）。\r \r 参数:\r

• dataset (string, 必填): 数据表的原始名称\r
• page (number, 选填): 页码，默认为 1\r
• size (number, 选填): 每页数据量，最大支持 100000，默认为 100\r \r

search-datasets\r

根据关键字分⻚搜索 FineBI 数据集。\r \r 参数:\r

• keyword (string, 必填): 要搜索的关键字\r
• page (number, 选填): 页码，默认为 1\r \r

export-dashboard-excel\r

将仪表板导出为 Excel 格式。\r \r 参数:\r

• reportId (string, 必填): 仪表板 ID\r
• widgetId (string, 选填): 组件 ID，用于导出特定的组件\r \r

export-dashboard-pdf\r

将仪表板导出为 PDF 格式。响应中会返回文件路径，和文件名。\r \r 参数:\r

• reportId (string, 必填): 仪表板 ID\r \r

export-dashboard-image\r

将仪表板导出为 PNG 格式的图片。\r \r 参数:\r

• reportId (string, 必填): 仪表板 ID\r \r

get-dashboard-user-info\r

获取当前用户信息及其创建的仪表板。\r \r 参数: 无\r \r \r

get-dashboards-by-subject\r

获取特定主题下的仪表板列表。\r \r 参数:\r

• subjectId (string, 必填): 主题 ID\r \r \r ---\r \r

🧩 扩展子技能（需手动加载）\r

\r 本技能目录下包含 4 个紧密关联的子技能，提供高级自动化场景支持。\r \r ⚠️ 重要：子技能不会自动触发，需要在使用时手动读取对应 SKILL.md 文件。\r \r | 子技能 | 功能描述 | 触发场景 | 文件路径 |\r |--------|---------|---------|----------|\r | bi-report-to-doc | 将 FineBI 仪表盘数据自动生成飞书云文档分析报告 | 经营周报/月报/异常分析报告自动生成 | bi-report-to-doc/SKILL.md |\r | skill-bi-briefing | 将 FineBI 核心指标压缩成飞书群播报卡片，支持定时任务 | 日报/周报/月报/异常播报定时群同步 | skill-bi-briefing/SKILL.md |\r | skill-bi-skill-alert-to-task | 监控 FineBI 指标阈值，自动创建飞书任务并通知负责人 | 库存/销售额/订单金额等阈值告警 | skill-bi-skill-alert-to-task/SKILL.md |\r | skill-bi-to-bitable | 将 FineBI 数据集同步到飞书多维表格，支持追加/覆盖/增量模式 | 数据归档/定时同步/二次协作 | skill-bi-to-bitable/SKILL.md |\r \r

如何加载子技能\r

\r 使用时通过 read 工具读取对应子技能的 SKILL.md：\r \r

{\r
  "action": "read",\r
  "path": "~/.openclaw/workspace/skills/finebi-skill/bi-report-to-doc/SKILL.md"\r
}\r
```\r
\r
或在主技能中根据用户意图自动推荐：\r
\r
> 检测到您需要生成经营分析报告，推荐加载 `bi-report-to-doc` 子技能。\r
\r
### 子技能快速索引\r
\r
#### 1. bi-report-to-doc（报告生成）\r
**典型场景**：\r
- "把经营看板整理成飞书文档"\r
- "生成上月异常分析报告"\r
- "数据刷新后自动写周报"\r
\r
**核心动作链**：\r
```\r
search-dashboards → get-dashboard-detail → export-dashboard-pdf/image \r
→ 结构化提取 → create-doc → write-content\r
```\r
\r
#### 2. skill-bi-briefing（群播报）\r
**典型场景**：\r
- "每天早上 9 点在群里发数据日报"\r
- "设置定时播报任务"\r
- "先发一条测试卡片看看"\r
\r
**核心动作链**：\r
```\r
search-dashboards → get-dashboard-detail → preview-dataset-data \r
→ 结构化播报对象 → send-message-card / create-cron-job\r
```\r
\r
#### 3. skill-bi-skill-alert-to-task（阈值告警）\r
**典型场景**：\r
- "库存低于 20 就创建任务通知负责人"\r
- "销售额环比下降超过 30% 自动报警"\r
- "监控订单金额异常"\r
\r
**核心动作链**：\r
```\r
search-datasets → get-dataset-info → preview-dataset-data \r
→ 阈值判定 → create-task → send-private-message\r
```\r
\r
#### 4. skill-bi-to-bitable（数据同步）\r
**典型场景**：\r
- "把 FineBI 数据同步到飞书多维表格"\r
- "每周自动追加新数据"\r
- "按主键增量更新"\r
\r
**核心动作链**：\r
```\r
search-datasets → get-dataset-info → preview-dataset-data \r
→ get-bitable-meta → 字段映射 → append/overwrite/upsert\r
```\r
\r
---\r
\r
## 常见工作流 (Common Workflows)\r
\r
### 使用/获取数据集数据\r
如果需要提取某个表的数据，标准的工作流程是：\r
1. **第一步**：先使用 `search-datasets` 命令，根据表名查到表信息，在返回结果中获取对应表的 ID（通常为 `name` 字段，即表的原始名称）。\r
2. **第二步**：调用 `preview-dataset-data` 命令，传入查到的 ID，从而获取该数据集的具体数据记录。\r
\r
### 导出 FineBI 仪表板为 PDF，然后分析导出的 PDF 文件生成报告 ⚠️\r
\r
⚠️ **重要警告**：分析 PDF 时**必须且只能**使用 OpenClaw 内置的 `pdf` 工具！禁止使用任何其他方式读取 PDF 内容！\r
\r
**工作流程**：\r
1. **导出 PDF**：调用 `export-dashboard-pdf` 命令，传入 `reportId` 参数，获取导出的 PDF 文件路径。\r
2. **复制到工作空间**：如果 PDF 在临时目录（如 `/tmp/` 或 `AppData/Local/Temp/`），必须先复制到工作空间目录（通常是 workspace）。\r
   - Windows: `Copy-Item \x3C源路径> -Destination "C:\Users\dailer\.openclaw\workspace\"`\r
   - Linux/Mac: `cp \x3C源路径> ~/workspace/`\r
3. **使用内置 pdf 工具分析** 📌：调用 `pdf` 工具读取 PDF 文件（传入本地文件路径），提取图表和数据内容。\r
4. **生成报告**：基于 PDF 内容生成 Markdown 格式的分析报告，包含核心主题、关键数据、趋势洞察和业务建议，最后发送给用户。\r
\r
\r
## 迁移的工具列表 (Migrated Tools)\r
\r
### `report-list`\r
Migrated tool: reportList\r
\r
**参数:**\r
- `subjectId`: 必填\r
\r
### `report-info`\r
Migrated tool: reportInfo\r
\r
**参数:**\r
- `reportIds`: 必填\r
\r
### `report-consanguinity`\r
Migrated tool: reportConsanguinity\r
\r
**参数:**\r
- `reportId`: 必填\r
\r
### `report-check`\r
Migrated tool: reportCheck\r
\r
**参数:**\r
- 无\r
\r
### `package-list`\r
Migrated tool: packageList\r
\r
**参数:**\r
- 无\r
\r
### `package-structure`\r
Migrated tool: packageStructure\r
\r
**参数:**\r
- `packId`: 必填\r
- `withTables`: 必填\r
\r
### `data-folders`\r
Migrated tool: dataFolders\r
\r
**参数:**\r
- 无\r
\r
### `data-folder-tree`\r
Migrated tool: dataFolderTree\r
\r
**参数:**\r
- `folderId`: 必填\r
\r
### `data-table-preview`\r
Migrated tool: dataTablePreview\r
\r
**参数:**\r
- `tableName`: 必填\r
\r
### `data-table-structure`\r
Migrated tool: dataTableStructure\r
\r
**参数:**\r
- `tableName`: 必填\r
\r
### `data-model`\r
Migrated tool: dataModel\r
\r
**参数:**\r
- `modelId`: 必填\r
\r
### `data-query`\r
Migrated tool: dataQuery\r
\r
**参数:**\r
- `body`: 必填\r
\r
### `data-preview`\r
Migrated tool: dataPreview\r
\r
**参数:**\r
- `body`: 必填\r
\r
### `data-search-tables`\r
Migrated tool: dataSearchTables\r
\r
**参数:**\r
- `body`: 必填\r
\r
### `data-search-fields`\r
Migrated tool: dataSearchFields\r
\r
**参数:**\r
- `body`: 必填\r
\r
### `data-field-data`\r
Migrated tool: dataFieldData\r
\r
**参数:**\r
- `body`: 必填\r
\r
### `data-field-range`\r
Migrated tool: dataFieldRange\r
\r
**参数:**\r
- `body`: 必填\r
\r
### `spider-status`\r
Migrated tool: spiderStatus\r
\r
**参数:**\r
- `taskInstanceId`: 必填\r
\r
### `subject-folders`\r
Migrated tool: subjectFolders\r
\r
**参数:**\r
- 无\r
\r
### `subject-tree-root`\r
Migrated tool: subjectTreeRoot\r
\r
**参数:**\r
- 无\r
\r
### `subject-folder`\r
Migrated tool: subjectFolder\r
\r
**参数:**\r
- `folderId`: 必填\r
\r
### `subject-tree`\r
Migrated tool: subjectTree\r
\r
**参数:**\r
- `folderId`: 必填\r
\r
### `subject-crumb`\r
Migrated tool: subjectCrumb\r
\r
**参数:**\r
- `folderId`: 必填\r
\r
### `subject-content`\r
Migrated tool: subjectContent\r
\r
**参数:**\r
- `subjectId`: 必填\r
\r
### `subject-reports`\r
Migrated tool: subjectReports\r
\r
**参数:**\r
- `subjectId`: 必填\r
\r
### `subject-get`\r
Migrated tool: subjectGet\r
\r
**参数:**\r
- `subjectIds`: 必填\r
\r
### `subject-search`\r
Migrated tool: subjectSearch\r
\r
**参数:**\r
- `body`: 必填\r
\r
### `subject-groups-search`\r
Migrated tool: subjectGroupsSearch\r
\r
**参数:**\r
- `body`: 必填\r
\r
### `subject-consanguinity`\r
Migrated tool: subjectConsanguinity\r
\r
**参数:**\r
- `subjectId`: 必填\r
\r