# Send QR Code to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-qr-code",
    "name": "QR Code",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/zouyawen/openclaw-qr-code",
    "canonicalUrl": "https://clawhub.ai/zouyawen/openclaw-qr-code",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/openclaw-qr-code",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-qr-code",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "openclaw-qr-code",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T02:41:09.146Z",
      "expiresAt": "2026-05-08T02:41:09.146Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-qr-code",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-qr-code",
        "contentDisposition": "attachment; filename=\"openclaw-qr-code-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "openclaw-qr-code"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-qr-code"
    },
    "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."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-qr-code",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-qr-code",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-qr-code/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-qr-code/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-qr-code/agent.md"
  }
}
```
## Documentation

### QR Code Skill

⚠️ This skill requires the companion plugin to function!

### 💎 Recommended: Full Feature Installation

For the complete experience with rounded dots, gradient colors, logo integration, and natural language support, install from GitHub:

curl -s https://raw.githubusercontent.com/zouyawen/openclaw-qrcode/main/install.sh | bash
openclaw gateway restart

### ⚡ Basic Installation (from ClawHub)

This provides basic QR code functionality only:

mkdir -p ~/.openclaw/skills/qr-code
# Extract the downloaded skill.zip to this directory
openclaw gateway restart

💡 Pro Tip: The GitHub installation includes advanced features like rounded dots, color gradients, and logo embedding that aren't available through ClawHub alone!

### Features

Generate: Create QR codes with custom colors, background, size, logo overlay, and format (PNG, JPG, SVG)
Decode: Extract data from QR code images
Beautify: Enhance existing QR codes with new styling while preserving data
Natural Language: Just say "make a colorful QR code" or "add a logo to this QR code"
Cross-channel compatibility: Works seamlessly across all OpenClaw channels including WhatsApp, Telegram, Discord, etc.
Automatic format handling: Converts formats as needed for channel compatibility
Enhanced security: Path traversal protection, input validation, and secure error handling
WhatsApp optimization: Automatic SVG-to-PNG conversion for WhatsApp compatibility

### Security Features

Path traversal protection: Logo paths are validated to prevent directory traversal attacks
Input sanitization: All color, size, and format parameters are strictly validated
Secure error handling: Comprehensive try-catch blocks prevent information leakage
File access restrictions: Only allows access to files within the workspace directory

### Natural Language (Recommended)

"生成一个圆点的渐变色二维码，内容是 https://example.com"
"在二维码中间加个 logo"
"用蓝色和黄色做渐变效果"
"这个二维码图片里是什么内容？" (attach image)

### Command Mode (Optional)

/qr generate https://mzt315.com color=red backgroundColor=white size=10 format=png
/qr decode [attach QR code image]  
/qr beautify [attach QR code image] color=green backgroundColor=black size=12

### With Logo (Secure)

/qr generate https://mzt315.com logoPath=logo.png

Note: Logo paths must be relative to the workspace and cannot contain .. or absolute paths.

### File Locations

QR Code Output: ~/clawd/qr-codes/
Logo Assets: ~/clawd/qr-assets/ (place your logo files here)

### WhatsApp Compatibility

Automatically handles WhatsApp's format requirements (PNG/JPG only)
Automatic SVG-to-PNG conversion: If SVG is requested on WhatsApp, it's automatically converted to PNG
Returns MEDIA paths that can be sent directly to any channel
Optimized for mobile viewing with appropriate sizing

### Input Validation

Colors: Must be valid CSS color names or hex codes (e.g., "red", "#FF0000")
Background Colors: Same validation as colors
Size: Must be a number between 1 and 50 (inclusive)
Format: Must be one of: png, jpg, jpeg, svg
Logo Path: Must be a relative path within the workspace directory

### Installation Requirements

This skill works best with the companion plugin from GitHub:

# Full feature installation (recommended)
curl -s https://raw.githubusercontent.com/zouyawen/openclaw-qrcode/main/install.sh | bash

# Python dependencies (installed automatically by the script)
# qrcode[pil], pillow, numpy, pyzbar

### Technical Details

This skill leverages OpenClaw's built-in qr_code_operations tool which supports both Python-based advanced features and Node.js fallback for maximum compatibility across different environments. All operations include comprehensive error handling and security validation.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: zouyawen
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T02:41:09.146Z
- Expires at: 2026-05-08T02:41:09.146Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/openclaw-qr-code)
- [Send to Agent page](https://openagent3.xyz/skills/openclaw-qr-code/agent)
- [JSON manifest](https://openagent3.xyz/skills/openclaw-qr-code/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/openclaw-qr-code/agent.md)
- [Download page](https://openagent3.xyz/downloads/openclaw-qr-code)