When to Use This Skill

Activate this skill when any of the following conditions are met:

• The user provides local image files of food and asks to estimate calories
• The user sends an image URL of food and asks to estimate calories
• The user says things like "how many calories is this", "estimate calories", "analyze this food photo", or similar requests (in any language)

Note: This skill supports both local file uploads (binary stream) and image URLs. The most common usage scenario is uploading local files via binary stream (--file), as users typically have food photos saved on their device rather than hosted at a public URL.

How to choose (mutually exclusive — pick one):

• If the user provides a local file path (e.g. /home/user/food.jpg, C:\Users\...\meal.png) → use --file (binary upload). This is the primary and most common usage.
• If the user provides a URL (starts with http:// or https://) → use --image
• Do NOT use --file and --image together in one command

⚠️ Privacy Notice

Please read before installing:

This tool transmits your food image files to WiseDiag cloud servers (via direct binary upload or image URL) for AI analysis.

Do not upload images containing sensitive or private content unless:

• You trust WiseDiag's data handling policy
• You accept that the file content will be transmitted to and processed remotely

The output of this tool is for reference only and does not constitute professional nutritional or dietary advice. Please consult a qualified nutritionist for specific dietary needs.

WiseDiag Food Calorie Estimator (OpenClaw Skill)

Upload photos of food (meals, snacks, beverages, etc.) and let WiseDiag AI automatically identify food items, estimate calories and nutritional content per serving.

Installation

pip install -r requirements.txt

🔑 API Key Configuration (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.

export WISEDIAG_API_KEY=your_api_key

Usage (Step-by-Step)

Do not call any API or HTTP endpoints directly — use only the script below.

⚠️ IMPORTANT: The script makes HTTP requests to an external API and may take 30-120 seconds to complete (especially for large images). Do NOT kill or interrupt a running command — wait for it to finish. The script prints streaming output so you can see it is working.

There are two ways to analyze food — pick one (mutually exclusive):

Option A: Upload local files (recommended) — when user provides local file paths

cd scripts

# Single food image
python3 calories.py -f "/path/to/food.jpg"

# Multiple images (e.g. multiple dishes, max 5)
python3 calories.py -f "/path/to/dish1.jpg" -f "/path/to/dish2.jpg"

# Ask a specific question
python3 calories.py -f "/path/to/food.jpg" --question "这顿饭大概多少卡路里？"

# Specify output filename
python3 calories.py -f "/path/to/food.jpg" -n "lunch_20260324"

Option B: Submit via image URL — when user provides a public HTTP/HTTPS link

cd scripts

# Single image URL
python3 calories.py --image "https://example.com/food.jpg"

# Multiple images
python3 calories.py --image "https://example.com/dish1.jpg" --image "https://example.com/dish2.jpg"

# Ask a specific question
python3 calories.py --image "https://example.com/food.jpg" --question "How many calories is this meal?"

How to choose (mutually exclusive — pick one):

• User gives a local file path (e.g. /home/user/food.jpg, C:\Users\...\meal.png) → use -f
• User gives a URL (starts with http:// or https://) → use --image
• Do NOT use -f and --image together in one command

Results are automatically saved to ~/.openclaw/workspace/WiseDiag-Calories/{name}.md — no manual saving needed.

Parameters

FAQ

"WISEDIAG_API_KEY is not set" error: Verify the environment variable is set correctly by running echo $WISEDIAG_API_KEY.

"Authentication failed" error: Your API Key may be invalid or expired. Visit console.wisediag.com to check or regenerate it.

"File not found" error: The local file path provided via -f does not exist. Check the path and try again.

Image not recognized: Ensure the image is in JPG, JPEG, or PNG format. Photos should be clear and well-lit for best results.

Data Privacy

• File upload mode (-f): Local files are uploaded as binary streams via multipart/form-data to WiseDiag's server for processing.
• URL mode (--image): Image URLs are transmitted to WiseDiag cloud servers; their server downloads and processes them.

Image content is not permanently stored. Results are returned directly to you.

⚠️ Disclaimer

The output of this tool is for reference only and does not constitute professional nutritional or dietary advice. Always consult a qualified nutritionist for specific dietary needs.

License

MIT