Local QR Code Generation And Recognition  Not Require An API_KEY - 本地二维码生成与识别 — 技能工具

Name: Local QR Code Generation And Recognition Not Require An API_KEY - 本地二维码生成与识别 — 技能工具
Rating: 1 (10 reviews)
Author: 极速数据

极速数据

Local QR Code Generation And Recognition Not Require An API_KEY - 本地二维码生成与识别 — 技能工具

v1.0.4

本地将文本/URL 编成 PNG 二维码，或从图片识别二维码，可与远程 qrcode 技能搭配。当用户说：本地生成二维码图片、离线扫图读码，或类似本地二维码问题时，使用本技能。

10· 338·0 当前·0 累计

by @jisuapi (极速数据)·MIT-0

代码生成 API工具开发工具

下载技能包

License

MIT-0

最后更新

2026/4/3

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

high confidence

The skill's code, instructions, and requirements are consistent with a local QR-code generator/decoder that runs with python3 and local Python packages; nothing indicates hidden network calls or unrelated credential access.

评估建议

This skill appears to do exactly what it claims: generate and decode QR codes locally. Before installing or running it, install the recommended Python packages from a trusted source (pip install "qrcode[pil]" opencv-python), and run the script in a directory where writing image files is acceptable. Note the script writes/reads files relative to the current working directory (absolute paths are blocked). The provided qrcode.py file appears duplicated/truncated in the package listing — consider fe...

详细分析 ▾

✓ 用途与能力

Name/description request Python and local QR libraries only; the code imports qrcode and opencv (cv2) and performs only encode/decode operations. No unrelated credentials, binaries, or services are required.

ℹ 指令范围

SKILL.md instructs running the included Python script with JSON args; the script only reads/writes files within the current working directory (it enforces no absolute paths and blocks leading '..'). This stays within the stated purpose. Note: the skill writes output files to the working directory and will read any image file path you provide, so choose the working directory carefully.

✓ 安装机制

There is no install spec; SKILL.md suggests installing dependencies via pip (qrcode[pil], opencv-python). No external downloads or opaque install URLs are used.

✓ 凭证需求

The skill requests no environment variables or credentials. Its dependency needs (Python packages) are proportional to QR generation/recognition.

✓ 持久化与权限

Skill is not always-enabled and is user-invocable. It does not modify other skills or system configuration; it only reads/writes files under the agent's working directory.

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv1.0.42026/3/13

No user-facing changes detected. - No file changes or feature updates in this version. - Documentation and functionality remain as in the previous release.

● 无害

安装命令点击复制

官方npx clawhub@latest install qrcode2

镜像加速npx clawhub@latest install qrcode2 --registry https://cn.clawhub-mirror.com

技能文档

本地二维码生成与识别（qrcode2）

本 Skill 在本地使用 Python 库生成和识别二维码，不依赖外部 HTTP 接口，适合在 OpenClaw/ClawHub 中做：

将文本/URL 快速生成 PNG 格式二维码图片（保存在本地路径）；
从本地二维码图片文件中解析出被编码的文本/URL；
与极速数据或营销落地页结合，给接口/页面生成扫码入口；
与远程版 jisu-qrcode（基于 https://www.jisuapi.com/api/qrcode/）搭配，一边用远程接口生成带模板/LOGO 的二维码 base64，一边用本地工具在沙箱内做测试和解码。

依赖安装

不提供 requirements.txt，请在当前环境中手动安装依赖： ``

bash
pip install "qrcode[pil]" opencv-python

`

说明： -qrcode[pil]用于生成二维码（依赖 Pillow）； -opencv-python 用于从图片中识别解码二维码。



脚本路径

脚本文件：

skills/qrcode2/qrcode.py



使用方式与子命令

当前脚本提供两个子命令：

encode：生成二维码图片；

decode：从图片中识别二维码内容。

`1. 生成二维码（encode）`

`

bash
python3 skills/qrcode2/qrcode.py encode '{"text":"https://www.jisuapi.com","out":"out/qrcode-jisuapi.png"}'

`



也可以使用

data 或 url 字段代替 text

：

`

