{ "schemaVersion": "1.0", "item": { "slug": "gmail-inbox-zero-triage", "name": "Gmail Inbox Zero Traige", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/poisondminds/gmail-inbox-zero-triage", "canonicalUrl": "https://clawhub.ai/poisondminds/gmail-inbox-zero-triage", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/gmail-inbox-zero-triage", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gmail-inbox-zero-triage", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "CLAWHUB-SUBMISSION.md", "OVERVIEW.md", "README.md", "SETUP.md", "SHARE.md", "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/gmail-inbox-zero-triage" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/gmail-inbox-zero-triage", "agentPageUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent", "manifestUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent.json", "briefUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Gmail Inbox Zero Triage", "body": "Achieve inbox zero with AI-powered email triage! Process ALL Gmail inbox messages interactively with summaries and batch actions using OAuth (no passwords needed)." }, { "title": "Features", "body": "✅ OAuth-based - No passwords, secure authentication via gog\n✅ AI summaries - Quick 1-line summary of each email\n✅ Batch processing - Queue actions instantly, execute at the end\n✅ Telegram buttons - Archive, Filter, Unsubscribe, View\n✅ Inbox zero focus - Process ALL inbox messages (read + unread)\n✅ Fast workflow - No waiting between actions" }, { "title": "Workflow", "body": "User triggers: \"Triage my emails\" or \"Process my inbox\"\nFetch ALL inbox messages from Gmail (up to 20 at a time)\nDisplay all emails at once with:\n\nSubject and sender\nAI-generated summary (1 line)\nTelegram inline buttons for actions\n\n\nUser clicks actions for each email (queued instantly, no API calls yet)\nUser clicks \"Done\" button to execute all queued actions in batch\nRepeat until inbox zero! 🎯" }, { "title": "Prerequisites", "body": "Requires: gog CLI with authenticated Gmail account.\n\nCheck if already set up:\n\ngog auth list\n\nIf not set up, user needs to run gog auth add (see gog skill for OAuth setup).\n\nSet environment variable for keyring password:\n\nexport GOG_KEYRING_PASSWORD=\"your-password\"" }, { "title": "Telegram Button Layout", "body": "Each email displays with 4 action buttons:\n\n[📥 Archive] [🔍 Filter]\n[🚫 Unsub] [📧 View]\n\n📥 Archive - Remove from inbox, mark as read\n🔍 Filter - Create filter to auto-archive future emails from sender\n🚫 Unsubscribe - Find and open unsubscribe link\n📧 View - Show full email content\nNo click = Skip (leave in inbox)\n\nAt the end:\n\n[✅ Done - Execute All Actions]" }, { "title": "Action Queue System", "body": "Actions are queued using short callback codes to avoid Telegram's 64-char limit:\n\nq:a:0 = queue archive, message index 0\nq:f:0 = queue filter, message index 0\nq:u:0 = queue unsubscribe, message index 0\nq:v:0 = view full email, message index 0 (executes immediately)\nq:done = execute all queued actions\n\nQueue is managed via scripts/queue_manager.py and stored in action_queue.json." }, { "title": "gog_processor.py", "body": "Main processor for Gmail operations via gog CLI.\n\nList inbox messages:\n\npython3 scripts/gog_processor.py list [limit]\n\nArchive a message:\n\npython3 scripts/gog_processor.py archive \n\nFind unsubscribe link:\n\npython3 scripts/gog_processor.py unsubscribe \n\nCreate filter:\n\npython3 scripts/gog_processor.py filter \"\"\n\nGet message body:\n\npython3 scripts/gog_processor.py body " }, { "title": "queue_manager.py", "body": "Manages action queue for batch execution.\n\nAdd action to queue:\n\npython3 scripts/queue_manager.py add [from_header]\n\nGet queue:\n\npython3 scripts/queue_manager.py get\n\nClear queue:\n\npython3 scripts/queue_manager.py clear" }, { "title": "execute_queue.py", "body": "Executes all queued actions in batch.\n\npython3 scripts/execute_queue.py \n\nReturns JSON with results of all executed actions." }, { "title": "Implementation Steps", "body": "Load current batch: Fetch inbox messages and save to current_batch.json\nDisplay all emails: Show each with summary and buttons\nHandle button callbacks:\n\nArchive/Filter/Unsub: Add to queue via queue_manager.py\nView: Fetch and display full email immediately\nDone: Execute queue via execute_queue.py\n\n\nShow results: Report archived count and remaining inbox count\nRepeat if needed: Fetch next batch or celebrate inbox zero" }, { "title": "AI Summary Guidelines", "body": "Generate concise 1-line summaries:\n\nReceipts/Invoices: \"Payment receipt for $X. Financial record.\"\nSecurity alerts: \"Security notification about [action]. [Important/Standard] alert.\"\nNewsletters: \"Newsletter about [topic]. No action required.\"\nCalendar: \"Calendar [event type] for [date/time].\"\nLegal: \"Legal [document type]. [Brief context].\"\n\nKeep it simple, factual, and action-oriented." }, { "title": "Security Notes", "body": "OAuth-based authentication - No passwords needed, uses gog's OAuth tokens\nTokens stored securely by gog CLI in system keychain\nRead/modify permissions - gog only gets access to what user grants\nQueue stored locally - Action queue is temporary, cleared after execution" }, { "title": "Error Handling", "body": "Common issues:\n\ngog not authenticated: Run gog auth add \nAccount not found: Check gog auth list for available accounts\nNo inbox messages: Success state - inbox zero achieved!\nPermission denied: User may need to re-authenticate with gog\nKeyring password: Set GOG_KEYRING_PASSWORD environment variable" }, { "title": "Dependencies", "body": "gog CLI - Must be installed and authenticated (see gog skill)\nPython 3 - Standard library only (subprocess, json, re, pathlib)\n\nNo additional pip packages needed." }, { "title": "Tips for Best Experience", "body": "Process regularly: Triage inbox daily to maintain inbox zero\nUse filters liberally: Auto-archive recurring newsletters and notifications\nArchive aggressively: If you don't need it now, archive it (searchable in All Mail)\nBatch mode is fast: Process 10-20 emails in under a minute\nTrust the summaries: AI summaries are accurate for quick decisions" } ], "body": "Gmail Inbox Zero Triage\n\nAchieve inbox zero with AI-powered email triage! Process ALL Gmail inbox messages interactively with summaries and batch actions using OAuth (no passwords needed).\n\nFeatures\n\n✅ OAuth-based - No passwords, secure authentication via gog\n✅ AI summaries - Quick 1-line summary of each email\n✅ Batch processing - Queue actions instantly, execute at the end\n✅ Telegram buttons - Archive, Filter, Unsubscribe, View\n✅ Inbox zero focus - Process ALL inbox messages (read + unread)\n✅ Fast workflow - No waiting between actions\n\nWorkflow\nUser triggers: \"Triage my emails\" or \"Process my inbox\"\nFetch ALL inbox messages from Gmail (up to 20 at a time)\nDisplay all emails at once with:\nSubject and sender\nAI-generated summary (1 line)\nTelegram inline buttons for actions\nUser clicks actions for each email (queued instantly, no API calls yet)\nUser clicks \"Done\" button to execute all queued actions in batch\nRepeat until inbox zero! 🎯\nPrerequisites\n\nRequires: gog CLI with authenticated Gmail account.\n\nCheck if already set up:\n\ngog auth list\n\n\nIf not set up, user needs to run gog auth add (see gog skill for OAuth setup).\n\nSet environment variable for keyring password:\n\nexport GOG_KEYRING_PASSWORD=\"your-password\"\n\nTelegram Button Layout\n\nEach email displays with 4 action buttons:\n\n[📥 Archive] [🔍 Filter]\n[🚫 Unsub] [📧 View]\n\n📥 Archive - Remove from inbox, mark as read\n🔍 Filter - Create filter to auto-archive future emails from sender\n🚫 Unsubscribe - Find and open unsubscribe link\n📧 View - Show full email content\nNo click = Skip (leave in inbox)\n\nAt the end:\n\n[✅ Done - Execute All Actions]\n\nAction Queue System\n\nActions are queued using short callback codes to avoid Telegram's 64-char limit:\n\nq:a:0 = queue archive, message index 0\nq:f:0 = queue filter, message index 0\nq:u:0 = queue unsubscribe, message index 0\nq:v:0 = view full email, message index 0 (executes immediately)\nq:done = execute all queued actions\n\nQueue is managed via scripts/queue_manager.py and stored in action_queue.json.\n\nScripts\ngog_processor.py\n\nMain processor for Gmail operations via gog CLI.\n\nList inbox messages:\n\npython3 scripts/gog_processor.py list [limit]\n\n\nArchive a message:\n\npython3 scripts/gog_processor.py archive \n\n\nFind unsubscribe link:\n\npython3 scripts/gog_processor.py unsubscribe \n\n\nCreate filter:\n\npython3 scripts/gog_processor.py filter \"\"\n\n\nGet message body:\n\npython3 scripts/gog_processor.py body \n\nqueue_manager.py\n\nManages action queue for batch execution.\n\nAdd action to queue:\n\npython3 scripts/queue_manager.py add [from_header]\n\n\nGet queue:\n\npython3 scripts/queue_manager.py get\n\n\nClear queue:\n\npython3 scripts/queue_manager.py clear\n\nexecute_queue.py\n\nExecutes all queued actions in batch.\n\npython3 scripts/execute_queue.py \n\n\nReturns JSON with results of all executed actions.\n\nImplementation Steps\nLoad current batch: Fetch inbox messages and save to current_batch.json\nDisplay all emails: Show each with summary and buttons\nHandle button callbacks:\nArchive/Filter/Unsub: Add to queue via queue_manager.py\nView: Fetch and display full email immediately\nDone: Execute queue via execute_queue.py\nShow results: Report archived count and remaining inbox count\nRepeat if needed: Fetch next batch or celebrate inbox zero\nAI Summary Guidelines\n\nGenerate concise 1-line summaries:\n\nReceipts/Invoices: \"Payment receipt for $X. Financial record.\"\nSecurity alerts: \"Security notification about [action]. [Important/Standard] alert.\"\nNewsletters: \"Newsletter about [topic]. No action required.\"\nCalendar: \"Calendar [event type] for [date/time].\"\nLegal: \"Legal [document type]. [Brief context].\"\n\nKeep it simple, factual, and action-oriented.\n\nSecurity Notes\nOAuth-based authentication - No passwords needed, uses gog's OAuth tokens\nTokens stored securely by gog CLI in system keychain\nRead/modify permissions - gog only gets access to what user grants\nQueue stored locally - Action queue is temporary, cleared after execution\nError Handling\n\nCommon issues:\n\ngog not authenticated: Run gog auth add \nAccount not found: Check gog auth list for available accounts\nNo inbox messages: Success state - inbox zero achieved!\nPermission denied: User may need to re-authenticate with gog\nKeyring password: Set GOG_KEYRING_PASSWORD environment variable\nDependencies\ngog CLI - Must be installed and authenticated (see gog skill)\nPython 3 - Standard library only (subprocess, json, re, pathlib)\n\nNo additional pip packages needed.\n\nTips for Best Experience\nProcess regularly: Triage inbox daily to maintain inbox zero\nUse filters liberally: Auto-archive recurring newsletters and notifications\nArchive aggressively: If you don't need it now, archive it (searchable in All Mail)\nBatch mode is fast: Process 10-20 emails in under a minute\nTrust the summaries: AI summaries are accurate for quick decisions" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/poisondminds/gmail-inbox-zero-triage", "publisherUrl": "https://clawhub.ai/poisondminds/gmail-inbox-zero-triage", "owner": "poisondminds", "version": "1.0.1", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage", "downloadUrl": "https://openagent3.xyz/downloads/gmail-inbox-zero-triage", "agentUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent", "manifestUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent.json", "briefUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent.md" } }