← Back to Skills Marketplace
Gmail Label Routing
by
Luis Alvarado
· GitHub ↗
· v1.0.0
· MIT-0
329
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install gmail-label-routing
Description
Configurar en Gmail el enrutamiento por remitente hacia etiquetas usando el workflow local `scripts/gws_gmail_label_workflow.py`, incluyendo crear/usar etiqu...
README (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.pyes 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:
createdFilterIdretroAppliedwithLabelCountinboxCount
Rules
- Repetir
--senderpor cada remitente. - Mantener comillas en etiqueta y remitentes para evitar errores de parsing.
- Usar
--replace-sender-filterscuando 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
gwspara filtros, usar el fallback ya implementado dentro del workflow (credenciales OAuth locales).
Reference
- Ver ejemplos listos en
references/commands.md.
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gmail-label-routing - After installation, invoke the skill by name or use
/gmail-label-routing - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: consistent sender-to-label routing workflow for Gmail
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 329 downloads so far.
How do I install Gmail Label Routing?
Run "/install gmail-label-routing" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gmail Label Routing free?
Yes, Gmail Label Routing is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gmail Label Routing support?
Gmail Label Routing is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gmail Label Routing?
It is built and maintained by Luis Alvarado (@1u1s4); the current version is v1.0.0.
More Skills