← Back to Skills Marketplace
leonardsellem

Plaud Unofficial Skill

by leonardsellem · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
1917
Downloads
3
Stars
2
Active Installs
2
Versions
Install in OpenClaw
/install plaud-unofficial
Description
Use when accessing Plaud voice recorder data (recordings, transcripts, AI summaries) - guides credential setup and provides patterns for plaud_client.py
Usage Guidance
This skill appears to be an unofficial, reverse-engineered Plaud client that generally matches its description, but exercise caution before installing or using it: - Review the included plaud_client.py yourself (it's provided) and confirm all network endpoints are the official Plaud domains you expect. The code is readable and makes direct requests to api-euc1.plaud.ai and related endpoints documented in PLAUD_API.md. - Be aware SKILL.md directs you to extract a bearer token from your browser localStorage and paste it into a plaintext .env file under the skill folder. That token is long-lived and grants access to your recordings and transcripts—only do this on a machine you control and trust. - Note the mismatch: registry metadata declares no required env vars, SKILL.md asks for PLAUD_TOKEN and PLAUD_API_DOMAIN, but plaud_client.py uses a region mapping/--region flag rather than reading PLAUD_API_DOMAIN from the environment. This likely indicates sloppy documentation rather than malicious behavior, but it is an incoherence you should confirm before trusting automation. - If you decide to proceed: restrict file permissions on the .env (chmod 600), keep backups secure, delete the token from browser/localStorage if you rotate it later, and consider creating a limited/rotatable credential if Plaud supports it. If unsure, prefer manually running the included script rather than granting the skill autonomous access.
Capability Analysis
Type: OpenClaw Skill Name: plaud-unofficial Version: 1.0.1 The skill is designed to interact with the Plaud API to manage voice recordings, transcripts, and AI summaries. The `SKILL.md` provides clear, explicit instructions for the user to obtain credentials from the Plaud web app's local storage and set them up in a local `.env` file. The `plaud_client.py` script correctly loads these credentials, makes API calls only to the expected Plaud domains (`*.plaud.ai`), and handles file downloads with basic sanitization. There is no evidence of prompt injection against the agent, data exfiltration, malicious execution, persistence mechanisms, or obfuscation. All actions are aligned with the stated purpose of accessing Plaud data.
Capability Assessment
Purpose & Capability
Name, description, and included files (plaud_client.py + API docs) align with the stated purpose of accessing Plaud recordings/transcripts. However, the registry metadata lists no required env vars while the runtime docs instruct you to add PLAUD_TOKEN and PLAUD_API_DOMAIN to a .env file—so the declared requirements do not match the actual usage.
Instruction Scope
SKILL.md instructs a manual interactive flow: open web.plaud.ai, use Chrome DevTools to read localStorage.tokenstr and copy it into a local .env file. That step asks the user to extract a bearer token from their browser (sensitive secret). The instructions stick to the skill's scope (accessing Plaud data) and do not instruct reading other system files, but they do direct storing a long-lived token in plaintext under ~/.claude/skills/plaud-api/.env which expands the attack surface if the machine is shared or compromised.
Install Mechanism
There is no external download/install mechanism beyond shipping the code in the skill and advising pip install -r requirements.txt. No remote arbitrary archive downloads or obscure third-party installers were found.
Credentials
The skill legitimately needs a Plaud bearer token to work, but the registry declares no required environment variables while SKILL.md asks for PLAUD_TOKEN and PLAUD_API_DOMAIN. Also the included client reads PLAUD_TOKEN but does not appear to read PLAUD_API_DOMAIN (it uses a region mapping or --region flag), so the docs and code disagree. Asking users to copy a bearer token (long-lived, ~10 months) into a local file is sensitive and should be justified and handled carefully.
Persistence & Privilege
The skill does not request always:true and will not be force-included for all agents. It only stores credentials in a skill-local .env file and does not modify other skills or system-wide agent settings. Autonomous invocation is allowed (platform default) but not combined with other high privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install plaud-unofficial
  3. After installation, invoke the skill by name or use /plaud-unofficial
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Initial release of the Plaud API skill for voice recorder data access. - Added plaud_client.py CLI tool for listing, downloading, and managing Plaud recordings, transcripts, and summaries. - Provided sample .env.example for credential setup. - Included detailed PLAUD_API.md documentation of endpoints and usage. - Added requirements.txt listing necessary Python dependencies. - Supplied .gitignore for proper version control hygiene. - SKILL.md now reflects full instructions for interactive credential setup, file usage from the skill directory, and common usage patterns.
v1.0.0
plaud-unofficial 1.0.0 - Initial release of the Plaud API Skill for accessing Plaud voice recorder data. - Provides step-by-step credential setup instructions using Chrome DevTools and a `.env` file. - Offers command-line usage and patterns for listing, downloading, and retrieving transcripts/summaries via `plaud_client.py`. - Includes troubleshooting for common errors and a refresh guide for expired tokens. - Quick reference table for major commands and API endpoints included. - Mention of n8n integration for automated transcript processing.
Metadata
Slug plaud-unofficial
Version 1.0.1
License
All-time Installs 2
Active Installs 2
Total Versions 2
Frequently Asked Questions

What is Plaud Unofficial Skill?

Use when accessing Plaud voice recorder data (recordings, transcripts, AI summaries) - guides credential setup and provides patterns for plaud_client.py. It is an AI Agent Skill for Claude Code / OpenClaw, with 1917 downloads so far.

How do I install Plaud Unofficial Skill?

Run "/install plaud-unofficial" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Plaud Unofficial Skill free?

Yes, Plaud Unofficial Skill is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Plaud Unofficial Skill support?

Plaud Unofficial Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Plaud Unofficial Skill?

It is built and maintained by leonardsellem (@leonardsellem); the current version is v1.0.1.

💬 Comments