← 返回 Skills 市场
Solar Cloud API
作者
AllMightySauron
· GitHub ↗
· v1.0.0
908
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install solax-cloud-api
功能描述
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.
安全使用建议
This skill appears to do what it says: use the solax-cloud-api npm package to fetch an inverter summary. Before installing or running it: 1) Verify and provide SOLAX_TOKENID and SOLAX_SN only via environment variables or secure vaults (do not paste tokens into chat). 2) Inspect the solax-cloud-api package (and its dependencies) from the npm registry before running npm install, and consider pinning/locking versions to avoid unexpected transitive packages. 3) Run npm install in a contained environment (build sandbox or CI runner) if you’re unsure. 4) Be aware the script emits the inverter serial (sn) in error output unredacted — if that is sensitive for you, modify the script to redact it. 5) Consider asking the publisher to update registry metadata to declare the required env vars and to include a lockfile to reduce supply-chain variability.
功能分析
Type: OpenClaw Skill
Name: solax-cloud-api
Version: 1.0.0
The skill is designed to fetch Solax inverter summary data using the `solax-cloud-api` npm package. It handles sensitive inputs (`tokenId`, `sn`) securely by recommending environment variables and redacting the `tokenId` in error logs, as explicitly instructed in `SKILL.md` and implemented in `scripts/fetch_summary.mjs`. The `SKILL.md` guardrails are security-enhancing instructions for the agent, not malicious prompt injection. No evidence of data exfiltration, malicious execution, persistence, or obfuscation was found.
能力评估
Purpose & Capability
The name/description, the script (fetch_summary.mjs), and package.json all align: they load [email protected] and call getAPIData() -> toSummary() to produce SolaxSummary JSON. One mismatch: registry metadata lists no required environment variables, but the runtime clearly expects SOLAX_TOKENID and SOLAX_SN (or CLI args).
Instruction Scope
SKILL.md instructs the agent to run npm install in the skill folder and then run the script with env vars or CLI args. It does not ask the agent to read unrelated files or exfiltrate data to unknown endpoints; network activity is the expected Solax Cloud API calls performed by the solax-cloud-api package. The script redacts the tokenId in error output but emits the inverter serial (sn) unredacted.
Install Mechanism
There is no automatic install spec; the skill relies on a manual `npm install` in the skill workspace. That will pull solax-cloud-api from the public npm registry (moderate trust surface). No arbitrary downloads or external URLs are used. Because the skill ships a package.json without a lockfile and instructs `npm install` (not `npm ci`), the exact transitive dependency graph can vary unless you pin/lock versions.
Credentials
The amount of secret access required is minimal and appropriate (a Solax tokenId and inverter serial). However, the registry metadata did not declare these required environment variables — a metadata mismatch that could cause surprise. Also note the script prints the serial number in error outputs unredacted (could reveal device identifiers); tokenId is redacted but still included in error JSON in a redacted form.
Persistence & Privilege
The skill does not request permanent presence (always:false), does not modify other skills or system settings, and is user-invocable only. It writes dependencies into the skill workspace only when you run npm install (manual step).
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install solax-cloud-api - 安装完成后,直接呼叫该 Skill 的名称或使用
/solax-cloud-api触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of solax-summary-fetch: fetch summary data from the Solax Cloud API.
- Fetches Solax inverter summary data as JSON for dashboards or automation.
- Uses solax-cloud-api npm package; requires Node.js setup.
- Inputs: tokenId and inverter serial number via environment variables or CLI.
- Outputs a single JSON summary (SolaxSummary) or structured error JSON.
- Built-in guardrails to protect secret credentials (tokenId is never logged).
元数据
常见问题
Solar Cloud API 是什么?
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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 908 次。
如何安装 Solar Cloud API?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install solax-cloud-api」即可一键安装,无需额外配置。
Solar Cloud API 是免费的吗?
是的,Solar Cloud API 完全免费(开源免费),可自由下载、安装和使用。
Solar Cloud API 支持哪些平台?
Solar Cloud API 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Solar Cloud API?
由 AllMightySauron(@allmightysauron)开发并维护,当前版本 v1.0.0。
推荐 Skills