什么是 Solax 摘要获取？

solax-summary-fetch 技能是专为需要以编程方式访问太阳能指标的开发人员和智能家居爱好者设计的实用工具。通过利用 Solax Cloud API，Openclaw Skills 生态系统中的这一项可以实现逆变器性能数据、电池电量和电网状态的自动检索。它将原始 API 响应转换为干净的类型化 JSON 格式，使其成为任何能源意识自动化堆栈或自定义监控仪表板的重要组件。

下载入口:https://github.com/openclaw/skills/tree/main/skills/allmightysauron/solax-cloud-api

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Solax 摘要获取 应用场景

• 跟踪每日太阳能产量和累计发电量以进行分析。
• 将实时能源指标集成到 Home Assistant 等智能家居仪表板中。
• 当太阳能产量超过特定阈值时，自动触发高能耗家电。
• 通过 Openclaw Skills 远程监控逆变器运行状况和连接状态。

1. 用户通过环境变量或 CLI 参数提供 Solax Cloud Token ID 和逆变器序列号。
2. 该技能调用位于 scripts 目录中的 Node.js 脚本。
3. 该脚本利用 solax-cloud-api npm 包进行身份验证并从云服务获取原始数据。
4. 原始数据通过 toSummary() 方法处理，以提取相关的能源指标。
5. 最终输出打印为单个可解析的 JSON 对象，供代理或其他脚本立即使用。

Solax 摘要获取 配置指南

要开始使用，请进入技能目录并安装所需的 Node.js 依赖项：

cd /home/openclaw/.openclaw/workspace/skills/solax-summary-fetch/scripts
npm install

强烈建议将您的凭据配置为环境变量以保持安全性：

export SOLAX_TOKENID="your_api_token"
export SOLAX_SN="your_inverter_serial"

然后，您可以使用以下命令执行该技能：

node fetch_summary.mjs --tokenId "$SOLAX_TOKENID" --sn "$SOLAX_SN"

Solax 摘要获取 数据架构与分类体系

该技能返回一个符合 SolaxSummary 接口的 JSON 对象。以下是提供的数据结构表示：

如果发生失败，该技能将返回一个错误对象：{"ok": false, "error": "失败原因"}。

name: solax-summary-fetch
description: Fetch inverter summary data from the Solax Cloud API using the npm package solax-cloud-api. Use when the user provides (or has configured) a Solax tokenId and inverter serial number (sn) and wants current/summary energy data returned as JSON (typed as SolaxSummary) for dashboards/automation.

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_TOKENID
• SOLAX_SN

Do not hardcode credentials into the skill files.

Alternate: CLI arguments

Pass them explicitly as:

• --tokenId
• --sn

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 (see references/solax-summary.d.ts).
• Under the hood (solax-cloud-api v0.2.0): fetches getAPIData() then converts via SolaxCloudAPI.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:false and a short error message.