supernote

What This Skill Does

The supernote skill provides an interface for interacting with a self-hosted Supernote Private Cloud instance. It leverages a reverse-engineered REST API to bridge your OpenClaw agent with your e-ink device, enabling seamless file management and content synchronization. Users can navigate their device's directory structure, upload documents such as PDFs and EPUBs, and check real-time storage statistics. A standout feature is the automated web-to-ebook conversion service, which extracts readable content from URLs and pushes them directly to your device as formatted e-books, ensuring an optimized reading experience.

Installation

To install this skill, use the ClawHub CLI: clawhub install openclaw/skills/skills/nickian/supernote-cloud. Once installed, you must configure your environment variables to authenticate with your local cloud instance. Set the following variables in your environment: SUPERNOTE_URL, SUPERNOTE_USER, and SUPERNOTE_PASSWORD. Ensure that your environment has the necessary Python dependencies installed, specifically readability-lxml, ebooklib, requests, beautifulsoup4, and lxml to ensure the article-to-ebook conversion feature functions correctly.

Use Cases

• Managing digital libraries: Uploading specific PDF textbooks or EPUB novels directly to categorized folders on your Supernote.
• Archiving web content: Converting long-form technical articles or blog posts into e-books for distraction-free reading during travel or offline sessions.
• Device organization: Performing cleanup or reorganization of handwritten note files and screenshots directly from the terminal or via the OpenClaw agent interface.
• Monitoring resources: Checking if your device is running low on disk space before uploading large research documents.

Example Prompts

1. "Hey, download this article from https://example.com/long-read and send it to my Document folder on the Supernote as an EPUB."
2. "Can you list all the notes I have in my 'Journal' directory on the Supernote device?"
3. "Check how much storage capacity I have left on my Supernote right now."

Tips & Limitations

• The unofficial API is subject to changes; always keep your dependencies updated to match potential firmware shifts.
• Prefer EPUB over PDF for web articles whenever possible; EPUBs allow for text reflow, which is significantly more readable on e-ink hardware compared to fixed-layout PDFs.
• Some websites utilize advanced anti-scraping measures; if the conversion fails, consider printing the page to PDF locally and uploading that file instead.
• Use the tree command periodically to verify that your directory naming conventions are consistent with your device's folder structure.