通过 IMAP 获取语音邮件，调用 OpenAI Whisper 转录附件，存入 Obsidian 临时笔记文件夹。
语音调音符 → Obsidian. 图像调音符 IMAP的电子邮件, 将音频附件转录到 OpenAI. 11.
功能概述
语音调音符 → Obsidian. 图像调音符 IMAP的电子邮件, 将音频附件转录到 OpenAI. 11.是一项面向实际任务的技能，主要用于Whisper, 并将结果保存为您 Obsidian 库中的即时调音符；@ @ info。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
使用与执行
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
Voice Note Transcriber → Obsidian
通过 IMAP 获取语音备忘邮件，使用 OpenAI Whisper 转录音频附件，并将结果保存为 Obsidian 仓库中的临时笔记（fleeting note）。
快速开始
python3 {skillDir}/scripts/transcribe_voice_notes.py
配置
设置环境变量（或让该技能从 OpenClaw 配置中读取）：
| 变量 | 必需 | 说明 |
|---|---|---|
EMAIL_ADDRESS |
✅ | IMAP 登录邮箱地址 |
EMAIL_PASSWORD |
✅ | 应用专用密码（App-specific 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 前置元数据（frontmatter）的 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 ## Transcript (transcribed text here) ## Source - **Subject:** Voice Note — weekly recap - **From:** sender@example.com - **Date:** Mon, 12 May 2025 08:00:00 +0800
故障排查
| 现象 | 解决方法 |
|---|---|
| “Missing 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"
热门AI工具
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
0
2026.10.28
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
0
2026.10.28
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
0
2026.10.28
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.6万人学习
共6课时 | 54.7万人学习
最新文章
