跳转到主要内容
Google Sheets 扩展允许智能体操作电子表格，包括创建表格、读写单元格区间、追加行、格式化单元格和管理工作表。使用标准 A1 表示法，适合数据录入自动化与报表生成。

​
设置

如果您还没有完成 Google OAuth，请先完成 Google OAuth 设置。
1

启用 Google Sheets API

在 Google Cloud 项目中进入 APIs & Services → Library，搜索 Google Sheets API 并点击 Enable。
2

安装扩展

ironclaw registry install google-sheets
3

授权访问

ironclaw tool auth google-sheets
IronClaw 会提供认证链接。请确保已按 auth setup 完成回调配置。若环境支持，会自动打开浏览器。授权成功后，令牌会被安全保存并自动刷新。
即使已经授权过其他 Google 扩展，也需要对每个新增扩展单独执行一次授权。

​
可用操作

  • create_spreadsheet: 创建新表格，可指定标题与初始工作表名
  • get_spreadsheet: 获取元数据（标题、工作表名、命名范围）
  • read_values: 用 A1 表示法读取区间值（例如 Sheet1!A1:D10）
  • batch_read_values: 一次读取多个区间
  • write_values: 写入区间并覆盖原内容
  • append_values: 在区间末尾追加新行
  • clear_values: 清空区间值（保留格式）
  • add_sheet: 添加新工作表
  • delete_sheet: 按工作表 ID 删除
  • rename_sheet: 重命名工作表
  • format_cells: 为区间设置数值格式、文本样式或背景色

​
使用示例

配置后，您可以这样对智能体说：
  • “创建一个名为 Monthly Expenses 的新表格”
  • “读取预算表 A1 到 E20”
  • “在 Sales 工作表追加今天销售数据”
  • “清空 Draft 工作表数据”
  • “把第一个工作表改名为 Summary”
  • “把支出表 B 列设置为货币格式”

​
A1 表示法

所有区间操作都基于 A1 表示法，可加工作表名指定目标页签：
Notation含义
A1单个单元格
A1:C10行列范围
Sheet1!A1:B5指定工作表范围
Sheet1!A:ASheet1 的整列 A
多工作表场景下，建议总是包含工作表名（例如 Budget!B2:D50）。