Voice Note Transcriber → Obsidian

通过 IMAP 获取语音备忘邮件，使用 OpenAI Whisper 转录音频附件，并将结果保存为 Obsidian 仓库中的临时笔记（fleeting note）。

快速开始

python3 {skillDir}/scripts/transcribe_voice_notes.py

配置

设置环境变量（或让该技能从 OpenClaw 配置中读取）：

OpenClaw 配置示例

{
  skills: {
    "voice-note-transcriber": {
      obsidianVaultPath: "/home/user/Documents/MyVault",
      fleetingFolder: "0-Inbox",
      emailProvider: "gmail",
      subjectKeyword: "Voice Note",
      markEmailRead: true,
    },
  },
}

功能说明

1. 连接 IMAP 服务器，获取主题中包含指定关键词的未读邮件。
2. 将音频附件（支持格式：.mp3、.wav、.m4a、.webm、.ogg、.flac）下载至临时目录。
3. 调用 OpenAI Whisper API（模型：whisper-1）逐个转录音频附件。
4. 在仓库的临时笔记文件夹中生成带 YAML 前置元数据（frontmatter）的 Markdown 笔记。
5. 可选：将原始邮件标记为已读。

输出笔记格式

---
tags:
  - type/transcript
  - source/voice-note
date: 2025-05-12
email_subject: "Voice Note — weekly recap"
email_from: sender@example.com
---

# Voice Note Transcript — 2025-05-12

## Transcript

(transcribed text here)

## Source

- **Subject:** Voice Note — weekly recap
- **From:** sender@example.com
- **Date:** Mon, 12 May 2025 08:00:00 +0800

故障排查

发布到 ClawHub

clawhub publish ~/.openclaw/skills/voice-note-transcriber 
  --slug voice-note-transcriber 
  --name "Voice Note Transcriber" 
  --version 1.0.0 
  --changelog "Initial release"