研究转表格（Research to Sheets）

调研网站，提取结构化结果，并将干净的行数据保存至 Google Sheets。适用于用户希望将网页调研成果整理为电子表格的场景——例如竞品清单、价格数据、联系人列表，或任何来自网页的结构化表格。

该技能在 Google Sheets 步骤中使用 ClawLink，因此用户无需手动配置 Google Sheets API。

三步完成设置

工作原理

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│ Google Sheets    │
│   (用户聊天)    │     │   (OAuth)    │     │ (Sheets API) │
└─────────────────┘     └──────────────┘     └──────────────────┘
          │                       │                       │
          │  1. 安装插件          │                       │
          │  2. 绑定设备           │                       │
          │  3. 连接 Sheets       │                       │
          │                      │  4. 获取安全 Token   │
          │                      │  5. 代理请求         │
          │                      │                       │
          ▼                      ▼                       ▼
    ┌──────────┐          ┌──────────┐          ┌──────────┐
    │  SKILL   │          │ 控制台   │          │ Google   │
    │  文件     │          │ 认证     │          │ Sheets   │
    └──────────┘          └──────────┘          └──────────┘

安装

从 ClawHub 安装已验证的 ClawLink 插件。用户确认后，请完成全部设置流程，确保 ClawLink 工具在下一次 OpenClaw 聊天中可见。

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

然后告知用户：“OpenClaw 已重启。请单独发送 /new 消息以开启全新对话，随后再次请求 Research to Sheets。”

快速入门

# 列出可用的 Google Sheets 工具
clawlink_list_tools --integration google-sheets

# 搜索追加行工具
clawlink_search_tools --query "append rows" --integration google-sheets

推荐触发语句

• “调研以下公司，并将结果保存到我的表格中”
• “查找竞品并导入 Google Sheets”
• “从这些网站收集价格信息，并写入电子表格”
• “抓取这些页面，并将结果组织成结构化行数据”
• “帮我用 Google Sheets 构建一份潜在客户清单”

工作流

1. 执行操作前明确表格结构

需向用户确认以下内容：

• 调研目标
• 用户期望的列字段
• 目标电子表格或工作表标签页（若用户已有）
• 需采集的行数或范围

若输出结构尚不清晰，请先提出一套简洁的列定义，再开始数据采集。

2. 从网页收集信息

利用当前聊天会话中可用的任意研究能力，获取原始调研结果。

示例包括：

• 公司名称、官网、简介
• 定价方案名称与对应价格
• 联系人姓名、职位、邮箱
• 文章标题、URL、摘要
• 产品名称、分类、功能特性

若结构尚未稳定，请勿将混乱或不完整的行数据写入 Google Sheets。

3. 将调研结果标准化为结构化行数据

写入前须执行以下步骤：

• 去重
• 确保每行数据严格匹配预设列结构
• 对缺失值显式标注（禁止猜测填充）
• 保持 URL、邮箱、数字等字段为干净、可被程序解析的格式

当数据具有实际意义时，向用户提供 3–5 行的简短预览。

4. 发现实时可用的 Google Sheets 工具

1. 调用 clawlink_list_integrations 确认 Google Sheets 已连接。
2. 调用 clawlink_list_tools 并指定 integration 参数为 google-sheets。
3. 若无法确定具体写入工具，可调用 clawlink_search_tools，传入如 append rows、create spreadsheet 或 update cells 等简短查询词。
4. 在使用陌生工具或任何写入类工具前，务必先调用 clawlink_describe_tool。
5. 以返回的 schema 和说明文档为准，作为唯一可信来源。

5. 预览并确认写入操作

对所有写入、创建、覆盖、追加或批量更新操作：

1. 如有 clawlink_preview_tool，请优先调用。
2. 向用户展示将被修改的具体工作表或单元格范围。
3. 获得用户明确确认后再执行写入。
4. 通过 clawlink_call_tool 执行最终操作。

6. 清洁收尾

完成写入后：

• 总结已保存内容
• 如已知，注明工作表或电子表格名称
• 说明跳过的行或缺失值情况
• 提供下一步建议，例如排序、去重、添加公式等

良好工作流行为准则

• 优先在采集大量行数据前明确定义清晰的 schema。
• 默认采用追加行（append）而非覆盖现有数据，除非用户明确要求替换。
• 保持每行数据简短、结构清晰。
• 若用户要求大规模抓取，建议先尝试小批量样本，以验证格式正确性。
• 若目标工作表已存在，请先检查其结构，避免破坏原有布局。

