A comprehensive skill for AI agents to programmatically create, read, and update rich-text notes on OpenNote with support for images and stickers.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install write-opennote
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install write-opennote 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 OpenNote API Integration Skill?
The OpenNote API skill empowers AI agents to interact with the OpenNote ecosystem, providing a bridge between the agent's logic and a personal knowledge management system. By leveraging this Openclaw Skills contribution, developers can enable their agents to publish formatted content, organize data with labels, and maintain a historical record of all interactions.
Built for high-fidelity note-taking, the skill handles complex tasks such as generating Quill Delta JSON for rich text, managing multi-image collage layouts, and placing decorative stickers. It uses a local caching mechanism to ensure fast performance and minimal API overhead, making it an essential tool for automated journaling and documentation workflows.
OpenNote API Integration Skill Use Cases
- Automating the creation of daily standup notes or meeting summaries.
- Scraping technical documentation and formatting it for long-term storage in OpenNote.
- Managing image-heavy journals by programmatically uploading photos and creating collages.
- Searching through a history of AI-generated notes to provide context for current tasks.
How OpenNote API Integration Skill Works
- The skill validates the presence of the OPENNOTE_API_TOKEN environment variable.
- It synchronizes and caches user labels from the OpenNote API to local storage for quick lookup.
- User input is transformed into a Quill Delta JSON string to preserve rich formatting like bold text and lists.
- If images are provided, they are uploaded to the OpenNote media server to retrieve permanent identifiers.
- A final JSON payload, including content, richContent, and stickerData, is sent to the diaries endpoint.
- Upon success, the skill updates a local history file to track the note's fileName and content preview.
OpenNote API Integration Skill Setup
To get started, you must have an OpenNote Pro subscription. Generate a Personal Access Token (PAT) within the app under Profile -> API Tokens.
Configure your environment using the following command:
export OPENNOTE_API_TOKEN="milo_pat_v1_your_token_here"
Ensure that curl is installed and accessible in your system path, as it is the primary binary used for API communication within Openclaw Skills.
OpenNote API Integration Skill Data Schema & Taxonomy
The skill manages persistent data in a .opennote/ directory within your workspace:
| File | Purpose | Key Fields |
|---|---|---|
opennote-labels-cache.json |
Stores user categories | categoryID, categoryName, fetchedAt |
opennote-history.json |
Tracks skill activity | fileName, action, title, contentPreview |
Note payloads utilize Unix milliseconds for timestamps and JSON strings for rich-text structures.
OpenNote API Integration Skill Advanced Features
- Sticker Overlay Engine: Precisely position, scale, and rotate SVG stickers using normalized coordinates.
- Automated Image Processing: Handles multi-part image uploads and maps them to Quill Delta embeds.
- Intelligent Conflict Resolution: Automatically switches to PUT requests if a note filename already exists on the server.
- Rich Content Formatting: Support for 36 specific hex colors, blockquotes, code blocks, and various list types.
SKILL.md
Loading
Related Openclaw Skills
LeafEngines Agricultural Intelligence
LeafEngines is a high-performance MCP server providing agricultural data and soil intelligence tools for AI coding agents.
Streamtime
A comprehensive project management integration for creative agencies to manage jobs, track time, and handle financial operations via AI agents.
EvoMap
EvoMap is a collaborative hub for AI agents to publish validated solutions, complete bounty tasks, and participate in a credit-based service marketplace.
Feishu Voice
A free utility to convert text into high-quality audio and send it directly to Feishu users or groups via Edge TTS.
RAG Retriever 2.0
A high-performance Retrieval-Augmented Generation system for Openclaw Skills featuring hybrid vector search and intelligent document processing.
Code Refactor Skill
An intelligent code refactoring assistant that analyzes code quality and automatically applies structural improvements to reduce technical debt.
Featured*
