Voice Note Transcriber — 语音笔记转录员

语音笔记转录器 → Obsidian 从 IMAP 中获取语音笔记邮件，使用 OpenAI Whisper 转录音频附件，并将结果保存为 Obsidian 储存库中的临时笔记。 快速开始 python3 {skillDir}/scripts/transcribe_voice_notes.py 配置 设置环境变量（或让技能从 OpenClaw 配置中读取）： 变量 必需 描述 EMAIL_ADDRESS √ IMAP 登录地址 EMAIL_PASSWORD √ 应用程序特定密码 OPENAI_API_KEY √ OpenAI API 密钥 OBSIDIAN_VAULT_PATH √ Obsidian 储存库根目录的绝对路径 EMAIL_PROVIDER 提供商密钥：gmail（默认）、outlook、163.com、126.com FLEETING_FOLDER 储存库中临时笔记的子文件夹（默认：0-Inbox） VOICE_NOTE_KEYWORD 主题过滤关键字（默认：Voice Note） MARK_EMAIL_READ true / false（默认：true） OpenClaw 配置示例 { skills: { "voice-note-transcriber": { obsidianVaultPath: "/home/user/Documents/MyVault", fleetingFolder: "0-Inbox", emailProvider: "gmail", subjectKeyword: "Voice Note", markEmailRead: true, }, }, } 它的作用 连接到 IMAP 并获取包含配置关键字的未读邮件的主题。 下载音频附件（.mp3、.wav、.m4a、.webm、.ogg、.flac）到临时目录。 通过 OpenAI Whisper API（whisper-1）转录每个附件。 将带有 YAML 前置内容的 Markdown 笔记写入储存库的临时文件夹。 可选地将源邮件标记为已读。 输出笔记格式 --- 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

转录内容（转录文本在此）

源

• 主题： Voice Note — weekly recap
• 来自： sender@example.com
• 日期： Mon, 12 May 2025 08:00:00 +0800

故障排除 症状 解决方案 "缺少 OPENAI_API_KEY" 导出 OPENAI_API_KEY 或在 OpenClaw 配置中设置 笔记未出现在 Obsidian 中 检查 OBSIDIAN_VAULT_PATH 是否为储存库根目录（而不是子文件夹），并且 FLEETING_FOLDER 存在于其中 未找到电子邮件 验证 EMAIL_PROVIDER、凭据和 VOICE_NOTE_KEYWORD 是否与您的邮箱匹配 附件未转录 确保附件具有识别的音频扩展名 发布到 ClawHub clawhub publish ~/.openclaw/skills/voice-note-transcriber \ --slug voice-note-transcriber \ --name "Voice Note Transcriber" \ --version 1.0.0 \ --changelog "Initial release"