OpenClaw · Skill
Solax Cloud API
Fetch Solax inverter summary data as JSON.
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install allmightysauron/solax-cloud-apiClawHub installer
npx clawhub@latest install allmightysauron/solax-cloud-apiOpenClaw CLI
openclaw skills install allmightysauron/solax-cloud-apiDirect OpenClaw install
openclaw install allmightysauron/solax-cloud-apiWhat this skill does
Fetch Solax inverter summary data as JSON.
Why it matters
Wraps the Solax Cloud API response into a typed SolaxSummary object, avoiding manual HTTP calls and raw response parsing.
Typical use cases
- Pulling live solar generation data into a home energy dashboard
- Automating daily energy production reports from a rooftop inverter
- Monitoring battery charge levels without opening the Solax app
- Triggering automations when solar output drops below a threshold
- Logging inverter readings to a time-series database
Source instructions
solax-summary-fetch
Fetch Solax inverter summary data as JSON.
Setup (one-time)
This skill uses Node.js and the npm package solax-cloud-api.
Install dependencies inside the skill folder:
cd /home/openclaw/.openclaw/workspace/skills/solax-summary-fetch/scripts
npm install
(We use npm install instead of npm ci because this skill does not ship with a lockfile.)
Inputs
You need:
tokenId(Solax Cloud API token id)sn(inverter serial number)
Recommended: environment variables
Set these in your runtime (preferred so you don’t leak secrets into shell history):
SOLAX_TOKENIDSOLAX_SN
Do not hardcode credentials into the skill files.
Alternate: CLI arguments
Pass them explicitly as:
--tokenId <tokenId>--sn <serial>
Command
cd /home/openclaw/.openclaw/workspace/skills/solax-summary-fetch/scripts
node fetch_summary.mjs --tokenId "$SOLAX_TOKENID" --sn "$SOLAX_SN"
Output
- Prints a single JSON object to stdout.
- The JSON conforms to the SolaxSummary interface exposed by
solax-cloud-api(seereferences/solax-summary.d.ts). - Under the hood (solax-cloud-api v0.2.0): fetches
getAPIData()then converts viaSolaxCloudAPI.toSummary().
Guardrails
- Never print or log the tokenId beyond confirming whether it is set (redact it).
- If the API call fails, return a structured error JSON with
ok:falseand a shorterrormessage.