← 返回 Skills 市场

Gmail Retrieve Email

Name: Gmail Retrieve Email
Author: zvirb

作者 zvirb · GitHub ↗ · v1.0.2 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install gmail-retrieve-email

功能描述

Atomic node skill to read a specific email via Gmail using the gog CLI.

使用说明 (SKILL.md)

Lean Philosophy (Principles)

Kaizen (改善): This skill is an atomic node, broken down into its simplest, smallest component to eliminate waste and ensure perfection.
Standardized Work (Hyojun Sagyo): This node represents the most efficient, standardized path for this specific task before automation.
Jidoka (自働化): This node includes autonomous defect detection. It relies on the CLI's self-healing loop and will report errors if retrieval fails.

Gmail Retrieve Email

This skill allows the agent to retrieve the full contents of a specific email using the native CLI.

Cognitive Directives

WHEN [The contents of a specific email need to be read] THEN [Execute the native terminal command gog gmail messages get \x3CmessageId> --json]

Schema Example

{
  "command": "gog gmail messages get msg_id_123 --json"
}

Expected Output

A JSON object containing the email headers, body, and metadata.

安全使用建议

This skill simply runs your existing 'gog' CLI to fetch a single Gmail message. Before installing, confirm that 'gog' is the legitimate CLI you expect and that it's authenticated only to accounts you trust. The skill itself does not request credentials, but it will use whatever Gmail access 'gog' already has on the machine — so be mindful that retrieved emails are accessible to the agent and could be forwarded by the agent if policies allow. If you don't already have or trust 'gog' installed, do not enable this skill.

功能分析

Type: OpenClaw Skill Name: gmail-retrieve-email Version: 1.0.2 The skill is a straightforward wrapper for the 'gog' CLI tool to retrieve Gmail message content. The instructions in SKILL.md are transparent, align with the stated purpose, and do not contain any indicators of malicious intent, data exfiltration, or unauthorized execution.

能力评估

✓ Purpose & Capability

The name and description match the instructions: the skill requires the 'gog' binary and tells the agent to run 'gog gmail messages get <messageId> --json' to retrieve an email. Requiring 'gog' is expected for this purpose.

✓ Instruction Scope

SKILL.md only instructs a single explicit CLI command to get a message and expects JSON output. It does not ask to read unrelated files, environment variables, or transmit results to other endpoints.

✓ Install Mechanism

There is no install spec (instruction-only), so nothing is downloaded or written to disk by the skill itself. This is the lowest-risk install posture.

ℹ Credentials

The skill declares no env vars, which is proportionate, but it implicitly relies on the 'gog' CLI's existing authentication (local credentials/tokens). Installing or running the skill will let the 'gog' process access whatever Gmail account credentials are already configured on the host.

✓ Persistence & Privilege

The skill is not always-enabled and does not request persistent presence or modification of other skills or system settings. Autonomous invocation is allowed by default (platform behavior) but is not a unique privilege of this skill.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install gmail-retrieve-email
安装完成后，直接呼叫该 Skill 的名称或使用 /gmail-retrieve-email 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.2

- Updated to use the native gog CLI for email retrieval instead of the GoogleWorkspace plugin. - Changed requirements to depend on the gog command-line tool. - Updated instructions and schema example to reflect new CLI usage. - Revised description and error handling notes to match the cli-based approach.

v1.0.1

- Expanded OS compatibility from Windows-only to all operating systems.

v1.0.0

Initial release of Gmail Retrieve Email skill. - Retrieves the full content of a specific email message by unique ID. - Requires the google-workspace-plugin. - Outputs email details including subject, sender, recipients, body, labels, and date. - Reports errors if retrieval fails.

元数据

Slug gmail-retrieve-email

版本 1.0.2

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 3

常见问题