Skillppx logo

Qrcode Skill

通过远程服务生成或解码二维码，支持文本、URL及图片输入。

已扫描
适合谁
需要频繁生成或读取二维码的办公人员、使用飞书等平台进行信息传递的团队成员
不适合谁
无需二维码功能的普通用户、对网络依赖敏感且无法访问外部API的环境
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @marc-chen/qrcode-skill
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

QR 码技能

通过远程 MCP 服务 https://qrcode.api4claw.com/mcp 生成和解码二维码。

功能

操作MCP 工具描述
生成二维码generate_qr_code将文本或 URL 转换为二维码 PNG 图像（base64 编码）
解码二维码decode_qr_code从二维码图像中提取文本内容

MCP 服务器配置

此技能需要配置以下 MCP 服务器：

{
  "mcpServers": {
    "qrcode": {
      "type": "http",
      "url": "https://qrcode.api4claw.com/mcp"
    }
  }
}

使用流程

生成二维码

  1. 确认要编码的文本或 URL（最大 1000 字符）
  2. 可选：确认期望的图像尺寸（128–1024 像素，默认 512）
  3. 调用 generate_qr_code MCP 工具：

- text（必填）：要编码的内容

- size（可选）：图像尺寸（像素）

  1. 工具返回 base64 编码的 PNG 图像
  2. 使用 Markdown 向用户展示二维码图像：![QR Code](data:image/png;base64,<base64_data>)
  3. 若用户希望保存，将解码后的 base64 数据写入 .png 文件

解码二维码

  1. 从用户处获取二维码图像 —— 支持以下任一方式：

- 工作区中的 PNG 图像文件路径

- base64 编码的图像字符串

- 在聊天中粘贴的图像

  1. 若提供文件路径，则读取文件并转换为 base64 格式
  2. 调用 decode_qr_code MCP 工具：

- image_base64（必填）：base64 编码的 PNG 图像数据

  1. 返回解码后的文本内容给用户

API 参考

详细工具定义与示例请参见 [MCP API 参考](./references/mcp-api.md)。

错误处理

  • 若文本超过 1000 字符，告知用户并请其缩短内容
  • 若图像中无法识别二维码，明确报告解码失败
  • 若 MCP 服务器不可达，提示用户检查网络连接

示例

生成：

“为 https://github.com 生成一个二维码”

“创建一个 256px 的二维码，包含我的 Wi-Fi 配置：WIFI:T:WPA;S:MyNetwork;P:password123;;”

解码：

“解码 ./assets/ticket.png 中的二维码”

“这个二维码说的是什么？”（附带图像）

MC
@marc-chen

已收录 1 个 Skill

相关推荐