← Back to Skills Marketplace
Voice2notion
by
JiabaoChen1
· GitHub ↗
· v1.2.0
· MIT-0
315
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install voice2notion
Description
语音录音转录并保存到 Notion 数据库。使用 faster-whisper 转录，自动提取关键信息并写入数据库。
Usage Guidance
Summary and actionable checks before installing:
- Metadata mismatch: SKILL.md requires a Notion API key file (~/.config/notion/api_key) and NOTION_DATABASE_ID, but the registry metadata lists no required env/configs. Treat this as a packaging error—confirm required files/env vars before trusting automation.
- Verify 'uv' usage: The instructions call 'uv venv' and 'uv pip install'. If you don't know what 'uv' is (it is not a standard tool), do not run those commands. Replace them with standard virtualenv and pip commands (python3 -m venv, pip install) or confirm the 'uv' tool is legitimate.
- API key handling: The guide recommends saving the Notion API key in a plaintext file. Prefer using an environment variable with appropriate process/file permissions or a secrets manager. Do not commit the file to any repository. Rotate the key if it's exposed.
- Data privacy: The documentation suggests using public URLs for audio files. That can leak sensitive audio. Use private/authenticated storage (or Notion's supported file upload methods) if the recordings are sensitive.
- Model downloads and resource use: faster-whisper will download models (hundreds of MB to >1GB) and may be CPU/GPU intensive. Ensure you have bandwidth and storage.
- Test manually first: Run the provided commands locally in an isolated virtualenv with a non-production Notion integration and a test database to confirm behavior. Inspect any automation/agent steps before granting it access to your Notion credentials.
If you want, I can: a) extract the exact commands to run safely without 'uv'; b) show a safer pattern for storing/consuming the Notion API key; or c) suggest how to modify the SKILL.md to make metadata consistent.
Capability Analysis
Type: OpenClaw Skill
Name: voice2notion
Version: 1.2.0
The skill 'voice2notion' is a legitimate utility designed to transcribe audio files using the 'faster-whisper' library and upload the results to a Notion database. The instructions in SKILL.md and the configuration requirements (Notion API key and Database ID) are consistent with the stated purpose, and no evidence of malicious intent, data exfiltration, or prompt injection was found.
Capability Assessment
Purpose & Capability
The skill's stated purpose (audio → transcription → Notion) is coherent with the runtime instructions which install faster-whisper, transcribe audio, and push records to a Notion database. However, registry metadata says 'required env vars: none' and 'required config paths: none' while SKILL.md explicitly requires a local Notion API key file (~/.config/notion/api_key) and the NOTION_DATABASE_ID env var. This metadata/instruction mismatch is a sign of sloppy packaging and should be resolved before trusting automation.
Instruction Scope
SKILL.md instructions stay within the transcription→Notion workflow, showing the exact Python snippet, model choices, and how to store/upload audio links. Concerns: instructions reference 'uv' commands (uv venv, uv pip) and a ~/.openclaw path which are not declared in registry requirements — the agent or user environment may not have 'uv' and the behavior of 'uv' is unspecified. The doc also recommends placing audio on publicly accessible URLs for Notion links, which is a privacy/data-leak risk (but is functionally coherent).
Install Mechanism
This is instruction-only (no install spec in registry), so nothing is automatically written by the skill. SKILL.md asks the user to create a virtualenv and run 'pip install faster-whisper' and warns the model will be downloaded (~140MB–1GB+ depending on model). That manual installation is reasonable for this task, but users should be aware of large model downloads and network traffic. The 'uv pip install' usage is unusual and not explained; confirm what 'uv' does before running.
Credentials
The only runtime secret needed is the Notion API Key and a Notion database ID, which are proportionate to the purpose. But the skill recommends storing the API key in plaintext at ~/.config/notion/api_key (and also using an env var), and the registry metadata failed to declare these requirements. The combination of undeclared secret usage and plaintext local storage is a security/privacy concern that should be addressed (use secure secret storage, file permissions, or env vars).
Persistence & Privilege
The skill does not request always:true, does not include install-time code, and is instruction-only. It doesn't request elevated privileges or modify other skills' configs. Persistence and privilege level are appropriate for an offline transcription→Notion workflow.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install voice2notion - After installation, invoke the skill by name or use
/voice2notion - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
voice2notion 1.2.0 重大更新：内置 faster-whisper 实现端到端语音自动转录，并完善使用说明。
- 集成 faster-whisper，支持语音录音自动转文字，无需外部转录工具
- 新增详细安装与配置指导，包含模型选择和依赖说明
- 更新描述与功能说明，包括模型体积、推荐型号等
- tags 优化，强调语音转录和模型类型
- 保持 Notion 数据库接入方式不变，原有功能不受影响
v1.1.0
- Removed built-in voice transcription feature; transcription must now be done with external services.
- Simplified installation: no longer requires installing faster-whisper or related dependencies.
- Updated documentation to clarify workflow and dependency changes.
- Adjusted tags and description to reflect the new focus on Notion integration and manual transcription.
- Kept all original Notion database integration and file upload instructions.
v1.0.3
- Added instructions for saving and linking audio files in Notion.
- Introduced required "录音链接" (audio link) URL field in the recommended Notion database.
- Updated workflow description to include saving audio file links.
- Expanded database schema documentation to support the new audio link feature.
v1.0.2
- Added a recommended Notion template section with a pre-built database and instructions to copy it, making setup easier.
- Provided clearer steps for obtaining the Notion database ID from the template.
- No changes to code or functionality; documentation improved for faster onboarding and reduced setup errors.
v1.0.1
- Added explicit installation and configuration instructions, including virtual environment setup and dependency installation.
- Introduced structured config options for Notion API Key and Database ID.
- Clarified and expanded documentation for Notion API integration steps and database sharing.
- Detailed database column requirements and provided a troubleshooting section for common errors.
- Improved workflow explanations and security notes for API keys and environment management.
v1.0.0
Initial release of voice2notion.
- Transcribe voice recordings using faster-whisper and save results to a Notion database.
- Automatically extract and refine key information from the transcription, mapping to specific Notion database fields.
- Support for user configuration of Notion API key and database schema.
- Provides step-by-step workflow, including transcription, content enhancement, and Notion integration scripts.
- Includes clear setup instructions for required Notion database columns and API usage.
Metadata
Frequently Asked Questions
What is Voice2notion?
语音录音转录并保存到 Notion 数据库。使用 faster-whisper 转录，自动提取关键信息并写入数据库。 It is an AI Agent Skill for Claude Code / OpenClaw, with 315 downloads so far.
How do I install Voice2notion?
Run "/install voice2notion" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Voice2notion free?
Yes, Voice2notion is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Voice2notion support?
Voice2notion is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Voice2notion?
It is built and maintained by JiabaoChen1 (@jiabaochen1); the current version is v1.2.0.
More Skills