适用于 Openclaw 的 QwenCloud Usage

一个基于 CLI 的综合技能,用于管理 QwenCloud 账户认证并监控详细的资源使用情况和计费。

cuixiaoyang123
v0.2.1
2026年4月30日
0
720
0

安装与下载

1. ClawHub CLI

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

npx clawhub@latest install qwencloud-usage

2. 手动安装

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

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

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

3. 提示词安装

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

请帮我使用 Clawhub 安装 qwencloud-usage。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 QwenCloud Usage?

qwencloud-usage 技能是专为 Openclaw Skills 生态系统设计的专业工具,旨在提供 QwenCloud 账户的无缝管理。它赋予开发者和 AI 代理处理复杂认证流程的能力(包括带有 PKCE 的 OAuth 2.0 设备授权),同时提供资源消耗的实时可见性。

通过集成此技能,用户可以以编程方式或手动查询其免费层级状态、编程计划限制(PRO/Basic)以及按量付费支出。它是维持 AI 驱动的开发环境中服务连续性和成本透明度的关键桥梁。

QwenCloud Usage 应用场景

  • 在无头或远程容器环境中使用非 TTY 登录流对 AI 代理进行身份验证。
  • 监控 qwen3.6-plus 等模型的剩余免费额度 Token,以避免服务中断。
  • 生成按量付费模型使用的月度或季度账单报告。
  • 检查专业编程计划的状态以及不同时间窗口内的请求限制。
  • 撤销会话并清除本地凭据以实现安全的账户注销。

QwenCloud Usage 工作原理

  1. 该技能与 QwenCloud CLI 交互,通过结构化 JSON 检查验证当前认证状态。
  2. 对于新会话,它启动两阶段 OAuth 流程,为用户生成验证 URL,同时代理轮询完成状态。
  3. 认证成功后,该技能根据用户定义的参数(如日期范围或模型 ID)执行特定的使用情况命令(摘要、细分或免费层级)。
  4. 它解析返回的 JSON 数据,以提取有关已用 Token、生成的图像或产生的财务成本的精确指标。
  5. 最后,它呈现结构化的摘要或准确的 CLI 文本输出,随后是对使用数据的技术分析。

QwenCloud Usage 配置指南

确保已安装 Node.js >= 18。要在 Openclaw Skills 中使用此功能,请全局安装 QwenCloud CLI:

npm install -g @qwencloud/qwencloud-cli

验证安装:

qwencloud version

对于特定环境的凭据存储,您可以选择配置:

export QWENCLOUD_KEYRING=plaintext # 选择退出操作系统密钥链
export QWENCLOUD_CREDENTIALS_DIR=~/.qwencloud/credentials

QwenCloud Usage 数据架构与分类体系

该技能在所有机器对机器交互中使用结构化 JSON。以下是使用摘要的主要数据分类:

对象 字段 描述
free_tier model_id, quota, used_pct 跟踪每个模型的剩余 Token 或图像。
coding_plan plan, windows (5h, weekly, monthly) 监控订阅计划的请求限制。
pay_as_you_go models, cost, currency 详细说明付费模型的财务成本和 Token 总数。
period from, to 定义检索数据的时间范围。

QwenCloud Usage 高级特性

  • 非 TTY/无头认证:针对代理进行了优化,无需手动 TTY 干预即可处理设备代码流。
  • 多维细分:按模型、自定义日期范围和粒度(日/月/季)过滤使用情况。
  • 自动轮询:--complete 标志允许代理在检测到用户授权后自动恢复登录序列。
  • Keyring 集成:通过操作系统级密钥链支持安全凭据存储,并带有备用加密。
  • 版本完整性:内置 version --check 功能,以确保 CLI 及其 Openclaw Skills 集成保持最新状态。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*