核心用法
generate-qrcode 是一个轻量级本地二维码生成技能，通过调用预置的 Python 脚本，将任意 URL 或纯文本转换为标准 PNG 格式的二维码图片。使用时需通过命令行调用指定脚本路径，传入内容字符串和输出文件路径两个参数即可生成。
典型调用示例：
python3 ~/.openclaw/skills/generate-qrcode/agent.py "https://example.com" ~/Desktop/output.png
输出规格为默认 10×10 模块尺寸，带 4 格边距，符合通用扫码识别标准。
显著优点
- 纯离线运行：依赖本地 Python 环境和预置脚本，无需网络连接，杜绝数据外传风险
- 零配置使用：qrcode 库已预装，开箱即用，无额外依赖管理负担
- 格式通用：输出标准 PNG，兼容所有扫码设备和识别软件
- 调用简单：命令行单条指令完成，适合脚本化批量处理
潜在局限
- 功能单一：仅支持基础二维码生成，无自定义样式（颜色、Logo 嵌入、容错级别调整等）
- 无交互界面：纯命令行工具，对非技术用户不够友好
- 路径硬编码：脚本路径固定于
~/.openclaw/skills/目录，迁移或自定义安装时需手动调整 - 错误处理弱：文档未说明异常输入（如超长文本、特殊字符）的处理机制
适合人群
- 开发者和技术用户：需快速生成二维码用于测试、文档或自动化工作流
- 隐私敏感场景：要求数据不出本地，拒绝使用在线生成服务
- 离线环境用户：无稳定网络连接的工作场景
常规风险
- 路径遍历风险：若未对
output_path参数做过滤，可能存在文件覆盖或目录遍历隐患（需验证脚本实现） - 输入注入：特殊构造的文本内容可能影响二维码渲染或导致解析异常
- 依赖库漏洞：qrcode 库本身若存在 CVE，本地环境需自行跟进更新
整体而言，这是一个设计简洁、定位明确的工具型技能，适合作为基础二维码生成能力的补充。