# Send voice-email to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/voice-email",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-email",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SETUP.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "voice-email",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T22:38:50.507Z",
      "expiresAt": "2026-05-08T22:38:50.507Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-email",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-email",
        "contentDisposition": "attachment; filename=\"voice-email-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "voice-email"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### Voice Email Skill

Send emails using natural voice commands. Perfect for accessibility use cases.

### What It Does

When you receive a voice message, parse and send an email:

Input format:

new email to [recipient], subject [subject], body [body], send

Examples:

"new email to john@example.com, subject Hello, body How are you doing, send"
"send email to mom@gmail.com, subject Dinner, body See you at 7pm, send"

### What This Skill CANNOT Do

❌ Execute arbitrary code
❌ Access files outside of logging/debugging
❌ Modify system files
❌ Access other accounts without explicit OAuth
❌ Send emails to unknown recipients without user confirmation

### Prerequisites

This skill requires:

gogcli - Google CLI for Gmail (must be installed separately)
Deepgram - For voice transcription (API key required)
Telegram bot - For receiving voice messages (already configured in OpenClaw)
ElevenLabs - Optional, for voice responses (not required)

### Install gogcli (once, manually)

Option A - via npm (recommended):

npm install -g gogcli

Option B - via binary (verify source):
Download from https://gogcli.ai and verify the binary

Then authenticate:

gog auth add your-email@gmail.com

### Configure Deepgram (REQUIRED)

Add to openclaw.json:

{
  "tools": {
    "media": {
      "audio": {
        "enabled": true,
        "models": [{"provider": "deepgram", "model": "nova-3"}]
      }
    }
  },
  "env": {
    "DEEPGRAM_API_KEY": "your-deepgram-key"
  }
}

### Configure ElevenLabs (OPTIONAL)

For voice responses, add to openclaw.json:

{
  "messages": {
    "tts": {
      "auto": "always",
      "provider": "elevenlabs",
      "elevenlabs": {
        "apiKey": "YOUR_ELEVENLABS_KEY",
        "voiceId": "YOUR_VOICE_ID"
      }
    }
  }
}

Without ElevenLabs, text responses still work.

### Usage

Simply send a voice message with the command. The agent will:

Transcribe it (via Deepgram)
Parse the fields
Send the email (via gogcli)
Confirm via text (or voice if ElevenLabs configured)

### Command Parser

The agent extracts:

to: Email address (after "to", "email to", "send to")
subject: Text after "subject"
body: Text after "body" (before "send")

### Environment Variables

VariableRequiredDescriptionDEEPGRAM_API_KEYYesFor voice transcriptionELEVENLABS_API_KEYNoFor voice responsesELEVENLABS_VOICE_IDNoVoice to use

### Security Notes

Network: Requires access to Telegram API, Deepgram API, Gmail API
Credentials:

gogcli stores OAuth tokens in system keyring
Deepgram key in openclaw.json (or environment)
ElevenLabs key in openclaw.json (optional)


Data: Voice recordings processed by Deepgram, emails sent via user's Gmail
Privilege: Modifies openclaw.json to enable media/audio
Does NOT: Execute arbitrary code, access unrelated files, or modify system

### Best Practices for Production

Use test accounts: Create dedicated Gmail account for testing
Limit Gmail OAuth: Use app-specific passwords if needed
Scope Deepgram: Use minimal quota for testing
Review logs: Check /tmp/openclaw-*.log for unexpected activity
Backup config: cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

### Uninstall

clawhub uninstall voice-email

Then remove API keys from openclaw.json if desired.

### Validation / Testing

To verify the skill is working:

Test Deepgram directly:

curl -X POST "https://api.deepgram.com/v1/listen" \\
  -H "Authorization: Token $DEEPGRAM_API_KEY" \\
  -H "Content-Type: audio/ogg" \\
  --data-binary @sample.ogg

Test gogcli:

gog auth status
gog gmail send --to "your-email@gmail.com" --subject "Test" --body "Working!"

Send a voice message on Telegram:
"new email to your-email@gmail.com, subject test, body hello, send"
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Sundiver1
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T22:38:50.507Z
- Expires at: 2026-05-08T22:38:50.507Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/voice-email)
- [Send to Agent page](https://openagent3.xyz/skills/voice-email/agent)
- [JSON manifest](https://openagent3.xyz/skills/voice-email/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/voice-email/agent.md)
- [Download page](https://openagent3.xyz/downloads/voice-email)