{
  "schemaVersion": "1.0",
  "item": {
    "slug": "voice-email",
    "name": "voice-email",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/Sundiver1/voice-email",
    "canonicalUrl": "https://clawhub.ai/Sundiver1/voice-email",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/voice-email",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-email",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SETUP.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. 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. 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-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.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/voice-email"
    },
    "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/voice-email",
    "agentPageUrl": "https://openagent3.xyz/skills/voice-email/agent",
    "manifestUrl": "https://openagent3.xyz/skills/voice-email/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/voice-email/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Voice Email Skill",
        "body": "Send emails using natural voice commands. Perfect for accessibility use cases."
      },
      {
        "title": "What It Does",
        "body": "When you receive a voice message, parse and send an email:\n\nInput format:\n\nnew email to [recipient], subject [subject], body [body], send\n\nExamples:\n\n\"new email to john@example.com, subject Hello, body How are you doing, send\"\n\"send email to mom@gmail.com, subject Dinner, body See you at 7pm, send\""
      },
      {
        "title": "What This Skill CANNOT Do",
        "body": "❌ Execute arbitrary code\n❌ Access files outside of logging/debugging\n❌ Modify system files\n❌ Access other accounts without explicit OAuth\n❌ Send emails to unknown recipients without user confirmation"
      },
      {
        "title": "Prerequisites",
        "body": "This skill requires:\n\ngogcli - Google CLI for Gmail (must be installed separately)\nDeepgram - For voice transcription (API key required)\nTelegram bot - For receiving voice messages (already configured in OpenClaw)\nElevenLabs - Optional, for voice responses (not required)"
      },
      {
        "title": "Install gogcli (once, manually)",
        "body": "Option A - via npm (recommended):\n\nnpm install -g gogcli\n\nOption B - via binary (verify source):\nDownload from https://gogcli.ai and verify the binary\n\nThen authenticate:\n\ngog auth add your-email@gmail.com"
      },
      {
        "title": "Configure Deepgram (REQUIRED)",
        "body": "Add to openclaw.json:\n\n{\n  \"tools\": {\n    \"media\": {\n      \"audio\": {\n        \"enabled\": true,\n        \"models\": [{\"provider\": \"deepgram\", \"model\": \"nova-3\"}]\n      }\n    }\n  },\n  \"env\": {\n    \"DEEPGRAM_API_KEY\": \"your-deepgram-key\"\n  }\n}"
      },
      {
        "title": "Configure ElevenLabs (OPTIONAL)",
        "body": "For voice responses, add to openclaw.json:\n\n{\n  \"messages\": {\n    \"tts\": {\n      \"auto\": \"always\",\n      \"provider\": \"elevenlabs\",\n      \"elevenlabs\": {\n        \"apiKey\": \"YOUR_ELEVENLABS_KEY\",\n        \"voiceId\": \"YOUR_VOICE_ID\"\n      }\n    }\n  }\n}\n\nWithout ElevenLabs, text responses still work."
      },
      {
        "title": "Usage",
        "body": "Simply send a voice message with the command. The agent will:\n\nTranscribe it (via Deepgram)\nParse the fields\nSend the email (via gogcli)\nConfirm via text (or voice if ElevenLabs configured)"
      },
      {
        "title": "Command Parser",
        "body": "The agent extracts:\n\nto: Email address (after \"to\", \"email to\", \"send to\")\nsubject: Text after \"subject\"\nbody: Text after \"body\" (before \"send\")"
      },
      {
        "title": "Environment Variables",
        "body": "VariableRequiredDescriptionDEEPGRAM_API_KEYYesFor voice transcriptionELEVENLABS_API_KEYNoFor voice responsesELEVENLABS_VOICE_IDNoVoice to use"
      },
      {
        "title": "Security Notes",
        "body": "Network: Requires access to Telegram API, Deepgram API, Gmail API\nCredentials:\n\ngogcli stores OAuth tokens in system keyring\nDeepgram key in openclaw.json (or environment)\nElevenLabs key in openclaw.json (optional)\n\n\nData: Voice recordings processed by Deepgram, emails sent via user's Gmail\nPrivilege: Modifies openclaw.json to enable media/audio\nDoes NOT: Execute arbitrary code, access unrelated files, or modify system"
      },
      {
        "title": "Best Practices for Production",
        "body": "Use test accounts: Create dedicated Gmail account for testing\nLimit Gmail OAuth: Use app-specific passwords if needed\nScope Deepgram: Use minimal quota for testing\nReview logs: Check /tmp/openclaw-*.log for unexpected activity\nBackup config: cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak"
      },
      {
        "title": "Uninstall",
        "body": "clawhub uninstall voice-email\n\nThen remove API keys from openclaw.json if desired."
      },
      {
        "title": "Validation / Testing",
        "body": "To verify the skill is working:\n\nTest Deepgram directly:\n\ncurl -X POST \"https://api.deepgram.com/v1/listen\" \\\n  -H \"Authorization: Token $DEEPGRAM_API_KEY\" \\\n  -H \"Content-Type: audio/ogg\" \\\n  --data-binary @sample.ogg\n\nTest gogcli:\n\ngog auth status\ngog gmail send --to \"your-email@gmail.com\" --subject \"Test\" --body \"Working!\"\n\nSend a voice message on Telegram:\n\"new email to your-email@gmail.com, subject test, body hello, send\""
      }
    ],
    "body": "Voice Email Skill\n\nSend emails using natural voice commands. Perfect for accessibility use cases.\n\nWhat It Does\n\nWhen you receive a voice message, parse and send an email:\n\nInput format:\n\nnew email to [recipient], subject [subject], body [body], send\n\n\nExamples:\n\n\"new email to john@example.com, subject Hello, body How are you doing, send\"\n\"send email to mom@gmail.com, subject Dinner, body See you at 7pm, send\"\nWhat This Skill CANNOT Do\n❌ Execute arbitrary code\n❌ Access files outside of logging/debugging\n❌ Modify system files\n❌ Access other accounts without explicit OAuth\n❌ Send emails to unknown recipients without user confirmation\nPrerequisites\n\nThis skill requires:\n\ngogcli - Google CLI for Gmail (must be installed separately)\nDeepgram - For voice transcription (API key required)\nTelegram bot - For receiving voice messages (already configured in OpenClaw)\nElevenLabs - Optional, for voice responses (not required)\nInstall gogcli (once, manually)\n\nOption A - via npm (recommended):\n\nnpm install -g gogcli\n\n\nOption B - via binary (verify source): Download from https://gogcli.ai and verify the binary\n\nThen authenticate:\n\ngog auth add your-email@gmail.com\n\nConfigure Deepgram (REQUIRED)\n\nAdd to openclaw.json:\n\n{\n  \"tools\": {\n    \"media\": {\n      \"audio\": {\n        \"enabled\": true,\n        \"models\": [{\"provider\": \"deepgram\", \"model\": \"nova-3\"}]\n      }\n    }\n  },\n  \"env\": {\n    \"DEEPGRAM_API_KEY\": \"your-deepgram-key\"\n  }\n}\n\nConfigure ElevenLabs (OPTIONAL)\n\nFor voice responses, add to openclaw.json:\n\n{\n  \"messages\": {\n    \"tts\": {\n      \"auto\": \"always\",\n      \"provider\": \"elevenlabs\",\n      \"elevenlabs\": {\n        \"apiKey\": \"YOUR_ELEVENLABS_KEY\",\n        \"voiceId\": \"YOUR_VOICE_ID\"\n      }\n    }\n  }\n}\n\n\nWithout ElevenLabs, text responses still work.\n\nUsage\n\nSimply send a voice message with the command. The agent will:\n\nTranscribe it (via Deepgram)\nParse the fields\nSend the email (via gogcli)\nConfirm via text (or voice if ElevenLabs configured)\nCommand Parser\n\nThe agent extracts:\n\nto: Email address (after \"to\", \"email to\", \"send to\")\nsubject: Text after \"subject\"\nbody: Text after \"body\" (before \"send\")\nEnvironment Variables\nVariable\tRequired\tDescription\nDEEPGRAM_API_KEY\tYes\tFor voice transcription\nELEVENLABS_API_KEY\tNo\tFor voice responses\nELEVENLABS_VOICE_ID\tNo\tVoice to use\nSecurity Notes\nNetwork: Requires access to Telegram API, Deepgram API, Gmail API\nCredentials:\ngogcli stores OAuth tokens in system keyring\nDeepgram key in openclaw.json (or environment)\nElevenLabs key in openclaw.json (optional)\nData: Voice recordings processed by Deepgram, emails sent via user's Gmail\nPrivilege: Modifies openclaw.json to enable media/audio\nDoes NOT: Execute arbitrary code, access unrelated files, or modify system\nBest Practices for Production\nUse test accounts: Create dedicated Gmail account for testing\nLimit Gmail OAuth: Use app-specific passwords if needed\nScope Deepgram: Use minimal quota for testing\nReview logs: Check /tmp/openclaw-*.log for unexpected activity\nBackup config: cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak\nUninstall\nclawhub uninstall voice-email\n\n\nThen remove API keys from openclaw.json if desired.\n\nValidation / Testing\n\nTo verify the skill is working:\n\nTest Deepgram directly:\ncurl -X POST \"https://api.deepgram.com/v1/listen\" \\\n  -H \"Authorization: Token $DEEPGRAM_API_KEY\" \\\n  -H \"Content-Type: audio/ogg\" \\\n  --data-binary @sample.ogg\n\nTest gogcli:\ngog auth status\ngog gmail send --to \"your-email@gmail.com\" --subject \"Test\" --body \"Working!\"\n\nSend a voice message on Telegram: \"new email to your-email@gmail.com, subject test, body hello, send\""
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Sundiver1/voice-email",
    "publisherUrl": "https://clawhub.ai/Sundiver1/voice-email",
    "owner": "Sundiver1",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/voice-email",
    "downloadUrl": "https://openagent3.xyz/downloads/voice-email",
    "agentUrl": "https://openagent3.xyz/skills/voice-email/agent",
    "manifestUrl": "https://openagent3.xyz/skills/voice-email/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/voice-email/agent.md"
  }
}