← 返回 Skills 市场
1548
总下载
1
收藏
3
当前安装
1
版本数
在 OpenClaw 中安装
/install clovercli
功能描述
Command-line interface for managing Clover POS data including inventory, orders, payments, customers, employees, discounts, taxes, tenders, and reports with...
使用说明 (SKILL.md)
CloverCLI Skill
CLI for Clover POS API — inventory, orders, payments, customers, employees, discounts, and analytics.
Version: 1.2.0 (90-day chunking, retry logic, period shortcuts, discounts, taxes, tenders)
Setup
# Install from npm
npm i -g @versatly/clovercli
# Or clone and build
cd ~/Projects
git clone https://github.com/Versatly/clovercli.git
cd clovercli && npm install && npm run build
# Set credentials (add to ~/.bashrc)
export CLOVER_ACCESS_TOKEN="your-token"
export CLOVER_MERCHANT_ID="your-merchant-id"
# Optional alias
alias clover='clovercli'
Quick Reference
# Check connection
clovercli auth status
clovercli merchant get
# Business dashboard
clovercli reports summary
Reports with Period Shortcuts ✨
# Using --period (new in v1.2.0!)
clovercli reports sales --period today
clovercli reports sales --period yesterday
clovercli reports sales --period this-week
clovercli reports sales --period last-week
clovercli reports sales --period this-month
clovercli reports sales --period last-month
clovercli reports sales --period mtd # Month to date
clovercli reports sales --period ytd # Year to date
# Or use explicit dates
clovercli reports sales --from 2026-01-01 --to 2026-01-31
clovercli reports daily --period this-month
clovercli reports hourly --date 2026-02-03
clovercli reports top-items --limit 20
clovercli reports payments
clovercli reports refunds
clovercli reports taxes
clovercli reports categories
clovercli reports employees
clovercli reports compare --period1-from ... --period2-from ...
# Export data
clovercli reports export orders --output orders.csv --format csv
clovercli reports export items --output items.json
Merchant Settings
# Merchant info
clovercli merchant get
# Tax rates
clovercli merchant taxes list
# Payment tenders
clovercli merchant tenders list
Discounts (v1.2.0+)
clovercli discounts list
clovercli discounts get \x3Cid>
clovercli discounts create --name "10% Off" --percentage 10
clovercli discounts create --name "$5 Off" --amount 500
clovercli discounts delete \x3Cid>
Inventory
clovercli inventory items list
clovercli inventory items get \x3Cid>
clovercli inventory categories list
clovercli inventory stock list
Orders & Payments
clovercli orders list --limit 50
clovercli orders get \x3Cid>
clovercli payments list --limit 50
clovercli payments get \x3Cid>
Customers & Employees
clovercli customers list
clovercli customers get \x3Cid>
clovercli employees list
clovercli employees get \x3Cid>
Raw API Access
clovercli api get '/v3/merchants/{mId}/tax_rates'
clovercli api get '/v3/merchants/{mId}/modifiers'
Output Formats
All list commands support:
--output table(default) — formatted table--output json— raw JSON--quiet— IDs only
Reliability Features (v1.2.0+)
- 90-day auto-chunking: Long date ranges automatically split into chunks
- Exponential backoff: Auto-retry on rate limits with backoff
- Retry-after support: Respects Clover's retry-after header
Regions
| Region | Use |
|---|---|
us |
US merchants (default) |
eu |
Europe |
la |
Latin America |
sandbox |
Development/testing |
Set via: export CLOVER_REGION=eu
Known Clients
| Client | Merchant ID | Notes |
|---|---|---|
| REMEMBR | 6KF70H0B6E041 | Mauricio's Brazilian restaurant (Pedro's dad) |
Source
安全使用建议
What to consider before installing/use:
- The SKILL.md requires sensitive env vars (CLOVER_ACCESS_TOKEN, CLOVER_MERCHANT_ID) but the skill metadata doesn't declare them — treat this as an inconsistency and assume you will need to provide secrets.
- Verify the npm package and GitHub repo before installing: check the package owner (@versatly), review the repository code, recent commit/activity, npm download counts, and open issues. Prefer installing in an isolated environment (container/VM) if you want to test it.
- Create and use least-privilege Clover credentials (scoped token) and avoid putting long-lived secrets into your global shell rc without understanding the risk.
- The SKILL.md includes a specific "Known Client" row (a merchant id). That may indicate sample/test data or real customer data; be cautious about privacy/leakage.
- Because the skill is instruction-only, the platform won't pre-install anything for you — if you allow an agent to run the documented install commands, those commands will execute on your system. Only proceed if you trust the package and repository.
If you want me to: I can (1) fetch the npm package page and GitHub repo metadata to summarize ownership/activity, or (2) list concrete checks to perform on the repo and package before installing.
功能分析
Type: OpenClaw Skill
Name: clovercli
Version: 1.0.0
The skill bundle describes a legitimate CLI tool for interacting with the Clover POS API. The `SKILL.md` provides standard installation instructions and usage examples for managing inventory, orders, payments, customers, and reports. While the CLI handles sensitive business data, all described operations are aligned with the stated purpose of a POS management tool. There is no evidence of prompt injection attempts against the agent, data exfiltration, malicious execution, persistence mechanisms, or obfuscation. The inclusion of a specific 'Known Client' merchant ID in the documentation is an unusual information leak but does not constitute malicious behavior by the skill itself.
能力评估
Purpose & Capability
The SKILL.md clearly documents a Clover POS CLI that requires CLOVER_ACCESS_TOKEN and CLOVER_MERCHANT_ID, and instructs installing @versatly/clovercli. However the skill registry metadata lists no description, no required env vars, and no primary credential. The functionality is coherent for a Clover CLI, but the metadata omission is inconsistent and prevents automated vetting of the required credentials.
Instruction Scope
The instructions stay within the expected scope for a CLI: installing the tool, setting environment variables for API access, and running commands against Clover endpoints. The SKILL.md does not instruct the agent to read arbitrary local files or send data to unexpected external endpoints beyond the documented npm/GitHub package and Clover API.
Install Mechanism
There is no install spec in the registry (instruction-only skill), but the SKILL.md tells the user/agent to run npm i -g @versatly/clovercli or clone a GitHub repo. Installing a third‑party npm package is a normal way to get this CLI, but it introduces moderate risk: the package and repo should be verified (author, code, recent releases, vulnerabilities). The skill itself does not provide integrity information (checksum, pinned version) or an install script.
Credentials
The runtime instructions require CLOVER_ACCESS_TOKEN and CLOVER_MERCHANT_ID (and optionally CLOVER_REGION), which are sensitive credentials, but the skill metadata does not declare any required env vars or a primary credential. This mismatch means the registry record understates the credential needs and could lead to accidental credential exposure if users follow instructions without realizing the sensitivity.
Persistence & Privilege
The skill does not request persistent presence (always=false) and has no install artifact in the registry. It does not ask to modify other skills or system settings. Autonomous invocation is allowed (platform default) but not, by itself, a red flag here.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install clovercli - 安装完成后，直接呼叫该 Skill 的名称或使用
/clovercli触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
CloverCLI v1.2.0 introduces major new features and reliability improvements:
- Added period shortcuts for reports (e.g., --period today, this-week, ytd).
- New discounts commands: list, get, create (by percentage or amount), and delete.
- Implemented 90-day auto-chunking for large data requests.
- Added exponential backoff and support for Clover's retry-after header for reliable requests.
- Improved support for exporting and formatting output.
- Documentation expanded with updated examples, setup, and regional settings.
元数据
常见问题
Clovercli 是什么？
Command-line interface for managing Clover POS data including inventory, orders, payments, customers, employees, discounts, taxes, tenders, and reports with... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1548 次。
如何安装 Clovercli？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install clovercli」即可一键安装，无需额外配置。
Clovercli 是免费的吗？
是的，Clovercli 完全免费（开源免费），可自由下载、安装和使用。
Clovercli 支持哪些平台？
Clovercli 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Clovercli？
由 G9Pedro（@g9pedro）开发并维护，当前版本 v1.0.0。
推荐 Skills