near-qr-code

What This Skill Does

The NEAR QR Code Skill is a specialized toolkit for the OpenClaw AI agent designed to bridge the gap between human-readable NEAR Protocol interactions and machine-readable digital identifiers. It provides robust utilities to generate custom QR codes for wallet addresses or specific payment requests, and to decode existing QR images back into actionable data. By automating the creation and interpretation of these codes, the skill enables seamless interaction between offline media, digital invoices, and the blockchain.

Installation

To integrate this capability into your OpenClaw environment, ensure you have the necessary environment dependencies installed via pip install -r requirements.txt. Once prepared, deploy the skill using the following command in your terminal:

clawhub install openclaw/skills/skills/ussyalfaks/near-qr-skill

Use Cases

This skill is invaluable for several scenarios. First, it simplifies in-person or remote peer-to-peer transactions, where typing long NEAR account IDs is prone to error. Second, it is highly effective for merchants or freelancers generating dynamic payment requests—simply encode the account and the exact amount to create a scannable invoice. Third, it serves as an excellent tool for asset management, allowing users to quickly verify destination addresses by decoding QR codes before confirming a transaction on the blockchain, thus adding an extra layer of visual validation.

Example Prompts

1. "Generate a QR code for my NEAR address alice.near and save it as my_wallet.png with a size of 600 pixels."
2. "Create a payment QR code for bob.near requesting 10.5 NEAR for the design project and name the file invoice_101.png."
3. "Read the QR code located in downloads/scan_me.png and tell me if it contains an address or a payment request."

Tips & Limitations

When generating QR codes, always verify the target account ID before finalizing the file; incorrect characters will lead to failed payments. For payment requests, remember that the amount must be a numeric value representing the NEAR token quantity. The reading function is currently optimized for clear, high-contrast images; blurred or damaged QR codes may return errors or fail to decode. Ensure your file paths are accessible to the agent to avoid permission errors.