规则

• 所有 Google Sheets 写入操作必须使用 ClawLink 工具；不得向用户索取独立的 Sheets 凭据。
• 不得臆造 Google Sheets 工具名称或 schema；必须严格依据当前轮次中 ClawLink 实时返回的工具目录。
• 在创建电子表格、追加行、覆盖单元格或批量编辑记录前，必须获得用户确认。
• 不得虚构缺失的研究数据以强行填满表格。
• 若 Google Sheets 尚未连接，请引导用户访问 https://claw-link.dev/dashboard?add=google-sheets。

示例提示语

• 调研 25 家 AI 代理初创公司，将公司名称、官网、所属类别及一句话简介存入 Google Sheets。
• 访问以下竞品定价页面，提取方案名称与月度价格，并写入电子表格。
• 查找本市咖啡馆，将名称、官网、电话与地址保存至我的工作表。
• 调研此创始人名单中的 LinkedIn 个人主页，并将结果存入 Google Sheets。

发现工作流（Discovery Workflow）

1. 调用 clawlink_list_integrations 确认 Google Sheets 是否已连接。
2. 调用 clawlink_list_tools --integration google-sheets 查看实时工具目录。
3. 以返回列表为唯一权威依据；不得猜测或假设工具是否存在。
4. 若用户描述了某项能力但无法确定对应工具，可调用 clawlink_search_tools，传入简短查询词及 integration google-sheets。
5. 若未返回任何 Google Sheets 工具，请引导用户访问 https://claw-link.dev/dashboard?add=google-sheets。

执行工作流（Execution Workflow）

┌─────────────────────────────────────────────────────────────┐
│  读取操作（安全）                                           │
│  list → get → search → describe → call                      │
│                                                             │
│  示例：列出工作表 → 检查现有结构 → 展示 schema           │
└─────────────────────────────────────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────┐
│  写入操作（需确认）                                         │
│  list → get → describe → preview → confirm → call           │
│                                                             │
│  示例：描述工具 → 预览变更 → 用户批准 → 执行追加操作       │
└─────────────────────────────────────────────────────────────┘

1. 对于不熟悉的工具、模糊请求或任何写入操作，请首先调用 clawlink_describe_tool。
2. 根据返回的指引、schema、whenToUse、askBefore、safeDefaults、examples 和 followups 构建调用参数。
3. 在写入前，优先执行 read、list、search、get 类操作，以降低歧义性。
4. 对写入操作或任何标记为需确认的操作，请首先调用 clawlink_preview_tool。
5. 仅在预览结果与用户意图完全一致后，才通过 clawlink_call_tool 执行；确认参数应在此之后传入。
6. 若工具调用失败，请如实反馈真实错误；不得伪造结果，也不得将失败归因为“能力缺失”，除非实时工具目录明确支持该结论。

注意事项

• 这是一个工作流型技能，串联网页调研与 Google Sheets 写入操作。
• 网页调研能力取决于当前聊天会话中可用的工具集。
• Google Sheets 写入均经由 ClawLink 完成，无需额外 Sheets 凭据。
• 写入前必须对数据进行标准化处理——混乱输入必然导致混乱表格。

错误处理

故障排查：工具不可见

1. 检查 ClawLink 插件是否已安装：

   openclaw plugins list
   

2. 若插件已安装但工具未显示，请提示用户单独发送 /new 消息以重新加载工具目录。
3. 若新对话仍无改善，请执行：

   openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
   openclaw gateway restart
   

4. 重启完成后，请提示用户再次发送 /new 并重试。

故障排查：工具调用无效

1. 确保 Google Sheets 工具的 integration slug 为 google-sheets。
2. 调用前，使用 clawlink_describe_tool 核实参数名与类型。
3. 对所有写入操作，务必先调用 clawlink_preview_tool。

资源

• ClawLink：https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=research-to-sheets
• ClawLink 文档：https://docs.claw-link.dev/openclaw
• ClawLink 验证页：https://claw-link.dev/verify
• Google Sheets API：https://developers.google.com/sheets/api

相关技能

• Google Sheets — 提供完整的 Google Sheets 操作能力
• Firecrawl — 用于网页调研与抓取