← 返回 Skills 市场
144
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install smartocr
功能描述
识别车辆证件(行驶证正页/副页)和收据/发票图片,返回结构化 JSON 数据。 支持图片 URL 和本地文件两种方式,需要 API Key。
安全使用建议
This skill will read your OpenClaw session files to extract images and upload those images (as Base64) to an external API (default: https://smartocr.yunlizhi.cn). Before installing: 1) Confirm you trust the SmartOCR provider and its handling of uploaded images and API keys. 2) Do not use sensitive images (IDs, private documents) until you verify the endpoint and privacy policy. 3) The skill omitted declaring SMARTOCR_API_KEY in its registry metadata—expect to set SMARTOCR_API_KEY in your OpenClaw env; consider using a scoped/test key. 4) If you prefer to avoid external uploads, run your own local SmartOCR instance and set SMARTOCR_API_URL to a localhost address. 5) Because the source/homepage is unknown, prefer running the scripts in a sandbox or reviewing/hosting them yourself rather than granting broad access immediately.
功能分析
Type: OpenClaw Skill
Name: smartocr
Version: 1.0.1
The skill provides OCR functionality for vehicle documents and receipts by sending image data to an external API (smartocr.yunlizhi.cn). It includes a script, `smartocr_from_session.py`, which programmatically accesses OpenClaw's internal session history files in `~/.openclaw/agents/` to extract image data from previous user messages. While these capabilities are aligned with the stated purpose of processing images from the chat, the direct access to session logs and the transmission of potentially sensitive document data to a third-party service are high-risk behaviors.
能力评估
Purpose & Capability
The skill's name/description and the included scripts align with OCR of vehicle documents and receipts. However, registry metadata lists no required environment variables or primary credential while the SKILL.md and both Python scripts require SMARTOCR_API_KEY (and optionally SMARTOCR_API_URL). This mismatch between declared requirements and actual runtime needs is incoherent and should be fixed or explained by the author.
Instruction Scope
The SKILL.md and scripts instruct the agent to read OpenClaw session files (default: ~/.openclaw/agents/{agent}/sessions/*.jsonl) to extract base64 image data and then POST that data to the SmartOCR API. Reading session files is within the stated purpose (to process images sent in chat), but it accesses potentially sensitive conversation history. The skill uploads raw image base64 to an external endpoint (default https://smartocr.yunlizhi.cn), so verify the endpoint and privacy policy before use.
Install Mechanism
There is no external install/download step—this is instruction+script based and only requires python3 and the requests library. No remote archive downloads or unusual install locations are used.
Credentials
At runtime the scripts require SMARTOCR_API_KEY (and optionally SMARTOCR_API_URL and OPENCLAW_HOME). The skill metadata did not declare SMARTOCR_API_KEY as a required env var/primary credential, which is a misleading omission. Requesting an API key to call an external service is proportionate for OCR, but the missing declaration reduces transparency. Also note the API key prefix 'sk-'—verify provider trust and key scope before use.
Persistence & Privilege
The skill does not request always:true and does not attempt to modify other skills or system-wide configs. It reads session files under the user's OpenClaw home for its intended function, which is a significant but expected data access for this feature.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install smartocr - 安装完成后,直接呼叫该 Skill 的名称或使用
/smartocr触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
- Added scripts/smartocr_from_session.py to support recognizing images uploaded in conversations (e.g., Feishu, WebChat, WeCom) by extracting them from session files.
- Updated configuration instructions to align with the new Openclaw CLI and env.vars structure.
- Expanded SKILL.md documentation with usage and options for the new session image recognition script.
- No breaking changes; existing APIs and main script usage remain unchanged.
v1.0.0
Initial release of SmartOCR — vehicle document and receipt/invoice recognition.
- Supports recognition of vehicle license (front/rear) and receipts/invoices from images
- Accepts image URL or local file input, returns structured JSON data
- Requires API Key configuration with option to set custom API URL
- Provides detailed usage instructions, options, and example commands
- Documents response formats, error codes, and operational guidelines
元数据
常见问题
smart ocr 是什么?
识别车辆证件(行驶证正页/副页)和收据/发票图片,返回结构化 JSON 数据。 支持图片 URL 和本地文件两种方式,需要 API Key。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 144 次。
如何安装 smart ocr?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install smartocr」即可一键安装,无需额外配置。
smart ocr 是免费的吗?
是的,smart ocr 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
smart ocr 支持哪些平台?
smart ocr 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 smart ocr?
由 leeee0923(@leeee0923)开发并维护,当前版本 v1.0.1。
推荐 Skills