← 返回 Skills 市场
qwencloud-usage
作者
Cuixiaoyang123
· GitHub ↗
· v0.2.0
· MIT-0
68
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install qwencloud-usage
功能描述
[QwenCloud] Manage account auth and query usage/billing. Use for: login, logout, check usage, view billing, free tier quota, coding plan status, pay-as-you-g...
安全使用建议
This skill is mostly coherent with its purpose (login + usage reporting) but it does perform sensitive local operations you should be comfortable with before installing.
What to consider before installing:
- Review the source files (credential_store.py, device_flow.py, gossamer.py). They are included in the package and implement the behavior described.
- Credentials: the skill stores access/refresh tokens locally under ~/.qwencloud using an encryption key derived from hardware identifiers (machine-id, MAC, DMI fields) or a host_id file. This is intended to protect tokens, but it means the script reads low-level system identifiers.
- System commands: the code runs system utilities (dmidecode, ifconfig/ipconfig, networksetup) and subprocesses. These calls are used for key derivation and update-checks but are execution points that could fail or behave unexpectedly on locked-down systems.
- Update-check: on each run the tool will try to detect a repo root and may execute a local check_update.py script (via subprocess) if found. That means it can execute code that exists in your repository; avoid running this in untrusted repositories.
- Permissions: don’t run the tool as root unless you have to; as root it could write to system locations like /etc/qwencloud-host-id.
Recommended actions:
- If you trust the publisher and need the convenience, run it in a restricted environment (non-root user, isolated VM or container) and inspect or pin the packaged code.
- If you only need read-only usage queries, consider running the scripts interactively and inspect what files they create (look under ~/.qwencloud) before giving authorizations.
- If you maintain a private repo, be aware the update-check feature can execute repo-local scripts; remove or audit check_update.py in your repo if you enable this skill there.
If you want a lower-risk option, ask the skill author for a version that uses an explicit, user-provided passphrase for file encryption (instead of hardware-derived keys) and disables the automatic repo-local update script invocation.
功能分析
Type: OpenClaw Skill
Name: qwencloud-usage
Version: 0.2.0
The qwencloud-usage skill bundle is a legitimate tool for managing QwenCloud account authentication and querying billing data. It implements a standard OAuth 2.0 Device Flow for authentication and features a sophisticated credential storage system (credential_store.py) that supports system keyrings or AES-256-GCM encrypted local files. The encryption key is derived from hardware identifiers (MAC address, CPU ID, motherboard UUID) to bind secrets to the local machine, but this data is hashed locally and not exfiltrated. The bundle also includes a structured update-check mechanism (gossamer.py) and specific agent instructions (SKILL.md) to handle headless login and dependency management. No malicious behavior, unauthorized data exfiltration, or persistence mechanisms were found.
能力标签
能力评估
Purpose & Capability
Name/description (login, usage, billing) match the packaged code: device-flow auth, local credential store, usage queries, and formatting. The included gossamer update-check is related (not strictly required but plausibly part of a CLI UX).
Instruction Scope
SKILL.md instructs only to install requirements and run scripts for login/summary/breakdown which is in-scope. However the runtime code does more than call an API: it probes many local system identifiers, invokes system utilities (dmidecode, ifconfig/ipconfig, networksetup), writes files under ~/.qwencloud (and may attempt /etc paths), and will run a repo-local check_update.py via subprocess if a repo root is detected. Those actions are reasonably justified for an offline credential store and update-checker but are sensitive and should be understood before use.
Install Mechanism
No remote download/install spec in the registry; the SKILL.md asks the user to create a virtualenv and pip install -r requirements.txt (cryptography, keyring). No extract-from-URL or remote executables are included in the install spec, which reduces supply-chain risk compared with arbitrary downloads.
Credentials
The skill declares no required credentials, but the credential_store collects many hardware and platform identifiers (machine-id, DMI fields, MAC addresses, Windows registry MachineGuid, etc.) to derive an encryption key. This is privacy-sensitive; while it's a plausible design to protect stored tokens, it grants the code broad access to local system identifiers and spawns system utilities (dmidecode, ipconfig/ifconfig). The update-check code may run a local script (check_update.py) in a repo which effectively executes code from the user's repo environment.
Persistence & Privilege
The skill does not request always:true and is user-invocable only. It persists credentials and small state under ~/.qwencloud and may write a host_id to system locations if fallback is used; these are expected behaviours for a CLI auth tool and do not indicate privilege escalation. Running as root could allow writing to /etc, but the code handles write failures and falls back.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install qwencloud-usage - 安装完成后,直接呼叫该 Skill 的名称或使用
/qwencloud-usage触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.2.0
No user-facing changes were detected in this version.
- No file changes present for version 0.2.0; documentation and behavior remain unchanged.
v0.1.0
qwencloud-usage 0.1.0 – Initial release
- Provides authentication (login/logout) via Device Flow, including headless login support.
- Allows querying QwenCloud usage/billing: usage summary, free tier quota, coding plan status, and pay-as-you-go costs.
- Supports filtering usage by model, date range, and output granularity.
- No manual auth configuration required; environment variable for credential storage is optional.
- Enforces strict output formatting and agent behavior for usage reporting and headless login flows.
元数据
常见问题
qwencloud-usage 是什么?
[QwenCloud] Manage account auth and query usage/billing. Use for: login, logout, check usage, view billing, free tier quota, coding plan status, pay-as-you-g... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 68 次。
如何安装 qwencloud-usage?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install qwencloud-usage」即可一键安装,无需额外配置。
qwencloud-usage 是免费的吗?
是的,qwencloud-usage 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
qwencloud-usage 支持哪些平台?
qwencloud-usage 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 qwencloud-usage?
由 Cuixiaoyang123(@cuixiaoyang123)开发并维护,当前版本 v0.2.0。
推荐 Skills