WiseOCR
PDF & Image OCR — Convert a single PDF or image to Markdown via WiseDiag cloud API, with high-accuracy text extraction, table recognition, and multi-column l...
Rank
62
Safety
84
Downloads
2.3k
Updated
Oct 9, 2026
Version
1.0.28
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2.3K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2.3K downloadsadoption · observed Oct 9, 2026
- Latest release
- 1.0.28release · observed Apr 1, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: medium.
clawhub skill install s17e3nf6rprdvjhvx51sn4dmp583gkax:wiseocr- Install using `clawhub skill install s17e3nf6rprdvjhvx51sn4dmp583gkax:wiseocr` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/wisediag/wiseocr before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-wisediag-wiseocr/snapshot"
Documentation
CLAWHUB
105,694 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: wiseocr
description: "PDF & Image OCR — Convert a single PDF or image to Markdown via WiseDiag cloud API, with high-accuracy text extraction, table recognition, and multi-column layout support. Usage: Upload a file and say Use WiseOCR to OCR this."
registry:
homepage: https://github.com/wisediag/WiseOCR
author: wisediag
env_vars:
- WISEDIAG_API_KEY
credentials:
required: true
---
# ⚠️ Privacy Warning
**IMPORTANT - READ BEFORE INSTALLING:**
This skill **uploads your file to WiseDiag's cloud servers** for OCR processing.
**Do NOT use with sensitive or confidential documents** unless:
- You trust WiseDiag's data handling policies
- You accept that file contents will be transmitted and processed remotely
### 🚫 Personal Sensitive Information Warning
**Do NOT upload documents containing any of the following:**
| Category | Examples |
|----------|---------|
| Identity | ID card numbers, passport numbers, driver's license numbers |
| Financial | Bank account numbers, credit card numbers, tax IDs |
| Biometric | Fingerprints, facial recognition data, voiceprints |
| Credentials | Passwords, PINs, security question answers |
| Personal contact | Home address, personal phone number, personal email |
| Minor's info | Any information belonging to children under 18 |
> **If the document contains sensitive personal information, it is recommended to use a local/offline OCR solution.**
---
# WiseOCR Skill (powered by WiseDiag)
A high-accuracy OCR tool that converts a **single PDF or image file** into Markdown format. After processing, the Markdown result is automatically saved to disk — no additional saving is needed.
Supported formats: PDF, jpg, jpeg, png, webp, gif, bmp, tiff.
## Installation
```bash
pip install -r requirements.txt
```
## 🔑 API Key Setup (Required)
**Get your API key:** 👉 [https://console.wisediag.com/apiKeyManage](https://console.wisediag.com/apiKeyManage)
The API key MUST be set as an environment variable. The script reads it automatically.
```bash
export WISEDIAG_API_KEY=your_api_key
```
## How to Process a File (Step-by-Step)
**NEVER call any API or HTTP endpoint directly. ONLY use the script below.**
Step 1: Set the API key (if not already set):
```bash
export WISEDIAG_API_KEY=your_api_key
```
Step 2: Run the script with the input file:
```bash
cd scripts
# Single PDF
python3 wiseocr.py -i "/path/to/input_filename.pdf"
# Single image
python3 wiseocr.py -i "/path/to/scan.png"
```
**IMPORTANT:** If the input file has been copied or renamed (e.g. to a temp path), always pass `-n` with the original filename (without extension) so the output file is named correctly:
```bash
python3 wiseocr.py -i "/tmp/ocr_input.pdf" -n "my_report"
# Output saved to: ~/.openclaw/workspace/WiseOCR/my_report.md
```
The Markdown result is saved to `~/.openclaw/workspace/WiseOCR/{name}.md` automatically. No additional saving is needed.
## Arguments
| Flag | Description |
|------|-------------|
| `-i, --input` | InpREADME.md
---
name: wiseocr
description: "PDF & Image OCR — Convert a single PDF or image to Markdown via WiseDiag cloud API, with high-accuracy text extraction, table recognition, and multi-column layout support. Usage: Upload a file and say Use WiseOCR to OCR this."
registry:
homepage: https://github.com/wisediag/WiseOCR
author: wisediag
env_vars:
- WISEDIAG_API_KEY
credentials:
required: true
---
# ⚠️ Privacy Warning
**IMPORTANT - READ BEFORE INSTALLING:**
This tool **uploads your file to WiseDiag's cloud servers** for OCR processing.
**Do NOT use with sensitive or confidential documents** unless:
- You trust WiseDiag's data handling policies
- You accept that file contents will be transmitted and processed remotely
### 🚫 Personal Sensitive Information Warning
**Do NOT upload documents containing any of the following:**
| Category | Examples |
|----------|---------|
| Identity | ID card numbers, passport numbers, driver's license numbers |
| Financial | Bank account numbers, credit card numbers, tax IDs |
| Biometric | Fingerprints, facial recognition data, voiceprints |
| Credentials | Passwords, PINs, security question answers |
| Personal contact | Home address, personal phone number, personal email |
| Minor's info | Any information belonging to children under 18 |
> **If the document contains sensitive personal information, it is recommended to use a local/offline OCR solution.**
---
# WiseOCR (OpenClaw Skill, powered by WiseDiag)
A high-accuracy OCR tool that converts a **single PDF or image file** into Markdown format.


## Features
- **PDF and image support**: jpg, jpeg, png, webp, gif, bmp, tiff
- **Single file processing**: one PDF or image per command
- Table recognition and structured formatting
- Multi-column layout support
- Automatic file saving with input filename
## Installation
```bash
pip install -r requirements.txt
```
## 🔑 API Key Setup (Required)
**Get your API key:**
👉 [https://console.wisediag.com/apiKeyManage](https://console.wisediag.com/apiKeyManage)
```bash
# Temporary (current terminal session)
export WISEDIAG_API_KEY=your_api_key_here
# Permanent (add to ~/.zshrc or ~/.bashrc)
echo 'export WISEDIAG_API_KEY=your_api_key_here' >> ~/.zshrc
source ~/.zshrc
```
## CLI Usage
**You MUST use the provided script to process files. Do NOT call any API or HTTP endpoint directly.**
```bash
cd scripts
# PDF
python3 wiseocr.py -i "/path/to/report.pdf"
# Image
python3 wiseocr.py -i "/path/to/scan.png"
# If the input file has been copied or renamed, use -n to preserve the original filename
python3 wiseocr.py -i "/tmp/ocr_input.pdf" -n "my_report"
# Specify output directory
python3 wiseocr.py -i input.pdf -o ~/my_ocr_results
# Higher quality rendering
python3 wiseocr.py -i input.pdf --dpi 300
```
The Markdown result is saved to `~/.openclaw/workspace/WiseOCR/{name}.md` automatical_meta.json
{
"ownerId": "kn7e3e6w6q53g74mp743vd4f9h80nsnh",
"slug": "wiseocr",
"version": "1.0.28",
"publishedAt": 1775005541259
}skill-card.md
## Description:
WiseOCR converts a single PDF or image file to Markdown through the WiseDiag cloud OCR API, with support for table recognition and multi-column layout extraction.
This skill is ready for commercial/non-commercial use.
## Publisher:
[wisediag](https://clawhub.ai/user/wisediag)
### License/Terms of Use:
MIT-0
## Use Case:
Developers and document-processing users use WiseOCR to extract Markdown from one PDF or supported image at a time while preserving structured content such as tables and multi-column layouts.
### Deployment Geography for Use:
Global
## Known Risks and Mitigations:
Risk: Selected documents are uploaded to WiseDiag's cloud service for OCR processing.
Mitigation: Use the skill only for documents approved for cloud processing; do not use it for confidential, financial, identity, credential, minor-related, or regulated documents.
Risk: Persistent plaintext API-key setup can expose the WiseDiag credential.
Mitigation: Set WISEDIAG_API_KEY only for the current session or through a secret manager.
Risk: Unsafe output-name handling can write outside the intended folder when untrusted --name or --output values are used.
Mitigation: Avoid untrusted --name and --output values until output path validation is fixed.
## Reference(s):
- [WiseOCR ClawHub Skill Page](https://clawhub.ai/wisediag/skills/wiseocr)
- [WiseOCR Project Homepage](https://github.com/wisediag/WiseOCR)
- [WiseDiag API Key Management](https://console.wisediag.com/apiKeyManage)
## Skill Output:
**Output Type(s):** [markdown, text, shell commands, configuration, guidance]
**Output Format:** [Markdown files and terminal status messages]
**Output Parameters:** [1D]
**Other Properties Related to Output:** [Processes one PDF or image per command; default output path is ~/.openclaw/workspace/WiseOCR/{name}.md.]
## Skill Version(s):
1.0.28 (source: server release metadata)
## Ethical Considerations:
Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.requirements.txt
requests>=2.28.0 pypdf>=3.0.0
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/wisediag/skills/wiseocr",
"sourceUrl": "https://clawhub.ai/wisediag/skills/wiseocr",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T16:59:51.390Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-wisediag-wiseocr/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-wisediag-wiseocr/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T16:59:51.390Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2.3K downloads",
"href": "https://clawhub.ai/wisediag/wiseocr",
"sourceUrl": "https://clawhub.ai/wisediag/wiseocr",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T16:59:51.390Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.28",
"href": "https://clawhub.ai/wisediag/wiseocr",
"sourceUrl": "https://clawhub.ai/wisediag/wiseocr",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-01T01:05:41.259Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-wisediag-wiseocr/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-wisediag-wiseocr/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.28",
"description": "Version 1.0.28 of WiseOCR - No file changes detected in this release. - Functionality and documentation remain unchanged.",
"href": "https://clawhub.ai/wisediag/wiseocr",
"sourceUrl": "https://clawhub.ai/wisediag/wiseocr",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-01T01:05:41.259Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
