核心用法
该技能基于 Python 的 qrcode 库,通过调用预置脚本 agent.py 生成标准二维码图片。用户只需提供目标内容(URL 或任意文本)及输出路径,即可快速获得 PNG 格式的二维码图像。
基本命令结构:
python3 ~/.openclaw/skills/generate-qrcode/agent.py "<内容>" <输出路径>
显著优点
1. 即开即用:无需编写代码,直接调用现成脚本,降低技术门槛
2. 格式标准:生成 PNG 图片,10×10 模块尺寸配合 4 单位边框,兼容主流扫码设备
3. 内容灵活:支持 URL、纯文本等多种内容类型
4. 路径自由:可指定任意输出位置,便于集成到工作流
潜在缺点与局限性
- 参数固定:模块尺寸、边框宽度、纠错等级等均为预设,无法自定义调整
- 输出单一:仅支持 PNG 格式,无 SVG、PDF 等矢量选项
- 无动态能力:不支持生成带 Logo、彩色样式或艺术化二维码
- 依赖本地环境:需确保 Python 3.x 及 qrcode 库已正确安装
适合人群
- 需要快速生成二维码进行链接分享的内容运营人员
- 开发调试中需要临时二维码的工程师
- 希望通过命令行自动化批量生成二维码的技术用户
常规风险
- 内容安全风险:若输入恶意 URL,生成的二维码可能成为钓鱼攻击载体
- 路径覆盖风险:输出路径若指向已有文件,将被静默覆盖
- 依赖缺失风险:如运行环境未预装 qrcode 库,脚本将执行失败
来源说明
该技能由社区开发者 yuanyanan 贡献,属于基础工具类脚本,无外部网络依赖,代码透明可审计。