← 返回 Skills 市场

Gmail Label Routing

Name: Gmail Label Routing
Author: 1u1s4

作者 Luis Alvarado · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

329

总下载

当前安装

版本数

在 OpenClaw 中安装

/install gmail-label-routing

功能描述

Configurar en Gmail el enrutamiento por remitente hacia etiquetas usando el workflow local `scripts/gws_gmail_label_workflow.py`, incluyendo crear/usar etiqu...

使用说明 (SKILL.md)

Gmail Label Routing

Overview

Estandarizar cambios de etiquetas por remitente en Gmail con un flujo único y consistente. Priorizar el script local para evitar inconsistencias manuales entre filtro, retroaplicación y estado de INBOX.

Workflow

Confirmar intención del usuario:

Etiqueta destino
Uno o varios remitentes
Si debe salir de INBOX (default: sí)
Si debe reemplazar filtros existentes del remitente (solo cuando lo pida o haya conflictos)

Ejecutar el workflow:

python3 scripts/gws_gmail_label_workflow.py \
  --label "\x3CEtiqueta>" \
  --sender "[email protected]" \
  --sender "[email protected]"

scripts/gws_gmail_label_workflow.py es ruta relativa al directorio de esta skill.

Variantes comunes:

Mantener en INBOX: --keep-inbox
Reemplazar filtros del remitente: --replace-sender-filters
Simular sin cambios: --dry-run

Confirmar resultado con el JSON final del script:

createdFilterId
retroApplied
withLabelCount
inboxCount

Rules

Repetir --sender por cada remitente.
Mantener comillas en etiqueta y remitentes para evitar errores de parsing.
Usar --replace-sender-filters cuando haya mezcla por reglas duplicadas para el mismo remitente.
Si el usuario dice “haz lo mismo”, repetir el mismo patrón usado: etiqueta + filtro + retroactivo + manejo de INBOX.
Si hay fallo de scopes en gws para filtros, usar el fallback ya implementado dentro del workflow (credenciales OAuth locales).

Reference

Ver ejemplos listos en references/commands.md.

安全使用建议

This skill will run a local Python script that: (1) calls a 'gws' command-line tool, (2) reads OAuth credential files (looks for /root/.config/gws/credentials*.json by default), and (3) exchanges refresh tokens with oauth2.googleapis.com and calls gmail.googleapis.com. Before installing or running it: 1) Verify you have (or want) the 'gws' CLI and that it's safe to use. 2) Inspect the credentials files it will read and avoid running it as root — prefer providing an explicit --credentials-file pointing to a dedicated OAuth credential file for this purpose. 3) Ask the skill author to update metadata and SKILL.md to declare required binaries and credential paths. 4) If you cannot audit the credentials file, run the script in an isolated/test account or VM. The behavior is coherent with Gmail label management, but the undeclared access to local OAuth files and reliance on an external CLI are important red flags that justify caution.

功能分析

Type: OpenClaw Skill Name: gmail-label-routing Version: 1.0.0 The skill provides a legitimate workflow for automating Gmail label creation and filter routing based on sender addresses. It utilizes a Python script (scripts/gws_gmail_label_workflow.py) that interacts with the Gmail API via standard OAuth2 refresh flows and a local 'gws' CLI tool. While the script accesses sensitive credentials in /root/.config/gws/ and performs batch message modifications, these actions are transparently documented and directly support the stated functionality without evidence of exfiltration or unauthorized access.

能力评估

⚠ Purpose & Capability

The skill claims to be an instruction-only Gmail workflow, but the included script invokes an external CLI ('gws') for Gmail operations and expects local OAuth credential files. The registry metadata lists no required binaries or credentials, which is inconsistent with what the script actually needs.

⚠ Instruction Scope

SKILL.md instructs the agent to run the local script but does not disclose that the script will: a) call the 'gws' CLI via subprocess, b) read local OAuth credential files (defaulting to /root/.config/gws/credentials*.json), and c) call Google endpoints (oauth2.googleapis.com and gmail.googleapis.com). Those file reads and subprocess calls are not documented in SKILL.md.

✓ Install Mechanism

No install spec is provided (instruction-only), so nothing is written to disk by the installer. The risk comes from the bundled script's runtime behavior rather than an installation step.

⚠ Credentials

Registry metadata declares no required env vars or credentials, but the script requires OAuth credentials (client_id, client_secret, refresh_token) from local files and depends on the 'gws' CLI being present. Accessing files under /root/.config/gws is sensitive and not justified in the metadata or SKILL.md.

✓ Persistence & Privilege

The skill is not always-enabled and does not request elevated platform persistence. It does not appear to modify other skills or system-wide settings.

如何使用

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

版本历史

v1.0.0

Initial release: consistent sender-to-label routing workflow for Gmail

元数据

Slug gmail-label-routing

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题