← 返回 Skills 市场
Invoice
作者
kleberbaum
· GitHub ↗
· v1.1.0
620
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install netsnek-invoice
功能描述
Creates and manages invoices as JSON files on GitHub with sequential numbering, preview, and upload.
安全使用建议
This skill is internally consistent with its purpose, but before installing: 1) Use a fine-grained GitHub token limited to the single invoice repository (avoid broad repo/org tokens). 2) Ensure INVOICE_REPO is set to the intended private repo (the scripts will create/update files there and assume branch 'main'). 3) Be aware invoice previews contain sensitive data (IBAN, addresses) which will be displayed in the assistant's messages — test with a throwaway/private repo first. 4) Confirm your environment is Linux and has the specified binaries. If you need the skill to only read data.json automatically, verify the agent uses get-invoices.sh/get file calls to fetch it (SKILL.md mentions it but does not add an automated fetch helper).
功能分析
Type: OpenClaw Skill
Name: netsnek-invoice
Version: 1.1.0
The skill's `SKILL.md` instructions create a prompt injection vulnerability that could lead to arbitrary command execution (RCE). Specifically, the instruction for the AI agent to 'RUN: `./scripts/get-invoices.sh RE 2026 6007`' where `6007` is derived from user input (e.g., '/rechnung 6007') means a malicious user could inject shell metacharacters (e.g., '6007; rm -rf /') into the `NUMBER` argument. If the OpenClaw agent concatenates this user input directly into the shell command string before execution, it would result in RCE. While the individual shell scripts are generally well-written and use arguments safely within quoted strings (e.g., for `curl` URLs), the vulnerability lies in the agent's interpretation and execution of the `RUN:` instruction with user-controlled parameters.
能力评估
Purpose & Capability
Name/description, required env vars (GITHUB_TOKEN, INVOICE_REPO), and required binaries (curl, python3, base64) match the implemented behavior: listing, previewing, numbering, and pushing invoice JSON files to GitHub via the API.
Instruction Scope
SKILL.md explicitly requires executing included scripts (get-next-number.sh, calc-preview.sh, push-invoice.sh). Those scripts operate only against the GitHub API and local JSON input. The doc says sender data is loaded from data.json or previous invoices but does not include an explicit helper that always fetches data.json — the assistant would need to call the provided get-invoices/get file flow to retrieve it. Also the preview output contains invoice sensitive data (bank/IBAN), which is expected but worth noting.
Install Mechanism
No install spec; this is instruction + script-only. Nothing is downloaded from external arbitrary URLs or written to system locations during install. Risk surface is limited to executing the included scripts at runtime.
Credentials
Requested env vars (GITHUB_TOKEN and INVOICE_REPO) are necessary for the GitHub operations. Caveat: the token must be scoped appropriately — a PAT with broad repo/org permissions could be misused if INVOICE_REPO is misconfigured. README recommends a fine-grained PAT scoped to a single repo, which is the correct practice.
Persistence & Privilege
Skill is not always-on and is user-invocable. claw.json requests network and exec permissions (expected for this functionality). The skill does not modify other skills or system-wide settings.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install netsnek-invoice - 安装完成后,直接呼叫该 Skill 的名称或使用
/netsnek-invoice触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.0
Invoice and offer management with calc-preview.sh for accurate Telegram previews. No LLM math needed. Supports discounts, German formatting, sequential numbering.
元数据
常见问题
Invoice 是什么?
Creates and manages invoices as JSON files on GitHub with sequential numbering, preview, and upload. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 620 次。
如何安装 Invoice?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install netsnek-invoice」即可一键安装,无需额外配置。
Invoice 是免费的吗?
是的,Invoice 完全免费(开源免费),可自由下载、安装和使用。
Invoice 支持哪些平台?
Invoice 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(linux)。
谁开发了 Invoice?
由 kleberbaum(@kleberbaum)开发并维护,当前版本 v1.1.0。
推荐 Skills