{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clovercli",
    "name": "Clovercli",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/G9Pedro/clovercli",
    "canonicalUrl": "https://clawhub.ai/G9Pedro/clovercli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/clovercli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clovercli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/clovercli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/clovercli",
    "agentPageUrl": "https://openagent3.xyz/skills/clovercli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clovercli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clovercli/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "CloverCLI Skill",
        "body": "CLI for Clover POS API — inventory, orders, payments, customers, employees, discounts, and analytics.\n\nVersion: 1.2.0 (90-day chunking, retry logic, period shortcuts, discounts, taxes, tenders)"
      },
      {
        "title": "Setup",
        "body": "# Install from npm\nnpm i -g @versatly/clovercli\n\n# Or clone and build\ncd ~/Projects\ngit clone https://github.com/Versatly/clovercli.git\ncd clovercli && npm install && npm run build\n\n# Set credentials (add to ~/.bashrc)\nexport CLOVER_ACCESS_TOKEN=\"your-token\"\nexport CLOVER_MERCHANT_ID=\"your-merchant-id\"\n\n# Optional alias\nalias clover='clovercli'"
      },
      {
        "title": "Quick Reference",
        "body": "# Check connection\nclovercli auth status\nclovercli merchant get\n\n# Business dashboard\nclovercli reports summary"
      },
      {
        "title": "Reports with Period Shortcuts ✨",
        "body": "# Using --period (new in v1.2.0!)\nclovercli reports sales --period today\nclovercli reports sales --period yesterday\nclovercli reports sales --period this-week\nclovercli reports sales --period last-week\nclovercli reports sales --period this-month\nclovercli reports sales --period last-month\nclovercli reports sales --period mtd          # Month to date\nclovercli reports sales --period ytd          # Year to date\n\n# Or use explicit dates\nclovercli reports sales --from 2026-01-01 --to 2026-01-31\nclovercli reports daily --period this-month\nclovercli reports hourly --date 2026-02-03\nclovercli reports top-items --limit 20\nclovercli reports payments\nclovercli reports refunds\nclovercli reports taxes\nclovercli reports categories\nclovercli reports employees\nclovercli reports compare --period1-from ... --period2-from ...\n\n# Export data\nclovercli reports export orders --output orders.csv --format csv\nclovercli reports export items --output items.json"
      },
      {
        "title": "Merchant Settings",
        "body": "# Merchant info\nclovercli merchant get\n\n# Tax rates\nclovercli merchant taxes list\n\n# Payment tenders\nclovercli merchant tenders list"
      },
      {
        "title": "Discounts (v1.2.0+)",
        "body": "clovercli discounts list\nclovercli discounts get <id>\nclovercli discounts create --name \"10% Off\" --percentage 10\nclovercli discounts create --name \"$5 Off\" --amount 500\nclovercli discounts delete <id>"
      },
      {
        "title": "Inventory",
        "body": "clovercli inventory items list\nclovercli inventory items get <id>\nclovercli inventory categories list\nclovercli inventory stock list"
      },
      {
        "title": "Orders & Payments",
        "body": "clovercli orders list --limit 50\nclovercli orders get <id>\n\nclovercli payments list --limit 50\nclovercli payments get <id>"
      },
      {
        "title": "Customers & Employees",
        "body": "clovercli customers list\nclovercli customers get <id>\n\nclovercli employees list\nclovercli employees get <id>"
      },
      {
        "title": "Raw API Access",
        "body": "clovercli api get '/v3/merchants/{mId}/tax_rates'\nclovercli api get '/v3/merchants/{mId}/modifiers'"
      },
      {
        "title": "Output Formats",
        "body": "All list commands support:\n\n--output table (default) — formatted table\n--output json — raw JSON\n--quiet — IDs only"
      },
      {
        "title": "Reliability Features (v1.2.0+)",
        "body": "90-day auto-chunking: Long date ranges automatically split into chunks\nExponential backoff: Auto-retry on rate limits with backoff\nRetry-after support: Respects Clover's retry-after header"
      },
      {
        "title": "Regions",
        "body": "RegionUseusUS merchants (default)euEuropelaLatin AmericasandboxDevelopment/testing\n\nSet via: export CLOVER_REGION=eu"
      },
      {
        "title": "Known Clients",
        "body": "ClientMerchant IDNotesREMEMBR6KF70H0B6E041Mauricio's Brazilian restaurant (Pedro's dad)"
      },
      {
        "title": "Source",
        "body": "npm: https://www.npmjs.com/package/@versatly/clovercli\nGitHub: https://github.com/Versatly/clovercli"
      }
    ],
    "body": "CloverCLI Skill\n\nCLI for Clover POS API — inventory, orders, payments, customers, employees, discounts, and analytics.\n\nVersion: 1.2.0 (90-day chunking, retry logic, period shortcuts, discounts, taxes, tenders)\n\nSetup\n# Install from npm\nnpm i -g @versatly/clovercli\n\n# Or clone and build\ncd ~/Projects\ngit clone https://github.com/Versatly/clovercli.git\ncd clovercli && npm install && npm run build\n\n# Set credentials (add to ~/.bashrc)\nexport CLOVER_ACCESS_TOKEN=\"your-token\"\nexport CLOVER_MERCHANT_ID=\"your-merchant-id\"\n\n# Optional alias\nalias clover='clovercli'\n\nQuick Reference\n# Check connection\nclovercli auth status\nclovercli merchant get\n\n# Business dashboard\nclovercli reports summary\n\nReports with Period Shortcuts ✨\n# Using --period (new in v1.2.0!)\nclovercli reports sales --period today\nclovercli reports sales --period yesterday\nclovercli reports sales --period this-week\nclovercli reports sales --period last-week\nclovercli reports sales --period this-month\nclovercli reports sales --period last-month\nclovercli reports sales --period mtd          # Month to date\nclovercli reports sales --period ytd          # Year to date\n\n# Or use explicit dates\nclovercli reports sales --from 2026-01-01 --to 2026-01-31\nclovercli reports daily --period this-month\nclovercli reports hourly --date 2026-02-03\nclovercli reports top-items --limit 20\nclovercli reports payments\nclovercli reports refunds\nclovercli reports taxes\nclovercli reports categories\nclovercli reports employees\nclovercli reports compare --period1-from ... --period2-from ...\n\n# Export data\nclovercli reports export orders --output orders.csv --format csv\nclovercli reports export items --output items.json\n\nMerchant Settings\n# Merchant info\nclovercli merchant get\n\n# Tax rates\nclovercli merchant taxes list\n\n# Payment tenders\nclovercli merchant tenders list\n\nDiscounts (v1.2.0+)\nclovercli discounts list\nclovercli discounts get <id>\nclovercli discounts create --name \"10% Off\" --percentage 10\nclovercli discounts create --name \"$5 Off\" --amount 500\nclovercli discounts delete <id>\n\nInventory\nclovercli inventory items list\nclovercli inventory items get <id>\nclovercli inventory categories list\nclovercli inventory stock list\n\nOrders & Payments\nclovercli orders list --limit 50\nclovercli orders get <id>\n\nclovercli payments list --limit 50\nclovercli payments get <id>\n\nCustomers & Employees\nclovercli customers list\nclovercli customers get <id>\n\nclovercli employees list\nclovercli employees get <id>\n\nRaw API Access\nclovercli api get '/v3/merchants/{mId}/tax_rates'\nclovercli api get '/v3/merchants/{mId}/modifiers'\n\nOutput Formats\n\nAll list commands support:\n\n--output table (default) — formatted table\n--output json — raw JSON\n--quiet — IDs only\nReliability Features (v1.2.0+)\n90-day auto-chunking: Long date ranges automatically split into chunks\nExponential backoff: Auto-retry on rate limits with backoff\nRetry-after support: Respects Clover's retry-after header\nRegions\nRegion\tUse\nus\tUS merchants (default)\neu\tEurope\nla\tLatin America\nsandbox\tDevelopment/testing\n\nSet via: export CLOVER_REGION=eu\n\nKnown Clients\nClient\tMerchant ID\tNotes\nREMEMBR\t6KF70H0B6E041\tMauricio's Brazilian restaurant (Pedro's dad)\nSource\nnpm: https://www.npmjs.com/package/@versatly/clovercli\nGitHub: https://github.com/Versatly/clovercli"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/G9Pedro/clovercli",
    "publisherUrl": "https://clawhub.ai/G9Pedro/clovercli",
    "owner": "G9Pedro",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clovercli",
    "downloadUrl": "https://openagent3.xyz/downloads/clovercli",
    "agentUrl": "https://openagent3.xyz/skills/clovercli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clovercli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clovercli/agent.md"
  }
}