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 layout support. Usage: Upload a file and say Use WiseOCR to OCR this.

⚠️ 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

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	Input file: PDF or image — single file path (required)
-n, --name	Output filename stem (recommended when input file is renamed/copied)
-o, --output	Output directory (default: ~/.openclaw/workspace/WiseOCR)
--dpi	PDF rendering DPI, 72-600 (default: 200)

Data Privacy

What happens to your files:

1. Files are uploaded to WiseDiag's OCR API
2. Files are processed on WiseDiag servers
3. Processing results are returned to you
4. Files are not permanently stored on WiseDiag servers

⚠️ Do NOT upload documents containing personal sensitive information, including but not limited to:

• Identity information: ID card numbers, passport numbers, driver's license numbers
• Financial information: Bank account/card numbers, credit card numbers, tax IDs, financial statements
• Biometric data: Fingerprints, facial images, iris scans, voiceprints
• Account credentials: Passwords, PINs, security question answers, private keys
• Personal contact details: Home address, personal phone number, personal email
• Information about minors: Any personally identifiable information belonging to children under 18

For documents containing the above, use offline/local OCR tools instead.

License

MIT