Description

Upload files to Govilo and generate unlock links via Bot API. Use when: (1) Creating a Govilo unlock link from a ZIP, folder, or individual files, (2) Automating file upload to Govilo R2 storage with presigned URLs, (3) Managing Govilo Bot API interactions (presign → upload → create item). Requires GOVILO_API_KEY and SELLER_ADDRESS env vars. If missing, guides user to register at https://govilo.xyz/.

README (SKILL.md)

Govilo To Go

Name: Gen Paylink Govilo
Author: hau823823

Turn any file into a paid unlock link — one command to package, upload, and collect crypto payments. The last mile of automation: from creation to monetization.

Before Running

Always ask the user for these values before executing the CLI — never guess or use placeholders:

title — What is the product name?
price — How much to charge (in USDC)?
description — Short description of the product (optional, but always ask)

CLI Command

Requires uv. See references/setup-guide.md for install instructions.

Run from this skill's base directory. Use a dedicated env file containing only GOVILO_API_KEY (and optionally SELLER_ADDRESS). Never point --env-file at a project .env that contains unrelated secrets.

cd \x3Cskill_base_directory>
uv run --env-file \x3Cpath_to>/.env.govilo create-link \
  --input \x3Cpath>         \
  --title "Product Name" \
  --price "5.00"         \
  --address "0x..."      \
  --description "optional"

If no .env.govilo exists, create one before running:

GOVILO_API_KEY=sk_live_xxx
SELLER_ADDRESS=0x...

--input accepts ZIP file, folder, or individual files (repeatable). Non-ZIP inputs are auto-packaged.

All output is JSON {"ok": true/false, ...} with exit code 1 on failure.

Parameters

Param	Required	Source	Description
`--input`	Yes	CLI (repeatable)	ZIP, folder, or file paths
`--title`	Yes	CLI	Product title
`--price`	Yes	CLI	Price in USDC
`--address`	No	CLI > `SELLER_ADDRESS` env	Seller EVM wallet
`--description`	No	CLI	Product description

Workflow

Validate config (API Key + seller address)
Package inputs → ZIP (if not already ZIP)
POST /api/v1/bot/uploads/presign → get upload_url + session_id
PUT upload_url → upload ZIP to R2
POST /api/v1/bot/items → get unlock_url

File Limits

Max ZIP size: 20 MB
Max files in ZIP: 20

Setup

Two values are required:

Variable	Required	Description
`GOVILO_API_KEY`	Yes	Bot API key from govilo.xyz
`SELLER_ADDRESS`	Yes*	EVM wallet address on Base chain

*SELLER_ADDRESS can also be passed via --address CLI parameter.

See references/setup-guide.md for step-by-step registration and wallet setup instructions.

API Reference

See references/bot-api-quick-ref.md for Bot API endpoints and error codes.

Usage Guidance

