plaud-api

What This Skill Does

The Plaud API skill provides a seamless interface for interacting with your Plaud voice recorder data directly through OpenClaw. It leverages a dedicated client, plaud_client.py, to handle authentication and API communication, abstracting away the complexities of manual HTTP requests. This skill allows you to retrieve audio files, full transcripts with speaker diarization, and AI-generated summaries, enabling you to integrate your voice notes into your wider productivity workflow efficiently.

Installation

Installation requires a few manual steps to secure your credentials. First, ensure you have the required dependencies by running pip install -r ~/.claude/skills/plaud-api/requirements.txt from the skill directory. Second, you must extract your tokenstr and plaud_user_api_domain from the browser console (Application > Local Storage) while logged into the Plaud web app. Create a .env file in the skill directory following the template provided in the README, ensuring the PLAUD_TOKEN includes the 'bearer ' prefix. Finally, verify the installation by running python3 plaud_client.py list to confirm the client can successfully fetch your recording metadata.

Use Cases

This skill is perfect for professionals who rely on voice memos for meeting notes or creative brainstorming. You can use it to archive transcripts into local markdown files, automatically summarize recent recordings for your daily recap, or search through your historical audio logs without needing to open a browser window. It is particularly useful for automating the extraction of key action items from lengthy recorded interviews or lectures.

Example Prompts

1. "List my five most recent Plaud recordings and tell me the title of the latest one."
2. "Get the transcript for my meeting titled 'Product Sync' from yesterday and summarize the action items."
3. "Save the transcript of my last Plaud recording to a new file named meeting_notes.txt."

Tips & Limitations

Always run commands from the root of the skill directory to ensure the plaud_client.py and .env files are correctly referenced. Be aware that the API domain is region-specific (e.g., api-euc1 for European servers); if your requests fail, double-check that your domain matches the one found in your web application's local storage. The tool is designed to work with the unofficial Plaud API client, so ensure you keep your dependencies updated to maintain compatibility with any changes to the Plaud backend.