bash
python3 skills/qrcode2/qrcode.py encode '{
  "url": "https://www.jisuapi.com",
  "out": "out/jisuapi-qr.png",
  "error_correction": "M",
  "box_size": 10,
  "border": 4
}'

`



请求 JSON 字段说明：

| 字段名           | 类型   | 必填 | 说明 |
|------------------|--------|------|------|
| text / data / url| string | 是   | 要编码的文本或 URL，三者任选其一 |
| out              | string | 否   | 输出图片路径（默认

qrcode.png

） |
| version          | int    | 否   | QR 版本，1–40，留空则自动选择 |
| error_correction | string | 否   | 容错级别：

L/M/Q/H，默认 M

 |
| box_size         | int    | 否   | 每个模块（小方块）的像素大小，默认

10

 |
| border           | int    | 否   | 边框宽度（模块数），默认

4

 |
| fill_color       | string | 否   | 前景色，默认

black

 |
| back_color       | string | 否   | 背景色，默认

white

 |

成功时返回示例：

`

json
{
  "path": "out/jisuapi-qr.png",
  "text": "https://www.jisuapi.com",
  "error_correction": "M",
  "box_size": 10,
  "border": 4
}

`



2. 识别二维码（decode）

`

bash
python3 skills/qrcode2/qrcode.py decode '{"path":"out/jisuapi-qr.png"}'

`



请求 JSON 字段说明：

| 字段名 | 类型   | 必填 | 说明 |
|--------|--------|------|------|
| path   | string | 是   | 图片文件路径（也可使用

image / file

 字段） |

成功时返回示例：

`

json
{
  "text": "https://www.jisuapi.com",
  "points": [[100.0, 120.0], [300.0, 120.0], [300.0, 320.0], [100.0, 320.0]],
  "path": "out/jisuapi-qr.png"
}

`



若未检测到二维码或解码失败，会返回：

`

json
{
  "error": "decode_failed",
  "message": "No QR code detected or decode failed.",
  "path": "out/jisuapi-qr.png"
}

`



错误与依赖提示

若未安装依赖：
  
-

encode 时返回 {"error":"missing_dependency","message":"... qrcode[pil] ..."}

；
  -

decode 时返回 {"error":"missing_dependency","message":"... opencv-python ..."}

。

当文件不存在或图片无法读取时，会返回 file_not_found / load_failed 等错误类型。

`推荐用法`



用户提问：「帮我给这个活动页生成一个可以扫码访问的二维码图片。」  
代理生成一个短 URL 或直接使用活动页 URL，然后调用：

python3 skills/qrcode2/qrcode.py encode '{"url":"https://www.jisuapi.com","out":"out/jisu-activity-qr.png"}'

将生成的图片路径（或上传后的链接）返回给用户；若需要生成带模板、LOGO 或通过远程接口下发二维码，可再结合 jisu-qrcode Skill 使用极速数据的云端二维码服务。

`关于极速数据`



极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：

生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息  
工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测  
交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询  
图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别  
娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令  
位置服务：基站查询，经纬度地址转换，坐标系转换  

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索

jisuapi` 找到更多基于极速数据的 OpenClaw 技能。

本地二维码生成与识别（qrcode2）

本 Skill 在本地使用 Python 库生成和识别二维码，不依赖外部 HTTP 接口，适合在 OpenClaw/ClawHub 中做：

将文本/URL 快速生成 PNG 格式二维码图片（保存在本地路径）；
从本地二维码图片文件中解析出被编码的文本/URL；
与极速数据或营销落地页结合，给接口/页面生成扫码入口；
与远程版 jisu-qrcode（基于 https://www.jisuapi.com/api/qrcode/）搭配，一边用远程接口生成带模板/LOGO 的二维码 base64，一边用本地工具在沙箱内做测试和解码。

依赖安装

不提供 requirements.txt，请在当前环境中手动安装依赖： ``

bash
pip install "qrcode[pil]" opencv-python

`

说明： -qrcode[pil]用于生成二维码（依赖 Pillow）； -opencv-python 用于从图片中识别解码二维码。



脚本路径

脚本文件：

skills/qrcode2/qrcode.py



使用方式与子命令

当前脚本提供两个子命令：

encode：生成二维码图片；

decode：从图片中识别二维码内容。

`1. 生成二维码（encode）`

`

