qr-generator

name	qr-generator
description	Générer des QR codes à partir de texte ou URLs. Use when: l'utilisateur demande de créer un QR code, générer un code-barres 2D, encoder des données en QR. NOT for: codes-barres 1D, NFC tags, encryption de données sensibles.
metadata	{"openclaw":{"emoji":"📱","requires":{"bins":["python3"]}}}

QR Generator Skill

Générer des QR codes rapidement à partir de texte ou URLs.

Quand l'utiliser

✅ USE ce skill quand:

• "Crée un QR code pour..."
• "Génère un QR avec ce texte"
• "Encode cette URL en QR code"
• L'utilisateur veut partager des données via QR code

❌ N'utilisez PAS ce skill pour:

• Codes-barres 1D (EAN, UPC)
• NFC tags
• Encryption de données sensibles
• Grande quantité de données (>4KB)

Génération de QR Codes

API QRServer (gratuite, sans clé)

# QR code simple
curl -o qr.png "https://api.qrserver.com/v1/create-qr-code/?size=300x300&data=https://example.com"

# Avec différentes tailles
curl -o qr.png "https://api.qrserver.com/v1/create-qr-code/?size=500x500&data=Hello%20World"

# Format SVG
curl -o qr.svg "https://api.qrserver.com/v1/create-qr-code/?format=svg&size=300x300&data=https://example.com"

Utilisation du script Python

Pour une génération locale avec plus d'options:

python3 {baseDir}/generate_qr.py "https://example.com" --output qr.png
python3 {baseDir}/generate_qr.py "Mon texte" --size 400 --output qr.png
python3 {baseDir}/generate_qr.py "https://openclaw.ai" --color FF5733 --bgcolor FFFFFF

Paramètres disponibles

Paramètre	Description	Exemple
size	Dimensions en pixels	300x300, 500x500
format	Format de sortie	png, svg, eps
data	Contenu à encoder	URL ou texte
color	Couleur du QR (hex)	000000 (noir)
bgcolor	Couleur de fond (hex)	ffffff (blanc)

Exemples d'utilisation

Exemple 1: QR code pour URL

Demande: "Crée un QR code pour https://openclaw.ai"

Commande:

python3 {baseDir}/generate_qr.py "https://openclaw.ai" --output openclaw_qr.png

Exemple 2: QR code pour texte

Demande: "Génère un QR code avec le texte 'Hello from OpenClaw!'"

Commande:

python3 {baseDir}/generate_qr.py "Hello from OpenClaw!" --output hello_qr.png

Exemple 3: QR code coloré

Demande: "Crée un QR code rouge pour mon site"

Commande:

python3 {baseDir}/generate_qr.py "https://monsite.com" --color FF0000 --output qr_rouge.png

Exemple 4: QR code haute résolution

Demande: "Génère un QR code en haute résolution"

Commande:

python3 {baseDir}/generate_qr.py "https://example.com" --size 800 --output qr_hd.png

Workflow typique

1. Recevoir le contenu à encoder (URL, texte, etc.)
2. Déterminer la taille et le format souhaités
3. Générer le QR code via le script ou l'API
4. Sauvegarder le fichier et le partager avec l'utilisateur

Options du script Python

# Afficher l'aide
python3 {baseDir}/generate_qr.py --help

# Options disponibles
--output, -o    Nom du fichier de sortie (défaut: qr_code.png)
--size, -s      Taille en pixels (défaut: 300)
--format, -f    Format: png, svg (défaut: png)
--color, -c     Couleur du QR en hex (défaut: 000000)
--bgcolor, -b   Couleur de fond en hex (défaut: FFFFFF)
--verbose, -v   Mode verbeux

Notes importantes

• Taille max des données: ~4KB selon le type de contenu
• Correction d'erreurs: Niveau M par défaut (15% de redondance)
• Formats supportés: PNG, SVG, EPS
• Pas de clé API requise pour l'API QRServer

Cas d'usage courants

Cas d'usage	Contenu	Taille recommandée
URL de site web	https://...	300x300
WiFi credentials	WIFI:T:WPA;S:nom;P:mdp;;	400x400
Contact (vCard)	Données contact	400x400
Texte simple	Message court	200x200
Email	mailto:[e-mail]	300x300

Gestion des erreurs

Erreur	Cause	Solution
Données trop longues	>4KB de données	Réduire le contenu
Format invalide	Extension non supportée	Utiliser png, svg ou eps
Couleur invalide	Format hex incorrect	Utiliser format RRGGBB

Dépendances Python

Pour utiliser le script local, installez:

pip install qrcode pillow

Ou utilisez l'API QRServer qui ne nécessite aucune dépendance.