← 返回 Skills 市场
1883
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install supernote-cloud
功能描述
Access a self-hosted Supernote Private Cloud instance to browse files and folders, upload documents (PDF, EPUB) and notes, convert web articles to EPUB/PDF and send them to the device, check storage capacity, and navigate the directory tree. Use when the user mentions Supernote, e-ink device files, wants to upload/browse documents on their Supernote cloud, or wants to send an article/URL to their e-reader.
安全使用建议
This skill appears to implement a reasonable Supernote Private Cloud client, but there are two key issues to consider before installing:
- Metadata mismatch: The registry entry declares no required environment variables or credentials, but the SKILL.md and scripts require SUPERNOTE_URL, SUPERNOTE_USER, and SUPERNOTE_PASSWORD. Don’t assume the skill is low-privileged — it needs your Supernote credentials and a URL. Only provide those to a trusted self-hosted server.
- Token caching and local file access: The CLI caches an auth token in /tmp/.supernote_token (file permission 600) and will read local files you ask it to upload and will fetch arbitrary web URLs to convert into EPUB/PDF. If an attacker or untrusted package controls the configured BASE_URL, your credentials could be sent to that host. Also, the token file in /tmp may be accessible to other local users depending on your system policies.
Recommendations:
- Verify/inspect the full scripts yourself (you have them). Confirm BASE_URL is a server you control or trust before entering credentials.
- Consider creating a dedicated, limited Supernote account for use with this skill rather than using a primary account.
- Run the skill in an isolated environment (container or disposable machine) if you’re concerned about token leakage or untrusted network endpoints.
- Be cautious when using the article conversion feature: it fetches arbitrary web pages and embedded images (network I/O). If you only need file upload/listing, avoid using article conversion or review the converter's behavior.
Confidence: high that the skill is internally inconsistent (metadata vs runtime) and that the scripts will access sensitive credentials and perform network/local-file operations; this warrants a cautious installation approach.
功能分析
Type: OpenClaw Skill
Name: supernote-cloud
Version: 1.0.0
The skill is classified as suspicious due to several risky capabilities and security practices, despite its stated purpose. It requires and directly handles sensitive credentials (SUPERNOTE_USER, SUPERNOTE_PASSWORD) via environment variables, storing a JWT token in `/tmp/.supernote_token`. The `scripts/supernote.sh` script exhibits weak input sanitization by directly interpolating these sensitive variables into Python `-c` arguments and `curl -d` JSON payloads, which could lead to JSON injection or script errors if the environment variables contain special characters. Furthermore, the skill provides capabilities to fetch arbitrary URLs (`scripts/article2ebook.py`) and upload arbitrary local files (`scripts/supernote.sh`), which, while core to its functionality, could be misused if the agent is compromised by prompt injection.
能力评估
Purpose & Capability
The name/description (manage a self-hosted Supernote Private Cloud, upload articles/files, convert web pages) matches the included scripts (a CLI shell client and an article→ebook converter). The functionality present is coherent with the claimed purpose.
Instruction Scope
SKILL.md instructs the user to export SUPERNOTE_URL, SUPERNOTE_USER, and SUPERNOTE_PASSWORD and shows many curl/python calls. The shell script then uses those env vars, contacts the given BASE_URL endpoints, downloads remote content (for article conversion and image embedding), resolves directory trees, and uploads local files. The instructions and scripts therefore access network endpoints, arbitrary web URLs, and local files — all expected for this purpose but broad. The concern is that SKILL.md grants the skill freedom to fetch arbitrary URLs and to read local files specified for upload; it also caches auth tokens on disk. There are no instructions limiting scope or warning about credential handling.
Install Mechanism
This is an instruction-only skill with no installer, so nothing is written to disk by an installer. The runtime includes two scripts shipped in the bundle; no remote download or package install mechanics are present in the registry metadata (lowest install risk).
Credentials
The registry metadata declares no required environment variables or primary credential, but SKILL.md and scripts require three sensitive env vars (SUPERNOTE_URL, SUPERNOTE_USER, SUPERNOTE_PASSWORD). That's an inconsistency: the skill runtime will ask for and use credentials despite the registry not advertising them. The skill will send the hashed password to the configured BASE_URL and caches a token in /tmp/.supernote_token (permission 600). This credential access is proportionate to the described functionality, but the metadata omission and on-disk token cache are notable risks and surprising to a user who inspects the registry entry only.
Persistence & Privilege
always is false (not forced into every agent run) and disable-model-invocation is default (agent may call it autonomously). The script writes a token file to /tmp/.supernote_token for session caching — a lightweight persistence that can expose a session token to other local users/processes on the host. The skill does not modify other skills or global agent settings.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install supernote-cloud - 安装完成后,直接呼叫该 Skill 的名称或使用
/supernote-cloud触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: browse files, upload documents, convert web articles to EPUB/PDF and send to Supernote e-ink device via self-hosted Private Cloud API
元数据
常见问题
Supernote Cloud 是什么?
Access a self-hosted Supernote Private Cloud instance to browse files and folders, upload documents (PDF, EPUB) and notes, convert web articles to EPUB/PDF and send them to the device, check storage capacity, and navigate the directory tree. Use when the user mentions Supernote, e-ink device files, wants to upload/browse documents on their Supernote cloud, or wants to send an article/URL to their e-reader. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1883 次。
如何安装 Supernote Cloud?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install supernote-cloud」即可一键安装,无需额外配置。
Supernote Cloud 是免费的吗?
是的,Supernote Cloud 完全免费(开源免费),可自由下载、安装和使用。
Supernote Cloud 支持哪些平台?
Supernote Cloud 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Supernote Cloud?
由 nickian(@nickian)开发并维护,当前版本 v1.0.0。
推荐 Skills