bash
python3 skills/qrcode2/qrcode.py encode '{"text":"https://www.jisuapi.com","out":"out/qrcode-jisuapi.png"}'

`



也可以使用

data 或 url 字段代替 text

：

`

bash
python3 skills/qrcode2/qrcode.py encode '{
  "url": "https://www.jisuapi.com",
  "out": "out/jisuapi-qr.png",
  "error_correction": "M",
  "box_size": 10,
  "border": 4
}'

`



请求 JSON 字段说明：

| 字段名           | 类型   | 必填 | 说明 |
|------------------|--------|------|------|
| text / data / url| string | 是   | 要编码的文本或 URL，三者任选其一 |
| out              | string | 否   | 输出图片路径（默认

qrcode.png

） |
| version          | int    | 否   | QR 版本，1–40，留空则自动选择 |
| error_correction | string | 否   | 容错级别：

L/M/Q/H，默认 M

 |
| box_size         | int    | 否   | 每个模块（小方块）的像素大小，默认

10

 |
| border           | int    | 否   | 边框宽度（模块数），默认

4

 |
| fill_color       | string | 否   | 前景色，默认

black

 |
| back_color       | string | 否   | 背景色，默认

white

 |

成功时返回示例：

`

json
{
  "path": "out/jisuapi-qr.png",
  "text": "https://www.jisuapi.com",
  "error_correction": "M",
  "box_size": 10,
  "border": 4
}

`



2. 识别二维码（decode）

`

bash
python3 skills/qrcode2/qrcode.py decode '{"path":"out/jisuapi-qr.png"}'

`



请求 JSON 字段说明：

| 字段名 | 类型   | 必填 | 说明 |
|--------|--------|------|------|
| path   | string | 是   | 图片文件路径（也可使用

image / file

 字段） |

成功时返回示例：

`

json
{
  "text": "https://www.jisuapi.com",
  "points": [[100.0, 120.0], [300.0, 120.0], [300.0, 320.0], [100.0, 320.0]],
  "path": "out/jisuapi-qr.png"
}

`



若未检测到二维码或解码失败，会返回：

`

json
{
  "error": "decode_failed",
  "message": "No QR code detected or decode failed.",
  "path": "out/jisuapi-qr.png"
}

`



错误与依赖提示

若未安装依赖：
  
-

encode 时返回 {"error":"missing_dependency","message":"... qrcode[pil] ..."}

；
  -

decode 时返回 {"error":"missing_dependency","message":"... opencv-python ..."}

。

当文件不存在或图片无法读取时，会返回 file_not_found / load_failed 等错误类型。

`推荐用法`



用户提问：「帮我给这个活动页生成一个可以扫码访问的二维码图片。」  
代理生成一个短 URL 或直接使用活动页 URL，然后调用：

python3 skills/qrcode2/qrcode.py encode '{"url":"https://www.jisuapi.com","out":"out/jisu-activity-qr.png"}'

将生成的图片路径（或上传后的链接）返回给用户；若需要生成带模板、LOGO 或通过远程接口下发二维码，可再结合 jisu-qrcode Skill 使用极速数据的云端二维码服务。

`关于极速数据`



极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：

生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息  
工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测  
交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询  
图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别  
娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令  
位置服务：基站查询，经纬度地址转换，坐标系转换  

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索

jisuapi` 找到更多基于极速数据的 OpenClaw 技能。

数据来源：ClawHub ↗ · 中文优化：龙虾技能库

OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务

License

运行时依赖

版本

安装命令 点击复制

技能文档

本地二维码生成与识别（qrcode2）

依赖安装

脚本路径

使用方式与子命令

1. 生成二维码（encode）

2. 识别二维码（decode）

错误与依赖提示

推荐用法

关于极速数据

本地二维码生成与识别（qrcode2）

依赖安装

脚本路径

使用方式与子命令

1. 生成二维码（encode）

2. 识别二维码（decode）

错误与依赖提示

推荐用法

关于极速数据

安装命令点击复制

`1. 生成二维码（encode）`

`推荐用法`

`关于极速数据`

`1. 生成二维码（encode）`

`推荐用法`

`关于极速数据`