← 返回 Skills 市场
Paperless
作者
NickChristensen
· GitHub ↗
· v1.1.0
2856
总下载
1
收藏
14
当前安装
3
版本数
在 OpenClaw 中安装
/install paperless
功能描述
Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.
安全使用建议
This skill looks coherent for controlling Paperless-NGX via the ppls CLI, but before installing: 1) Verify the npm package identity and maintainer (check the GitHub repo and package contents) to ensure you’re installing the legitimate @nickchristensen/ppls package. 2) Prefer installing without -g (or use a container/venv) if you want to limit global code execution, and avoid running npm as root. 3) Confirm where ppls stores the configured token (config file) and protect that file (restrict filesystem permissions); consider a least-privilege API token for Paperless. 4) Double-check the registry metadata mismatch (top-level metadata showed no required env vars/bins while SKILL.md does) — treat that as a packaging issue to clarify with the publisher. 5) If you cannot vet the package, consider manually invoking Paperless-NGX API calls or using a known trusted client instead.
功能分析
Type: OpenClaw Skill
Name: paperless
Version: 1.1.0
The skill bundle is classified as benign. The `SKILL.md` file clearly defines the purpose of interacting with Paperless-NGX via the `ppls` CLI. It requires `PPLS_HOSTNAME` and `PPLS_TOKEN` environment variables, which are necessary for its stated functionality and are not exfiltrated. The installation instructions specify a known npm package (`@nickchristensen/ppls`), and all command examples are legitimate operations for a document management system, including downloading files to the user's `~/Downloads` directory. There is no evidence of malicious prompt injection, data exfiltration, unauthorized execution, or persistence mechanisms.
能力评估
Purpose & Capability
The SKILL.md instructions and description match: they drive the ppls CLI to interact with Paperless-NGX (search, download, upload, metadata). However, registry-level metadata provided to you earlier shows no required binaries or env vars while the SKILL.md includes metadata that requires the ppls binary and env vars (PPLS_HOSTNAME, PPLS_TOKEN). This is likely a packaging/metadata omission rather than a functional mismatch, but it is an inconsistency you should be aware of.
Instruction Scope
Runtime instructions are narrowly scoped to installing/configuring/running the ppls CLI and using it to query and manage documents on a Paperless-NGX host. The doc tells the agent to run ppls commands and set hostname/token; it does not instruct reading unrelated files or exfiltrating data to third-party endpoints.
Install Mechanism
The SKILL.md recommends installing @nickchristensen/ppls via npm (global install). This is a common, expected mechanism for a CLI wrapper but is higher-risk than an instruction-only skill because it executes third-party code from npm. The referenced GitHub project exists (https://github.com/NickChristensen/ppls), which reduces but does not eliminate risk; you should review the package and prefer a trusted install method.
Credentials
The only credentials/configuration the skill needs (per SKILL.md metadata) are the Paperless hostname and API token (PPLS_HOSTNAME, PPLS_TOKEN), which are proportional to its purpose. No unrelated secrets or multiple service credentials are requested. Note again the registry metadata omitted these env requirements.
Persistence & Privilege
The skill does not request always:true, does not demand persistent elevated privileges, and does not attempt to change other skills' configurations. It appears to be an ordinary user-invocable skill with no special platform privileges.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install paperless - 安装完成后,直接呼叫该 Skill 的名称或使用
/paperless触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.0
Updated docs with v1.2.0 CLI features: date filters, tag/correspondent/document-type filters, repeatable args
v1.0.1
Added metadata: requires ppls binary with install instructions
v1.0.0
Initial release - search, retrieve, upload, and organize documents via ppls CLI
元数据
常见问题
Paperless 是什么?
Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2856 次。
如何安装 Paperless?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install paperless」即可一键安装,无需额外配置。
Paperless 是免费的吗?
是的,Paperless 完全免费(开源免费),可自由下载、安装和使用。
Paperless 支持哪些平台?
Paperless 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Paperless?
由 NickChristensen(@nickchristensen)开发并维护,当前版本 v1.1.0。
推荐 Skills