← 返回 Skills 市场
googleworkspace-bot

Gws Gmail Read

作者 googleworkspace-bot · GitHub ↗ · v1.0.12 · MIT-0
cross-platform ⚠ suspicious
390
总下载
0
收藏
1
当前安装
13
版本数
在 OpenClaw 中安装
/install gws-gmail-read
功能描述
Gmail: Read a message and extract its body or headers.
使用说明 (SKILL.md)

gmail +read

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Read a message and extract its body or headers

Usage

gws gmail +read --id \x3CID>

Flags

Flag Required Default Description
--id The Gmail message ID to read
--headers Include headers (From, To, Subject, Date) in the output
--format text Output format (text, json)
--html Return HTML body instead of plain text
--dry-run Show the request that would be sent without executing it

Examples

gws gmail +read --id 18f1a2b3c4d
gws gmail +read --id 18f1a2b3c4d --headers
gws gmail +read --id 18f1a2b3c4d --format json | jq '.body'

Tips

  • Converts HTML-only messages to plain text automatically.
  • Handles multipart/alternative and base64 decoding.

See Also

安全使用建议
This skill itself is just documentation for the 'gws' CLI, but it defers authentication details to ../gws-shared/SKILL.md which is not included or declared. Before installing or enabling: (1) locate and read the referenced gws-shared SKILL.md to see exactly how credentials are provided and what env vars or config paths are used; (2) verify the 'gws' binary is trusted and from a reputable source; (3) confirm the OAuth/service-account scopes and ensure least privilege (only read-mail if that's all you need); (4) ensure the agent will not be granted broad filesystem access that would expose other credentials; (5) if you cannot inspect the referenced shared file or the gws client, treat this as a red flag and do not enable the skill. If you want higher assurance, request the publisher to include explicit declarations of required env vars/config paths and to bundle or reference a verified gws release URL.
功能分析
Type: OpenClaw Skill Name: gws-gmail-read Version: 1.0.12 The skill bundle provides a standard interface for reading Gmail messages using the 'gws' CLI tool. The documentation in SKILL.md and metadata in _meta.json are consistent with the stated purpose of extracting email bodies and headers, with no evidence of malicious instructions, data exfiltration, or suspicious execution patterns.
能力评估
Purpose & Capability
The declared purpose (read Gmail) matches the required binary 'gws' and the runtime examples. However the SKILL.md points to ../gws-shared/SKILL.md for auth/global flags; the registry metadata lists no required env vars or config paths. That is an inconsistency: authentication requirements are implied but not declared.
Instruction Scope
The instructions themselves simply call the gws CLI to read a message, which is in-scope. But they explicitly instruct the agent to read an external file (../gws-shared/SKILL.md) for auth and security rules. That external dependency is not present in the package metadata and may contain instructions to access credentials, config paths, or other system state — the runtime behavior is therefore underspecified and potentially broader than advertised.
Install Mechanism
This is an instruction-only skill with no install spec and no code files. Nothing is written to disk by the skill itself. Risk depends on the external 'gws' binary (not supplied here) rather than the skill bundle.
Credentials
The skill declares no required environment variables or credentials, yet it depends on authentication provided by a separate shared SKILL.md. Expect that OAuth tokens, service-account keys, or other credentials are required in practice; those credentials are not documented in this skill, which is disproportionate and opaque.
Persistence & Privilege
The skill does not request always:true, does not modify other skills' configs in the bundle, and is user-invocable only. Autonomous invocation is allowed (platform default) but there is no extra persistence or elevated privilege declared by this skill itself.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install gws-gmail-read
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /gws-gmail-read 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.12
- Updated version in SKILL.md metadata from 0.22.4 to 0.22.5.
v1.0.11
- Bumped version in SKILL.md metadata from 0.22.3 to 0.22.4.
v1.0.10
- Updated skill version number in documentation from 0.22.2 to 0.22.3 in SKILL.md. - No changes to command usage or features.
v1.0.9
- Updated skill version from 0.22.1 to 0.22.2 in documentation. - No functional or usage changes; documentation version bump only.
v1.0.8
- Updated version metadata from 0.22.0 to 0.22.1 in SKILL.md. - No changes to features, usage, flags, or documentation content.
v1.0.7
- Bumped skill version to 0.22.0 in metadata (was 0.21.2). - No other content or usage changes.
v1.0.6
- Updated skill version in documentation from 0.21.1 to 0.21.2. - No changes to usage, options, or functionality documented. - Documentation content and examples remain unchanged.
v1.0.5
- Updated skill version from 0.20.1 to 0.21.1 in SKILL.md.
v1.0.4
- Updated skill version from 0.20.0 to 0.20.1 in documentation. - No functional or usage changes; documentation version bump only.
v1.0.3
- Bumped version from 0.19.0 to 0.20.0 in metadata. - No changes to features, usage, flags, or documentation content.
v1.0.2
- Updated version metadata format and moved version under the metadata section. - No functional changes; documentation formatting and metadata structure improved for consistency.
v1.0.1
No functional changes; SKILL.md formatting updated. - Metadata "requires" list reformatted to YAML array style for consistency. - No changes to usage, flags, or functionality.
v1.0.0
- Initial release of gws-gmail-read. - Enables reading Gmail messages by message ID. - Supports extracting message body or headers, with options for text or HTML output. - Includes flags for custom output format, including JSON and dry-run mode. - Automatically converts HTML-only messages to plain text and handles multipart and base64 decoding. - Documentation covers usage, flags, and example commands.
元数据
Slug gws-gmail-read
版本 1.0.12
许可证 MIT-0
累计安装 2
当前安装数 1
历史版本数 13
常见问题

Gws Gmail Read 是什么?

Gmail: Read a message and extract its body or headers. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 390 次。

如何安装 Gws Gmail Read?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install gws-gmail-read」即可一键安装,无需额外配置。

Gws Gmail Read 是免费的吗?

是的,Gws Gmail Read 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Gws Gmail Read 支持哪些平台?

Gws Gmail Read 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Gws Gmail Read?

由 googleworkspace-bot(@googleworkspace-bot)开发并维护,当前版本 v1.0.12。

💬 留言讨论