← 返回 Skills 市场
Gws Sheets Read
作者
googleworkspace-bot
· GitHub ↗
· v1.0.13
· MIT-0
549
总下载
0
收藏
15
当前安装
14
版本数
在 OpenClaw 中安装
/install gws-sheets-read
功能描述
Google Sheets: Read values from a spreadsheet.
使用说明 (SKILL.md)
sheets +read
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Read values from a spreadsheet
Usage
gws sheets +read --spreadsheet \x3CID> --range \x3CRANGE>
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--spreadsheet |
✓ | — | Spreadsheet ID |
--range |
✓ | — | Range to read (e.g. 'Sheet1!A1:B2') |
Examples
gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"
gws sheets +read --spreadsheet ID --range Sheet1
Tips
- Read-only — never modifies the spreadsheet.
- For advanced options, use the raw values.get API.
See Also
- gws-shared — Global flags and auth
- gws-sheets — All read and write spreadsheets commands
安全使用建议
This skill appears to be a thin wrapper around the 'gws' CLI to read Google Sheets, which is reasonable. However, it explicitly tells the agent to read ../gws-shared/SKILL.md for authentication and global flags — that means the real auth requirements live outside this SKILL.md. Before installing or enabling this skill: 1) Inspect the referenced ../gws-shared/SKILL.md to see exactly which credentials or environment variables are required and where they are stored; 2) Verify the provenance of the 'gws' binary (is it from a trusted provider/release?) because the skill will execute it; 3) Avoid putting high-privilege Google credentials into the agent until you confirm the minimum required scope (read-only scopes are preferable); 4) If you cannot inspect gws-shared, treat this skill as untrusted because it can cause the agent to access unspecified credentials. The minor metadata/version mismatch (SKILL.md metadata shows 0.22.5 vs registry 1.0.13) is a low-severity inconsistency but worth noting as part of overall hygiene.
功能分析
Type: OpenClaw Skill
Name: gws-sheets-read
Version: 1.0.13
The skill bundle defines a standard interface for reading Google Sheets data using the 'gws' CLI tool. The documentation in SKILL.md is consistent with its stated purpose, containing no evidence of malicious instructions, data exfiltration, or suspicious execution patterns.
能力评估
Purpose & Capability
Name/description align with the runtime instructions: the SKILL.md only documents running the 'gws' CLI to read a sheet range. Requiring the 'gws' binary is proportionate for a Google Sheets read helper.
Instruction Scope
The SKILL.md explicitly instructs the agent to read '../gws-shared/SKILL.md' for auth, global flags, and security rules. That directs the agent to read a file outside this skill's own SKILL.md (filesystem access to a sibling path) and to rely on external content for authentication behavior. The referenced file may instruct the agent to access credentials or perform other actions not visible here.
Install Mechanism
No install spec and no code files — instruction-only. This is low-risk from a code-installation perspective (nothing downloaded or written by the skill itself).
Credentials
The skill declares no required environment variables or primary credential, yet it defers auth to '../gws-shared/SKILL.md'. That external doc will likely require Google auth (tokens, OAuth client, or service account keys). Because those credentials are not declared here, it's unclear what secrets the agent will need or access, making the credential footprint indeterminate.
Persistence & Privilege
The skill is not always-enabled and does not request elevated persistence. Autonomous invocation is allowed (default) but that is expected; there is no evidence it modifies other skill configs or system-wide settings.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install gws-sheets-read - 安装完成后,直接呼叫该 Skill 的名称或使用
/gws-sheets-read触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.13
- Bumped metadata version from 0.22.4 to 0.22.5 in SKILL.md.
v1.0.12
- Bumped skill version metadata from 0.22.3 to 0.22.4 in SKILL.md.
- No functional or documentation changes made.
v1.0.11
- Updated metadata version from 0.22.2 to 0.22.3 in SKILL.md.
- No other functional or content changes.
v1.0.10
- Updated skill metadata version from 0.22.1 to 0.22.2 in SKILL.md.
- No other content changes.
v1.0.9
- Updated skill metadata version from 0.22.0 to 0.22.1 in SKILL.md.
- No other functional or documentation changes.
v1.0.8
- Updated version number to 0.22.0 in metadata.
- No changes to features, usage, or documentation content.
v1.0.7
- Updated metadata version in SKILL.md from 0.21.1 to 0.21.2.
- No other content changes were made.
v1.0.6
- Updated version number in SKILL.md to 0.21.1.
- No functional changes; documentation versioning aligned.
v1.0.5
- Metadata version updated from 0.20.0 to 0.20.1 in SKILL.md.
- No other content changes.
v1.0.4
- Updated version metadata from 0.19.0 to 0.20.0 in SKILL.md.
v1.0.3
- Updated version information and metadata format in SKILL.md
- Version field moved under metadata and set to 0.19.0
- Removed top-level version field from SKILL.md
- No changes to core functionality or usage instructions
v1.0.2
- Updated the formatting of the "requires" field in SKILL.md for consistency.
- No functional or user-facing changes.
v1.0.1
- Fixed usage example to use double quotes around the range argument.
- No functional or feature changes; documentation only.
v1.0.0
Initial release of gws-sheets-read.
- Read values from a Google Spreadsheet using the command line.
- Requires spreadsheet ID and range parameters.
- Read-only access; does not modify any data.
- Includes CLI help and usage examples.
- Integrates with gws-shared for authentication and global flags.
元数据
常见问题
Gws Sheets Read 是什么?
Google Sheets: Read values from a spreadsheet. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 549 次。
如何安装 Gws Sheets Read?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install gws-sheets-read」即可一键安装,无需额外配置。
Gws Sheets Read 是免费的吗?
是的,Gws Sheets Read 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Gws Sheets Read 支持哪些平台?
Gws Sheets Read 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Gws Sheets Read?
由 googleworkspace-bot(@googleworkspace-bot)开发并维护,当前版本 v1.0.13。
推荐 Skills