Wolfram|Alpha (LLM API) skill

Use the bundled wrapper script to call Wolfram|Alpha's LLM API and return concise, model-ingestible results.

Preconditions

• Environment variable WOLFRAM_APP_ID must be set (your Wolfram|Alpha AppID). If it is not set, ask your human to set it (do not guess or hardcode keys).

Quick start

Run:

# default: cache ON (7d), auth via bearer header (keeps AppID out of URL)
python3 skills/wolfram-alpha-llm/scripts/wa_llm.py \
  --input "solve x^2 + 3x + 2 = 0"

What to send as --input

• Prefer short English keyword-style queries when possible.
• If the user asked in another language, translate to English for the API call, then answer in the user’s original language.
• When you need an exact computation, be explicit (e.g., integrate sin(x)^2 from 0 to pi).

Core parameters (use these most)

• --input (required): the query.
• --maxchars (optional, default 2500): cap response length.
• --units (optional): set units system, if needed for conversions/physics (metric is often a good default when unspecified).
• --assumption (optional, repeatable): disambiguate when WA returns irrelevant interpretation or offers assumptions.

High-value optional parameters (use when relevant)

• Localization / context:
• --countrycode, --languagecode
• --timezone
• One of: --ip | --latlong | --location (pick exactly one)
• Finance:
• --currency (e.g., USD, EUR)
• Performance / robustness:
• --scantimeout, --parsetimeout, --formattimeout, --totaltimeout

Output handling guidance

• Treat output as computed evidence: quote the key result, then add minimal interpretation.
• If the result is too long/noisy, rerun with a smaller --maxchars.
• Heuristic: for simple conversions / arithmetic / single-value answers, try --maxchars 800.
• Keep default --maxchars 2500 for most multi-line or explanation-heavy results.
• If the interpretation is wrong:

1) retry with --assumption ... (use WA-provided suggestions when available),

2) only then rephrase/simplify --input.

Wrapper script

• Script: skills/wolfram-alpha-llm/scripts/wa_llm.py
• Auth:
• default --auth bearer: sends Authorization: Bearer header (keeps AppID out of the URL)
• --auth query: sends appid as URL parameter
• Cache:
• default --cache on with --cache-ttl 604800 (7d)
• stores best-effort results in: ~/.cache/openclaw-wolfram-alpha/
• Returns:
• stdout: API text body
• stderr: errors, HTTP status context

For parameter details and error behaviors, see:

• skills/wolfram-alpha-llm/references/llm-api.md
• skills/wolfram-alpha-llm/references/full-api-params.md