{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/openclaw-qr-code",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-qr-code",
    "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/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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/openclaw-qr-code",
    "agentPageUrl": "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"
  },
  "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": "QR Code Skill",
        "body": "⚠️ This skill requires the companion plugin to function!"
      },
      {
        "title": "💎 Recommended: Full Feature Installation",
        "body": "For the complete experience with rounded dots, gradient colors, logo integration, and natural language support, install from GitHub:\n\ncurl -s https://raw.githubusercontent.com/zouyawen/openclaw-qrcode/main/install.sh | bash\nopenclaw gateway restart"
      },
      {
        "title": "⚡ Basic Installation (from ClawHub)",
        "body": "This provides basic QR code functionality only:\n\nmkdir -p ~/.openclaw/skills/qr-code\n# Extract the downloaded skill.zip to this directory\nopenclaw gateway restart\n\n💡 Pro Tip: The GitHub installation includes advanced features like rounded dots, color gradients, and logo embedding that aren't available through ClawHub alone!"
      },
      {
        "title": "Features",
        "body": "Generate: Create QR codes with custom colors, background, size, logo overlay, and format (PNG, JPG, SVG)\nDecode: Extract data from QR code images\nBeautify: Enhance existing QR codes with new styling while preserving data\nNatural Language: Just say \"make a colorful QR code\" or \"add a logo to this QR code\"\nCross-channel compatibility: Works seamlessly across all OpenClaw channels including WhatsApp, Telegram, Discord, etc.\nAutomatic format handling: Converts formats as needed for channel compatibility\nEnhanced security: Path traversal protection, input validation, and secure error handling\nWhatsApp optimization: Automatic SVG-to-PNG conversion for WhatsApp compatibility"
      },
      {
        "title": "Security Features",
        "body": "Path traversal protection: Logo paths are validated to prevent directory traversal attacks\nInput sanitization: All color, size, and format parameters are strictly validated\nSecure error handling: Comprehensive try-catch blocks prevent information leakage\nFile access restrictions: Only allows access to files within the workspace directory"
      },
      {
        "title": "Natural Language (Recommended)",
        "body": "\"生成一个圆点的渐变色二维码，内容是 https://example.com\"\n\"在二维码中间加个 logo\"\n\"用蓝色和黄色做渐变效果\"\n\"这个二维码图片里是什么内容？\" (attach image)"
      },
      {
        "title": "Command Mode (Optional)",
        "body": "/qr generate https://mzt315.com color=red backgroundColor=white size=10 format=png\n/qr decode [attach QR code image]  \n/qr beautify [attach QR code image] color=green backgroundColor=black size=12"
      },
      {
        "title": "With Logo (Secure)",
        "body": "/qr generate https://mzt315.com logoPath=logo.png\n\nNote: Logo paths must be relative to the workspace and cannot contain .. or absolute paths."
      },
      {
        "title": "File Locations",
        "body": "QR Code Output: ~/clawd/qr-codes/\nLogo Assets: ~/clawd/qr-assets/ (place your logo files here)"
      },
      {
        "title": "WhatsApp Compatibility",
        "body": "Automatically handles WhatsApp's format requirements (PNG/JPG only)\nAutomatic SVG-to-PNG conversion: If SVG is requested on WhatsApp, it's automatically converted to PNG\nReturns MEDIA paths that can be sent directly to any channel\nOptimized for mobile viewing with appropriate sizing"
      },
      {
        "title": "Input Validation",
        "body": "Colors: Must be valid CSS color names or hex codes (e.g., \"red\", \"#FF0000\")\nBackground Colors: Same validation as colors\nSize: Must be a number between 1 and 50 (inclusive)\nFormat: Must be one of: png, jpg, jpeg, svg\nLogo Path: Must be a relative path within the workspace directory"
      },
      {
        "title": "Installation Requirements",
        "body": "This skill works best with the companion plugin from GitHub:\n\n# Full feature installation (recommended)\ncurl -s https://raw.githubusercontent.com/zouyawen/openclaw-qrcode/main/install.sh | bash\n\n# Python dependencies (installed automatically by the script)\n# qrcode[pil], pillow, numpy, pyzbar"
      },
      {
        "title": "Technical Details",
        "body": "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."
      }
    ],
    "body": "QR Code Skill\n\n⚠️ This skill requires the companion plugin to function!\n\n🚀 Quick Start\n💎 Recommended: Full Feature Installation\n\nFor the complete experience with rounded dots, gradient colors, logo integration, and natural language support, install from GitHub:\n\ncurl -s https://raw.githubusercontent.com/zouyawen/openclaw-qrcode/main/install.sh | bash\nopenclaw gateway restart\n\n⚡ Basic Installation (from ClawHub)\n\nThis provides basic QR code functionality only:\n\nmkdir -p ~/.openclaw/skills/qr-code\n# Extract the downloaded skill.zip to this directory\nopenclaw gateway restart\n\n\n💡 Pro Tip: The GitHub installation includes advanced features like rounded dots, color gradients, and logo embedding that aren't available through ClawHub alone!\n\nFeatures\nGenerate: Create QR codes with custom colors, background, size, logo overlay, and format (PNG, JPG, SVG)\nDecode: Extract data from QR code images\nBeautify: Enhance existing QR codes with new styling while preserving data\nNatural Language: Just say \"make a colorful QR code\" or \"add a logo to this QR code\"\nCross-channel compatibility: Works seamlessly across all OpenClaw channels including WhatsApp, Telegram, Discord, etc.\nAutomatic format handling: Converts formats as needed for channel compatibility\nEnhanced security: Path traversal protection, input validation, and secure error handling\nWhatsApp optimization: Automatic SVG-to-PNG conversion for WhatsApp compatibility\nSecurity Features\nPath traversal protection: Logo paths are validated to prevent directory traversal attacks\nInput sanitization: All color, size, and format parameters are strictly validated\nSecure error handling: Comprehensive try-catch blocks prevent information leakage\nFile access restrictions: Only allows access to files within the workspace directory\nUsage Examples\nNatural Language (Recommended)\n\"生成一个圆点的渐变色二维码，内容是 https://example.com\"\n\"在二维码中间加个 logo\"\n\"用蓝色和黄色做渐变效果\"\n\"这个二维码图片里是什么内容？\" (attach image)\nCommand Mode (Optional)\n/qr generate https://mzt315.com color=red backgroundColor=white size=10 format=png\n/qr decode [attach QR code image]  \n/qr beautify [attach QR code image] color=green backgroundColor=black size=12\n\nWith Logo (Secure)\n/qr generate https://mzt315.com logoPath=logo.png\n\n\nNote: Logo paths must be relative to the workspace and cannot contain .. or absolute paths.\n\nFile Locations\nQR Code Output: ~/clawd/qr-codes/\nLogo Assets: ~/clawd/qr-assets/ (place your logo files here)\nWhatsApp Compatibility\nAutomatically handles WhatsApp's format requirements (PNG/JPG only)\nAutomatic SVG-to-PNG conversion: If SVG is requested on WhatsApp, it's automatically converted to PNG\nReturns MEDIA paths that can be sent directly to any channel\nOptimized for mobile viewing with appropriate sizing\nInput Validation\nColors: Must be valid CSS color names or hex codes (e.g., \"red\", \"#FF0000\")\nBackground Colors: Same validation as colors\nSize: Must be a number between 1 and 50 (inclusive)\nFormat: Must be one of: png, jpg, jpeg, svg\nLogo Path: Must be a relative path within the workspace directory\nInstallation Requirements\n\nThis skill works best with the companion plugin from GitHub:\n\n# Full feature installation (recommended)\ncurl -s https://raw.githubusercontent.com/zouyawen/openclaw-qrcode/main/install.sh | bash\n\n# Python dependencies (installed automatically by the script)\n# qrcode[pil], pillow, numpy, pyzbar\n\nTechnical Details\n\nThis 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": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/zouyawen/openclaw-qr-code",
    "publisherUrl": "https://clawhub.ai/zouyawen/openclaw-qr-code",
    "owner": "zouyawen",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}