← Back to Skills Marketplace
108
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install write-opennote
Description
Write, update, and read OpenNote notes through the public API. Use when the user wants to publish notes, upload note images, manage labels, or look up previo...
Usage Guidance
This skill is coherent with its stated purpose, but before installing consider: 1) It needs your OpenNote PAT (OPENNOTE_API_TOKEN) and will use it to create/update notes — only grant a token with the minimal scopes you need and revoke it if compromised. 2) The skill writes and reads .opennote/opennote-history.json and the labels cache in your working directory; those files will contain or reference your note contents and are read automatically at each invocation, so store them where you expect and don't share them. 3) If you want to avoid local persistence, run the skill in an isolated directory or remove/inspect the .opennote/ files after use. 4) The skill uses curl and the official api.opennote.cc endpoint — verify that matches your expectations. If any behavior (automatic history reads, random label selection) is surprising, ask the developer to change the defaults before using the skill with sensitive content.
Capability Analysis
Type: OpenClaw Skill
Name: write-opennote
Version: 1.0.0
The skill is a legitimate integration for the OpenNote API (api.opennote.cc), allowing the agent to create, update, and search notes. It uses local JSON files in a `.opennote/` directory for caching labels and maintaining a history of actions to support user queries about previous notes. While the use of `curl` with shell-interpolated variables presents a theoretical risk of injection if the agent fails to sanitize inputs, the instructions are clearly aligned with the stated purpose and show no signs of malicious intent or unauthorized data exfiltration.
Capability Assessment
Purpose & Capability
The name/description (Write OpenNote) matches the declared requirements: curl and an OPENNOTE_API_TOKEN are exactly what a client for the OpenNote public API needs. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
The SKILL.md instructs the agent to read and write two local files under .opennote/ (.opennote/opennote-labels-cache.json and .opennote/opennote-history.json) and to always read them at the start of every invocation. This is coherent with caching/history functionality but has privacy implications: the history file is described as a log of all notes written/edited via the skill and the agent will read it automatically even if the user doesn't explicitly request history lookup.
Install Mechanism
No install step is provided (instruction-only skill). This minimizes risk since nothing external is downloaded or written by an installer.
Credentials
Only a single environment variable is required: OPENNOTE_API_TOKEN (the declared primary credential). That matches the described API access needs and is proportionate. The SKILL.md only references this variable for Authorization headers.
Persistence & Privilege
The skill persists state in the agent's working directory (.opennote/). It does not request elevated platform privileges or always:true behavior. Still, local persistence of note content/history is a non-trivial privilege — users should know that note contents will be stored on disk and read automatically on each run.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install write-opennote - After installation, invoke the skill by name or use
/write-opennote - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release: Publish, update, and read notes using the OpenNote public API.
- Supports label management with caching for improved performance.
- Enables uploading note images and managing image embeds in notes.
- Maintains local log files for label cache and note history.
- Guides you through collecting note content, attaching labels, and assembling Quill rich content with formatting and images.
- Handles user authentication and security via the required API token environment variable.
Metadata
Frequently Asked Questions
What is Write OpenNote?
Write, update, and read OpenNote notes through the public API. Use when the user wants to publish notes, upload note images, manage labels, or look up previo... It is an AI Agent Skill for Claude Code / OpenClaw, with 108 downloads so far.
How do I install Write OpenNote?
Run "/install write-opennote" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Write OpenNote free?
Yes, Write OpenNote is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Write OpenNote support?
Write OpenNote is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Write OpenNote?
It is built and maintained by liam-duan (@liam-duan); the current version is v1.0.0.
More Skills