This skill appears coherent and implements exactly what it says: packaging files, calling Govilo presign → upload → create item, and returning an unlock link. Before installing/use: (1) Only provide a Govilo API key you trust — the API key grants actions in your Govilo account, so prefer a scoped/dedicated key and rotate it if compromised. (2) Follow the SKILL.md advice: use a dedicated .env file containing only GOVILO_API_KEY and SELLER_ADDRESS; do not point --env-file at shared project .env files with other secrets. (3) The setup guide suggests installing 'uv' via a remote install script (curl | sh); audit that URL or install via a package manager you trust (Homebrew) if you prefer. (4) Review the included code (it is present and readable) and confirm the base API URL (https://api.unlock.govilo.xyz) matches expectations. (5) Be cautious uploading any sensitive files — uploads are sent to the presigned URL returned by Govilo. If you want further assurance, run the tool in an isolated environment or inspect network activity during a dry run.

Capability Analysis

Type: OpenClaw Skill Name: gen-paylink-govilo Version: 1.0.1 The skill's code and documentation align with its stated purpose of uploading files to Govilo and generating unlock links. The `SKILL.md` explicitly instructs the agent to ask the user for critical inputs (title, price, description), which is a defensive measure against prompt injection. The Python scripts (`api_client.py`, `config.py`, `packager.py`, `workflow_create.py`) handle file packaging, API communication with `api.unlock.govilo.xyz`, and configuration securely, without evidence of data exfiltration beyond required credentials, malicious execution, or persistence mechanisms. The `uv` installation instructions in `references/setup-guide.md` are for user setup and not part of the agent's runtime execution of the skill.

Capability Assessment

✓ Purpose & Capability

Name/description match the code and instructions: the tool packages inputs, calls Govilo Bot API endpoints (/api/v1/bot/uploads/presign and /api/v1/bot/items), uploads the ZIP to the returned upload_url, and returns unlock_url. Required env vars (GOVILO_API_KEY, SELLER_ADDRESS) are exactly what this integration needs.

✓ Instruction Scope

SKILL.md and included scripts limit runtime actions to: validating config, packaging user-specified paths, calling the Govilo API, uploading the ZIP, and printing JSON results. There are no instructions to read unrelated files or environment variables, nor to exfiltrate data to unexpected endpoints. The SKILL.md explicitly warns to use a dedicated env file and not to point at project .env files.

ℹ Install Mechanism

There is no formal install spec; the skill is invoked via 'uv run' per pyproject.toml. The setup guide suggests installing 'uv' with a curl | sh installer (https://astral.sh/uv/install.sh) or Homebrew. That installer is an external script executed by the user — a standard convenience but a risk if you don't trust the source. The code itself uses only the requests library and Python stdlib; nothing else is downloaded or executed by the skill at runtime.

✓ Credentials

Only GOVILO_API_KEY (primary credential) and SELLER_ADDRESS are required, which align with the described API usage. The code reads only those variables (or CLI overrides). No unrelated secrets or config paths are requested.

✓ Persistence & Privilege

Skill is not always-enabled and does not request permanent presence or modify other skills or system-wide settings. It does not persist credentials beyond using environment variables or the CLI-provided values.

Version History

v1.0.1

- Added a concise marketing summary to the top of SKILL.md, highlighting the skill’s core value. - No workflow or usage changes—documentation only. - All core instructions, parameters, and setup remain unchanged.

v1.0.0

gen-paylink-govilo v1.0.0 initial release - Publish first version of skill for uploading files to Govilo and generating unlock links via Bot API. - Requires GOVILO_API_KEY and SELLER_ADDRESS environment variables. - Documentation updated: clarified setup steps and added uv install instructions. - Improved metadata formatting and variable requirements in SKILL.md. - Expanded setup-guide reference and ensured clear API/onboarding instructions.

v0.1.2

- Skill renamed from "govilo-to-go" to "gen-paylink-govilo" - Updated homepage link in metadata to the project's GitHub repository - Clarified instructions: recommend using a dedicated `.env.govilo` file containing only relevant secrets, not a project's general `.env` - Added explicit instructions for creating a `.env.govilo` file if one does not exist - Minor formatting and wording improvements for clarity and safety - Description, CLI usage, and variable setup guidance refined for accuracy and best practices

v0.1.1

- Added metadata section to SKILL.md with author, version, and Openclaw integration details. - Clarified CLI usage instructions, specifying that the command should be run from the skill base directory and the .env file must be at the project root.

v0.1.0

Initial release of Govilo To Go: upload files and generate Govilo unlock links via API. - Supports uploading ZIPs, folders, or individual files (auto-zipping if needed). - Guides users to provide product title, price (in USDC), and description before each run. - Integrates with Govilo Bot API to create unlock links and manage presigned file uploads. - Requires GOVILO_API_KEY; provides setup guidance if missing. - Enforces maximum 20MB upload size and up to 20 files per ZIP. - Outputs results as JSON, with exit code 1 on failure.

Metadata

Slug gen-paylink-govilo

Version 1.0.1

License —

All-time Installs 1

Active Installs 1

Total Versions 5

Frequently Asked Questions

What is Gen Paylink Govilo?

Upload files to Govilo and generate unlock links via Bot API. Use when: (1) Creating a Govilo unlock link from a ZIP, folder, or individual files, (2) Automating file upload to Govilo R2 storage with presigned URLs, (3) Managing Govilo Bot API interactions (presign → upload → create item). Requires GOVILO_API_KEY and SELLER_ADDRESS env vars. If missing, guides user to register at https://govilo.xyz/. It is an AI Agent Skill for Claude Code / OpenClaw, with 1040 downloads so far.

How do I install Gen Paylink Govilo?

Run "/install gen-paylink-govilo" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gen Paylink Govilo free?

Yes, Gen Paylink Govilo is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Gen Paylink Govilo support?

Gen Paylink Govilo is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gen Paylink Govilo?

It is built and maintained by hau823823 (@hau823823); the current version is v1.0.1.

More Skills

Gen Paylink Govilo