PrivyPad API Skill for Openclaw

A specialized skill for interacting with the PrivyPad REST API to manage zero-knowledge encrypted notes and groups.

aididmyhomework
v1.0.0
Mar 17, 2026
0
843
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install privypad

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install privypad using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is PrivyPad API Skill?

The PrivyPad API skill enables AI agents to securely interact with PrivyPad.com, a zero-knowledge encrypted note-taking platform. By utilizing this integration within the Openclaw Skills ecosystem, users can programmatically manage their private data while maintaining high security standards. The skill provides a direct bridge to the PrivyPad v1 REST API, allowing for the retrieval of pinned notes, group-based organization, and full CRUD operations on note content.

Because PrivyPad follows a zero-knowledge architecture, the API token provided by the user contains the necessary client-side secrets to handle encryption. This ensures that even when using Openclaw Skills to automate workflows, the server never has access to the plaintext content of your notes. This skill is ideal for developers and power users who want to integrate private note management into their automated daily routines.

PrivyPad API Skill Use Cases

  • Archiving important AI-generated summaries or code snippets directly into a secure vault.
  • Retrieving specific project notes or pinned items to provide context for current tasks.
  • Organizing disparate pieces of information into tagged groups for better knowledge management.
  • Automating the synchronization of tasks or ideas between other tools and a secure PrivyPad account.
  • Managing sensitive information using tags and group filters for rapid retrieval.

How PrivyPad API Skill Works

  1. The user generates a secure Bearer token in their PrivyPad Settings menu.
  2. The AI agent accepts this token and applies it to the Authorization header for all subsequent API requests.
  3. When a user requests a note-related action, the skill maps the intent to the corresponding REST endpoint (e.g., GET /notes or POST /notes).
  4. For creation or updates, the skill formats the note content as HTML to ensure compatibility with the PrivyPad editor.
  5. The skill handles pagination and filtering parameters to return concise, relevant data to the agent.
  6. Deletion requests are processed with a default safety mechanism that moves items to the trash unless a permanent delete is explicitly requested.

PrivyPad API Skill Setup

To get started with this integration in the context of Openclaw Skills, you must first obtain your API token:

  1. Log in to your PrivyPad account and navigate to Settings.
  2. Generate a new API token (formatted as pp_<uuid>.<secret>).
  3. Provide the token to your agent environment.

Example environment configuration:

# Set your token as an environment variable
export PRIVYPAD_TOKEN="pp_your_unique_token_here"

PrivyPad API Skill Data Schema & Taxonomy

The skill interacts with the following data structures for notes and organization:

Attribute Type Description
title String The display name of the note
content String (HTML) The encrypted body content in HTML format
group String The name of the group the note belongs to
tags Array A list of strings for categorized filtering
isPinned Boolean Indicates if the note is pinned to the top of the list
id String The unique identifier for the note (used for PATCH/DELETE)

PrivyPad API Skill Advanced Features

  • Permanent deletion support via the permanent=true query parameter to bypass the trash folder.
  • Advanced filtering using group names and pinned status to minimize data transfer.
  • Pagination controls using limit and offset for handling large databases of notes.
  • Support for partial updates using the PATCH method, allowing users to modify specific fields without overwriting the entire note.
  • Zero-knowledge security model where the client-side secret is managed entirely through the user-provided token.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*